DevStack plugin to configure Ceph backend.
Go to file
Jason Dillaman a985472cf0 Revert Ceph RBD to Hammer-release default features
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>
2016-10-04 08:55:34 -04:00
devstack Revert Ceph RBD to Hammer-release default features 2016-10-04 08:55:34 -04:00
manila manila: Disable upload of service image 2016-04-07 15:58:21 +05:30
.gitignore Initial commit 2015-11-27 19:43:03 +00:00
.gitreview Added .gitreview 2015-11-25 14:11:30 +00:00
LICENSE Initial commit 2015-11-27 19:43:03 +00:00
README.md Support systemd and ceph versions >= 9.2 2016-07-01 14:23:24 -04:00
tox.ini Suppress bashate line length warnings 2016-05-28 05:40:23 -04:00

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

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

TODOs

  • Fix Rados Gateway with Keystone for Swift on Fedora

Bugs