This guide explains how to integrate the ceph-ansible playbooks with OpenStack-Ansible to manage and deploy both systems together as a single unit.
This guide will use the Openstack-Ansible Overlay framework as the basis for integrating the two projects.
I have prepared a sample branch using the Overlay to add ceph-ansible to the OpenStack-Ansible deployment.
To get started with the sample branch, build an AIO as follows:
Once the AIO has finished building, you will have an environment which is configured to use Ceph along with a working Ceph cluster inside the AIO.
How it works
Integrating the ceph-ansible playbooks into the OpenStack-Ansible Overlay configuration involves several configuration files.
ansible-role-requirements.yml: Used to clone the ceph-ansible roles into /etc/ansible/roles
overlay/env/env.d/ceph.yml: Impelments the ceph-mon and ceph-osd containers and groups.
overlay/env/openstack_deploy/user_ceph.yml: The baseline configuration required to run the ceph-ansible roles.
overlay/env/openstack_deploy/user_settings.yml: Configuration used to make OpenStack-Ansible use our Ceph cluster.
overlay/local/openstack_deploy/user_ceph.yml: Automatically created when deploying an AIO using the example repo, this file will contain settings to bootstrap the Ceph cluster inside the AIO.
overlay/playbooks/ceph-install.yml: Playbook used to run the ceph-ansible roles.
scripts/deploy.sh: It executes the playbooks in a similar fashion to OpenStack-Ansible’s
run-playbooks.sh, however in this case it runs the ceph-install.yml playbook at the appropriate time during the OpenStack-Ansible deployment process.
AIO Ceph Architecture
The AIO build included in the example repo will configure a single ceph-mon
container along with 3 OSDs on the host. The OSDs are provisioned using loopback
devices that can be found at
For more detailed information about this example configuration, please review the branch implementing the Ceph integration at Github.
The build can be further customized by following the instructions for Overlay customizations. ceph-ansible offers a variety of configuration options, which are outlined in the group_vars sample files.