DevStack plugin to configure Ceph backend.
Go to file
Ashley Rodriguez b663a9fb83 Remote Ceph with cephadm
Add podman ceph-common and jq as part of preinstall dependency.
Add REMOTE_CEPH capabilities to CEPHADM deployment.
Removed set_min_client only if cinder is enabled, this should be set
in any case.
Get FSID from ceph.conf in /etc/ceph to avoid unnecessary override.

Part of an effort to test multinode deployments with cephadm.

Needed-By: I5162815b66d3f3e8cf8c1e246b61b0ea06c1a270
Change-Id: I84249ae268dfe00a112c67e5170b679acb318a25
2023-09-12 20:51:41 +00:00
devstack Remote Ceph with cephadm 2023-09-12 20:51:41 +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 Remote Ceph with cephadm 2023-09-12 20:51:41 +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 TrivialFix: PDF and doc corrections 2020-10-08 15:25:43 -07:00
tempest_skiplist.txt Unskip rebuild_volume_backed_server test 2023-06-27 12:18:56 -07:00
tempest_skiplist_multinode.txt zuul: Introduce a multinode ceph job 2021-03-12 17:22:54 +00:00
tox.ini Use TOX_CONSTRAINTS_FILE 2022-07-26 11:42:19 +08:00


Devstack Ceph Plugin



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

As part of

  • Installs Ceph (client and server) packages
  • Creates a Ceph cluster for use with openstack services
  • Configures Ceph as the storage backend for Cinder, Cinder Backup, Nova, Manila (not by default), 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 |

  • Tears down the Ceph cluster and its related services

This plugin also gets used to configure Ceph as the storage backend for the upstream Ceph CI job named gate-tempest-dsvm-full-devstack-plugin-ceph


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

    enable_plugin devstack-plugin-ceph

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

  • Ceph is setup as the default storage backend for Cinder, Cinder Backup, Glance 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

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

  • Ceph can be enabled as the storage backend for Manila with the following setting in your local.conf:


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


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

  • Then run 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
  • Manila with CephFS - for Ubuntu, support only for Trusty Tahr (14.04 LTS) and beyond


  • Fix Rados Gateway with Keystone for Swift on Fedora