diff --git a/docs/source/day-2/upgrade.rst b/docs/source/day-2/upgrade.rst
new file mode 100644
index 000000000..6b82cbddc
--- /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 eada41ec4..ee894baef 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -281,6 +281,7 @@ ceph-ansible provides a set of playbook in ``infrastructure-playbooks`` director
 
    day-2/osds
    day-2/purge
+   day-2/upgrade
 
 Contribution
 ============