Upgrade Pelagia

Complete the following steps to upgrade Pelagia on an existing Kubernetes cluster:

1. Read upgrade notes of the target Pelagia version described in Upgrade notes and complete pre-upgrade steps, if any.
2. Verify the Pelagia setup and Ceph cluster health as described in Verify Ceph.

3. Upgrade Pelagia using a new Helm chart version provided in the repository:

   helm upgrade --install pelagia-ceph \
       oci://registry.mirantis.com/pelagia/pelagia-ceph \
       --version <target-version> \
       -n pelagia
   

   This command upgrades Pelagia controllers in the pelagia namespace.

   Besides its own controllers, Pelagia can deliver updated Rook and Ceph manifests along with images. If cephRelease is not pinned in Pelagia values, Pelagia will automatically update a Ceph version if a new version is available.

   To pin the Ceph version in the cephRelease field of the Pelagia values file. For example:

   helm upgrade --install pelagia-ceph \
       oci://registry.mirantis.com/pelagia/pelagia-ceph \
       --version <target-version> \
       -n pelagia \
       --set cephRelease=squid
   

   However, we do not recommend pinning the Ceph version to ensure you obtain important updates and bug fixes.

4. Verify the Pelagia setup and Ceph cluster health as described in Verify Ceph.

5. Complete post-upgrade steps, if any. For details, see Upgrade notes.