Files
devstack-plugin-ceph/README.md
Sébastien Han 592c7d5711 Add radosgw (aka rgw) support
This patch enables the plugin to setup ceph radosgw and configures
it as a swift-compatible endpoint with keystone integration.

ENABLE_CEPH_RGW is the new variable introduced, which is False
by default, and can be set to True in localrc if radosgw needs
to be setup.

Fixed couple of other (related) things ...
1) Created rgw specific functions
2) Checking for radosgw & swift co-existence, erroring out early enough

NOTE: Tested on ubuntu trusty only

TODOs ...
1) Not tested on Fedora (F22), radosgw startup has some issues there.

Co-Authored-By: Deepak C Shetty <deepakcs@redhat.com>
Change-Id: I21db4168eb69d107599f6b6ab1668b02b764b2c6
2016-01-20 12:47:57 +00:00

2.3 KiB

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

How to use

  • Enable the plugin in localrc:

    enable_plugin devstack-plugin-ceph git://git.openstack.org/openstack/devstack-plugin-ceph

  • Ceph is setup as the default storage backend for Cinder, Cinder Backup, Glance and Nova services. To disable Ceph disable as the storage backend for a service use the following setting in the localrc file,

    ENABLE_CEPH_$SERVICE=False
    

    where $SERVICE can be CINDER, C_BAK, GLANCE or NOVA corresponding to Cinder, Cinder Backup, Glance, and Nova services respectively.

  • Ceph can be enabled as the storage backend for Manila with the following setting in the localrc file,

    ENABLE_CEPH_MANILA=True
    

    Make sure that the manila plugin is enabled before devstack-plugin-ceph in the localrc 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
  • Add support for Ceph Infernalis release
  • Add support for distro specific ceph repos
  • Add Manila support for non-Ubuntu systems

Bugs