19051aa4cd
Currently the devstack ceph plugin uses installation, configuration, startup, and shutdown commands that do not always work correctly for Ceph releases after hammer or with systemd init system. Check the ceph version and the init system and use appropriate commands. Co-Authored-By: Ramana Raja <rraja@redhat.com> Change-Id: I25d8816740c6008b076986f3677c299ad9843c30
75 lines
2.4 KiB
Markdown
75 lines
2.4 KiB
Markdown
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
|
|
* Patch sent @ https://review.openstack.org/#/c/264179/
|
|
|
|
|
|
# TODOs
|
|
|
|
* Fix Rados Gateway with Keystone for Swift on Fedora
|
|
|
|
# Bugs
|
|
|
|
* https://bugs.launchpad.net/devstack-plugin-ceph
|