docs: Add upgrade operation.

This commit adds a chapter about the ceph upgrade process.

Closes: #5393
Signed-off-by: Dimitri Savineau <dsavinea@redhat.com>
(cherry picked from commit e41487dbce9dd5e9d754270bec426bea920406be)

diff --git a/docs/source/day-2/upgrade.rst b/docs/source/day-2/upgrade.rst
new file mode 100644 (file)
index 0000000..6b82cbd
--- /dev/null
+++ b/docs/source/day-2/upgrade.rst
@@ -0,0 +1,17 @@
+Upgrading the ceph cluster
+-------------------
+
+ceph-ansible provides a playbook in ``infrastructure-playbooks`` for upgrading a Ceph cluster: ``rolling_update.yml``.
+
+This playbook could be used for both minor upgrade (X.Y to X.Z) or major upgrade (X to Y).
+
+Before running a major upgrade you need to update the ceph-ansible version first.
+
+example:
+
+.. code-block:: shell
+
+   $ ansible-playbook -vv -i hosts infrastructure-playbooks/rolling_update.yml
+
+.. note::
+   This playbook isn't intended to be run with the ``--limit`` ansible option.
\ No newline at end of file

diff --git a/docs/source/index.rst b/docs/source/index.rst
index a70b0bd5370d85a3b5e31376bcb50c96622a0100..94d770f888924730064d185b3dc06295648c0adc 100644 (file)
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -282,6 +282,7 @@ ceph-ansible provides a set of playbook in ``infrastructure-playbooks`` director
 
    day-2/osds
    day-2/purge
+   day-2/upgrade
 
 Contribution
 ============