a985472cf0
Xenial currently ships with Ceph 10.2.2 which has a known issue that can result in updated images failing to be refreshed when the cluster is overloaded and drops update notifications [1]. This is most likely the cause for recent Ceph gate failures [2]. Disabling the new Jewel+ default image feature of exclusive-lock (revert to Hammer default behavior) should be a workaround for this issue. The RBD default features can be overridden via CEPH_RBD_DEFAULT_FEATURES [1] http://tracker.ceph.com/issues/16404 [2] https://bugs.launchpad.net/cinder/+bug/1627220 Change-Id: Id7fab306e918ba7566ebe2a765d4345fea6c5653 Closes-Bug: #1627878 Signed-off-by: Jason Dillaman <dillaman@redhat.com> |
||
---|---|---|
devstack | ||
manila | ||
.gitignore | ||
.gitreview | ||
LICENSE | ||
README.md | ||
tox.ini |
README.md
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
- Set
- 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 git://git.openstack.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
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
- Patch sent @ https://review.openstack.org/#/c/264179/
TODOs
- Fix Rados Gateway with Keystone for Swift on Fedora