Upgrade guide for 2.15

docs/how-to/index.rst

@@ -38,6 +38,7 @@ Upgrading
    :maxdepth: 1
 
    migrate-v1-v2
+   migrate-v21-v215
 
 Managing
 --------

docs/how-to/migrate-v21-v215.rst

@@ -0,0 +1,54 @@
+Upgrade Charmed MLflow Version 2.1 to Version 2.15
+==================================================
+
+This guide shows how to upgrade Charmed MLflow version 2.1 to version 2.15. This guide assumes you are running the old Charmed MLflow stack version 2.11.
+
+Prerequisites
+-------------
+
+This guide assumes the following:
+
+#. You have deployed MLflow version 2.11.
+#. You have a CLI access to the machine where the Juju controller is deployed (all commands will be executed from there).
+
+Backup data (Optional)
+----------------------
+
+Although the process of upgrading MLflow 2.11 to 2.15 should be seamless you might still want to backup your MinIO data with your experiments and models. You can find all the details in the :ref:`backup` how to guide.
+
+.. note:: We don't have to backup the MySQL data as we are still using the same version `8.0/stable` in both versions of MLflow.
+
+Upgrade MicroK8s
+---------------
+
+Make sure that your system is running MicroK8s version 1.29 or higher.
+
+If the version is lower please refer to this `MicroK8s Upgrade Documentation <https://microk8s.io/docs/upgrading>`_.
+
+Upgrade Juju
+-----------
+
+Make sure that your system is running Juju version 3.4.
+
+If the version is lower please refer to this `Juju Upgrade Documentation <https://juju.is/docs/juju/upgrade-your-juju-deployment>`_.
+
+Upgrade MLflow bundle
+--------------------
+
+To Upgrade MLflow bundle components from 2.11 to 2.15 please run these commands:
+
+.. code-block:: bash
+
+    juju refresh mlflow-minio --channel=ckf-1.9/stable
+    juju refresh mlflow-server --channel=2.15/stable
+
+Upgrade Resource dispatcher (Optional)
+--------------------------------------
+
+If you are running MLflow with Kubeflow you must upgrade your Resource dispatcher deployment. MLflow 2.15 works only with Resource dispatcher version 2.0/stable.
+
+To upgrade your Resource dispatcher charm run these commands:
+
+.. code-block:: bash
+
+    juju refresh resource-dispatcher --channel=2.0/stable