12555d7ce3
configuration examples for nova glance and cinder to use ceph Change-Id: Id0655f2ac14e6f375e88c31067ca6fb6a18f2e12
89 lines
3.0 KiB
ReStructuredText
89 lines
3.0 KiB
ReStructuredText
`Home <index.html>`_ OpenStack-Ansible Installation Guide
|
|
|
|
Configuring the Ceph client (optional)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Ceph is a massively scalable, open source, distributed storage system.
|
|
|
|
These links provide more details around how to use Ceph with OpenStack:
|
|
|
|
* `Ceph Block Devices and OpenStack`_
|
|
* `Ceph - The De Facto Storage Backend for OpenStack`_ *(Hong Kong Summit
|
|
talk)*
|
|
* `OpenStack Config Reference - Ceph RADOS Block Device (RBD)`_
|
|
* `OpenStack-Ansible and Ceph Working Example`_
|
|
|
|
|
|
.. _Ceph Block Devices and OpenStack: http://docs.ceph.com/docs/master/rbd/rbd-openstack/
|
|
.. _Ceph - The De Facto Storage Backend for OpenStack: https://www.openstack.org/summit/openstack-summit-hong-kong-2013/session-videos/presentation/ceph-the-de-facto-storage-backend-for-openstack
|
|
.. _OpenStack Config Reference - Ceph RADOS Block Device (RBD): http://docs.openstack.org/liberty/config-reference/content/ceph-rados.html
|
|
.. _OpenStack-Ansible and Ceph Working Example: https://www.openstackfaq.com/openstack-ansible-ceph/
|
|
|
|
Configuring Ceph storage servers is outside the scope of this documentation.
|
|
|
|
Authentication
|
|
--------------
|
|
|
|
The ``cephx`` authentication method is strongly recommended in the `Ceph
|
|
config reference`_ and OpenStack-Ansible enables ``cephx`` by default for
|
|
the Ceph client. Deployers may choose to override this setting by using the
|
|
``cephx`` Ansible variable:
|
|
|
|
.. code-block:: yaml
|
|
|
|
cephx: False
|
|
|
|
Ceph **must** be deployed on a trusted network if ``cephx`` is disabled.
|
|
|
|
.. _Ceph config reference: http://docs.ceph.com/docs/master/rados/configuration/auth-config-ref/
|
|
|
|
Configuration file overrides
|
|
----------------------------
|
|
|
|
OpenStack-Ansible provides the ``ceph_conf_file`` variable which allows
|
|
deployers to specify configuration file options to override the default
|
|
Ceph configuration.
|
|
|
|
.. code-block:: console
|
|
|
|
ceph_conf_file: |
|
|
[global]
|
|
fsid = 4037aa5f-abde-4378-9470-f73dbd6ceaba
|
|
mon_initial_members = mon1.example.local,mon2.example.local,mon3.example.local
|
|
mon_host = 172.29.244.151,172.29.244.152,172.29.244.153
|
|
auth_cluster_required = cephx
|
|
auth_service_required = cephx
|
|
auth_client_required = cephx
|
|
|
|
The following minimal example configuration sets nova and glance
|
|
to use ceph pools: ``ephemeral-vms`` and ``images`` respectively.
|
|
The example uses cephx authentication, and requires existing ``glance`` and
|
|
``cinder`` accounts for ``images`` and ``ephemeral-vms`` pools.
|
|
|
|
.. code-block:: console
|
|
|
|
glance_default_store: rbd
|
|
nova_libvirt_images_rbd_pool: ephemeral-vms
|
|
|
|
|
|
Monitors
|
|
--------
|
|
|
|
The `Ceph Monitor`_ maintains a master copy of the cluster map.
|
|
OpenStack-Ansible provides the ``ceph_mons`` variable and expects a list of
|
|
IP addresses for the Ceph Monitor servers in the deployment:
|
|
|
|
.. code-block:: yaml
|
|
|
|
ceph_mons:
|
|
- 172.29.244.151
|
|
- 172.29.244.152
|
|
- 172.29.244.153
|
|
|
|
|
|
.. _Ceph Monitor: http://docs.ceph.com/docs/master/rados/configuration/mon-config-ref/
|
|
|
|
--------------
|
|
|
|
.. include:: navigation.txt
|