devstack-plugin-ceph/README.md

1.8 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
  • 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 :)

TODOs

  • Configuring Rados Gateway with Keystone for Swift
  • Add support for Ceph Infernalis release
  • Add support for distro specific ceph repos
  • Add Manila support for non-Ubuntu systems

Bugs