openstack/openstack-ansible
Code Issues Proposed changes

Merge "[doc] Better document integrated usage of ceph-ansible"

Browse Source
This commit is contained in:
Zuul 2022-11-15 00:13:09 +00:00 committed by Gerrit Code Review
commit 426fa4e5bb
2 changed files with 53 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
doc/source/admin/upgrades/major-upgrades.rst
View File

@ -223,3 +223,38 @@ We can now go ahead with the upgrade of all the OpenStack components.
.. code-block:: console
# openstack-ansible setup-openstack.yml -e package_state=latest
Upgrade Ceph
~~~~~~~~~~~~
With each OpenStack-Ansible version we define default Ceph client version
that will be installed on Glance/Cinder/Nova hosts and used by these services.
If you want to preserve the previous version of the ceph client during an
OpenStack-Ansible upgrade, you will need to override a variable
``ceph_stable_release`` in your user_variables.yml
If Ceph has been deployed as part of an OpenStack-Ansible deployment
using the roles maintained by the `Ceph-Ansible`_ project you will also need
to upgrade the Ceph version. Each OpenStack-Ansible release is tested only with
specific Ceph-Ansible release and Ceph upgrades are not checked in any
Openstack-Ansible integration tests. So we do not test or guarantee an
upgrade path for such deployments. In this case tests should be done in a
lab environment before upgrading.
.. warning::
Ceph related playbooks are included as part of ``setup-infrastructure.yml``
and ``setup-openstack.yml`` playbooks, so you should be cautious when
running them during OpenStack upgrades.
If you have ``upgrade_ceph_packages: true`` in your user variables or
provided ``-e upgrade_ceph_packages=true`` as argument and run
``setup-infrastructure.yml`` this will result in Ceph package being upgraded
as well.
In order to upgrade Ceph in the deployment you will need to run:
.. code-block:: console
# openstack-ansible /etc/ansible/roles/ceph-ansible/infrastructure-playbooks/rolling_update.yml
.. _Ceph-Ansible: https://github.com/ceph/ceph-ansible/

21
doc/source/user/ceph/full-deploy.rst
View File

@ -63,12 +63,27 @@ integration in three ways:
No ssh access by openstack-ansible is required to the ceph cluster.
* deploying a ceph cluster as part of the openstack-ansible deployment
by using the roles maintained by the `Ceph-Ansible`_ project. Deployers
can enable the ``ceph-install`` playbook by adding hosts to the
``ceph-mon_hosts``, ``ceph-osd_hosts`` and ``ceph-rgw_hosts`` groups in
``openstack_user_config.yml``, and then configuring `Ceph-Ansible specific vars
can enable the ``ceph-install.yml`` playbook by adding hosts to the
``ceph-mon_hosts`` and ``ceph-osd_hosts`` groups in
``openstack_user_config.yml``. In order to enable ``ceph-rgw-install.yml``
playbook you need to add ``ceph-rgw_hosts`` in ``openstack_user_config.yml``.
.. note::
Please mention, that RGW installation should be performed after deployment of
Keystone service.
Once groups are defined, you can proceed with configuring `Ceph-Ansible specific vars
<https://github.com/ceph/ceph-ansible/blob/master/group_vars/all.yml.sample>`_
in the OpenStack-Ansible ``user_variables.yml`` file.
.. warning::
Deploying ceph cluster as part of openstack-ansible is not recommended since
ceph-ansible upgrade path is not tested or supported. This option is mainly
used for CI and AIO deployments to test and demonstrate a sample integration
of the software stack.
.. _Ceph-Ansible: https://github.com/ceph/ceph-ansible/
This example will focus on the deployment of both OpenStack-Ansible