openstack/devstack-plugin-ceph
Code Issues Proposed changes
DevStack plugin to configure Ceph backend.
329 Commits 10 Branches 8 Tags 5.4 MiB
Shell 100%
784716d949
Go to file
Goutham Pacha Ravi 784716d949 Drop support for package based installation of Ceph 
This mode of deployment isn't supported by the Ceph
community, and was always a chimera that we were
feeding/maintaining.

Ceph's tool of choice to bootstrap and install a ceph
cluster is by using the Ceph Orchestrator (via the
cephadm tool).

We're also cleaning up the old/unused and poorly tested
"CONTAINERIZED_CEPH". When using ceph orchestrator,
ceph daemons are run within podman containers on the
devstack host.

Change-Id: I5f75cb829383d7acd536e24c70cc4418d93c13bc
Signed-off-by: Goutham Pacha Ravi <gouthampravi@gmail.com>
2024-09-12 14:05:38 +00:00
devstack Drop support for package based installation of Ceph 2024-09-12 14:05:38 +00:00
doc Update IRC network to OFTC 2021-05-31 15:05:57 -05:00
.gitignore Set up the doc infra and add doc job 2020-04-22 00:54:27 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:40:27 +00:00
.zuul.yaml Drop support for package based installation of Ceph 2024-09-12 14:05:38 +00:00
CONTRIBUTING.rst [ussuri][goal] Update contributor documentation 2020-04-22 14:07:07 +00:00
LICENSE Initial commit 2015-11-27 19:43:03 +00:00
README.rst Drop support for package based installation of Ceph 2024-09-12 14:05:38 +00:00
tempest_skiplist_multinode.txt Skip tempest image format tests 2024-09-11 18:51:36 +00:00
tempest_skiplist.txt Skip tempest image format tests 2024-09-11 18:51:36 +00:00
tox.ini Use TOX_CONSTRAINTS_FILE 2022-07-26 11:42:19 +08:00

README.rst

Devstack Ceph Plugin

image

Overview

Devstack plugin to configure Ceph as the storage backend for openstack services

As part of stack.sh:

  • Creates a Ceph cluster for use with openstack services using Ceph orchestrator
  • Configures Ceph as the storage backend for Cinder, Cinder Backup, Nova, Manila, and Glance services
  • (Optionally) Sets up & configures Rados gateway (aka rgw or radosgw) as a Swift endpoint with Keystone integration. Set ENABLE_CEPH_RGW=True in your localrc
  • Supports Ceph cluster running local or remote to openstack services

As part of unstack.sh | clean.sh:

  • Tears down the Ceph cluster and its related services

Usage

  • To get started quickly, just enable the plugin in your local.conf:

    enable_plugin devstack-plugin-ceph https://opendev.org/openstack/devstack-plugin-ceph

Run stack.sh in your devstack tree and boom! You're good to go.

  • Ceph is setup as the default storage backend for Cinder, Cinder Backup, Glance, Manila and Nova services. You have the ability to control each of the enabled services with the following configuration in your local.conf:

    ENABLE_CEPH_CINDER=True     # ceph backend for cinder
ENABLE_CEPH_GLANCE=True     # store images in ceph
ENABLE_CEPH_C_BAK=True      # backup volumes to ceph
ENABLE_CEPH_NOVA=True       # allow nova to use ceph resources
ENABLE_CEPH_MANILA=True     # allow manila to use CephFS as backend (Native CephFS or CephFS via NFS)

Change any of the above lines to False to disable that feature specifically.

Manila's CephFS Native driver that supports native Ceph protocol is enabled by default. To use CephFS NFS-Ganesha driver that supports NFS protocol add the setting:

MANILA_CEPH_DRIVER=cephfsnfs

If you'd like to use a standalone NFS Ganesha service in place of ceph orchestrator deployed ceph-nfs service, set:

CEPHADM_DEPLOY_NFS=False

Make sure that the manila plugin is enabled before devstack-plugin-ceph in the local.conf file.

  • Then run stack.sh and wait for the magic to happen :)

Known Issues / Limitations

  • Rados Gateway with Keystone for Swift - works on Ubuntu only
  • Tempest test failures when using RGW as swift endpoint
  • Tempest fails due to verify-tempest-config erroring out, when using RGW as swift endpoint

Bugs