Takashi Kajinami 86e2406041 Remove logic for old releases

Ceph Pacific already reached its EOL. Also nfs-ganesha 3.x were used in
Ubuntu <= 22.04 or CentOS <= 8 which are no longer supported.
In addition, fix the ignored GANESHA_RELEASE in EL operating systems.
Change-Id: I96e212f2e6202d061903332bccd7a331fc6f3bda
Signed-off-by: Takashi Kajinami <kajinamit@oss.nttdata.com>

2026-08-13 14:16:58 +09:00

2021-05-31 15:05:57 -05:00

2026-06-18 14:58:22 +02:00

2020-04-22 00:54:27 +00:00

2019-04-19 19:40:27 +00:00

2026-04-30 00:43:41 +09:00

2020-04-22 14:07:07 +00:00

2015-11-27 19:43:03 +00:00

2026-06-18 14:58:22 +02:00

2024-09-11 18:51:36 +00:00

2022-07-26 11:42:19 +08:00

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 :)

Setup With Rados Gateway

To setup Ceph with Rados Gateway and configure it as a Swift endpoint, you will need to enable following setting in your local.conf in addition to the settings mentioned in the previous section:

ENABLE_CEPH_RGW=True

For a full example, please see file ./examples/ceph-with-rgw-local.conf in this repository.

Test With Older Ceph Releases

You can build devstack with older versions of ceph releases. Change the version of ceph release by overriding variable CONTAINER_IMAGE in your configuration file.

Supported releases are following:

# Change Ceph Version by changing tag in CONTAINER_IMAGE.
# Supported versions are:
#   reef: quay.io/ceph/ceph:v18
#   squid: quay.io/ceph/ceph:v19
#   tentacle: quay.io/ceph/ceph:v20
CONTAINER_IMAGE=quay.io/ceph/ceph:v20

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
Ceph requires passwordless SSH access to the root user on the machine. Adding PermitRootLogin prohibit-password to the sshd_config is sufficient.

Bugs

https://bugs.launchpad.net/devstack-plugin-ceph