MetalK8s clusters are upgraded using the utility scripts packaged with every new release. This topic describes upgrading MetalK8s and all components included in the stack.
Note
MetalK8s supports upgrade of at most one minor version at a time. For example:
- from 2.4.0 to 2.4.4,
- from 2.4.0 to 2.5.1.
Refer to the release notes for more information.
Provision a new MetalK8s ISO by running the utility script shipped with the current installation.
/srv/scality/metalk8s-X.X.X/iso-manager.sh -a <path_to_iso>
Use the --dry-run
option to validate your environment for upgrade:
/srv/scality/metalk8s-X.Y.Z/upgrade.sh --dry-run --verbose
This will simulate the upgrade pre-checks and provide an overview of the changes to be carried out in your MetalK8s cluster.
Important
The version prefix metalk8s-X.Y.Z must be the new MetalK8s version you want to upgrade to.
Run the utility script shipped with the new version you want to upgrade to.
From the :term:`Bootstrap node`, launch the upgrade.
/srv/scality/metalk8s-X.Y.Z/upgrade.sh
Important
The version prefix metalk8s-X.Y.Z must be the new MetalK8s version you want to upgrade to.