bf07abf7a9
As devstack-plugin-ceph is branched, we moved stable branch jobs definition in their respective branch - https://review.opendev.org/c/openstack/devstack-plugin-ceph/+/786308 - https://review.opendev.org/c/openstack/devstack-plugin-ceph/+/786309 - https://review.opendev.org/c/openstack/devstack-plugin-ceph/+/786310 - https://review.opendev.org/c/openstack/devstack-plugin-ceph/+/786311 But we did not cleanup the master version of job definition so that we do not need to do it for future stable branches. When stable/xena is cut from master the ./.zuul.yaml version of jobs in stable/xena has the stable branches variant which is being picked up by zuul for stable branch gate instead of their own version defined in their stable branch. - https://zuul.opendev.org/t/openstack/build/bc088154e50440fe9a2cacf52426748a/log/zuul-info/inventory.yaml#241 And it started failing ceph job when ceph version was update for master and same is being picked by stable branch testin so due to above branch matching logic. To avoid this in future when we will have stable/yoga or so we need to cleanup this in master. Master repo will only keep the master version of jobs and no stable branch jobs. Other stable/rocky and older jobs will be moved to stable/stein so that we have them there if anyone cut the branch. Closes-Bug: #1945358 Change-Id: I7061f8d1491ff957452c9c777e40186a4e9c324e |
||
---|---|---|
devstack | ||
doc | ||
.gitignore | ||
.gitreview | ||
.zuul.yaml | ||
CONTRIBUTING.rst | ||
LICENSE | ||
README.rst | ||
tempest_skiplist.txt | ||
tempest_skiplist_multinode.txt | ||
tox.ini |
README.rst
Devstack Ceph Plugin
Overview
Devstack plugin to configure Ceph as the storage backend for openstack services
As part of stack.sh
:
- 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 yourlocalrc
- 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
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
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 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
:ENABLE_CEPH_MANILA=True
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:
MANILA_CEPH_DRIVER=cephfsnfs
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
- Manila with CephFS - for Ubuntu, support only for Trusty Tahr (14.04 LTS) and beyond
TODOs
- Fix Rados Gateway with Keystone for Swift on Fedora