Upgrades
This guide describes the steps to follow to upgrade the Kubernetes Fury Distribution from one versions to the next.
If you are running a custom set of modules, or different versions than the ones included with each release of KFD, please refer to each module's release notes.
⛔️ IMPORTANT we strongly recommend reading the whole guide before starting the upgrade process to identify possible blockers.
Upgrade procedure
Check the available automatic upgrade paths here. These are the tested and suggested upgrade paths to be used.
Run the upgrade
Change .spec.distributionVersion
on your furyctl.yaml
file with the new vX.X.X
version.
Validate the schema using:
furyctl validate config
Apply the new configuration on the cluster with:
furyctl apply --upgrade
Additional useful flags when upgrading
OnPremises
In the OnPremises provider, during the upgrade, you can use the --skip-nodes-upgrade
flag to skip the actual upgrade of the worker nodes and only do the upgrade of the masters.
In a second moment, you can run for each worker, the command
furyctl apply --upgrade-node <nodename>
where nodename
is the name in the furyctl.yaml file
Upgrade fails during a phase
You can run the command
furyctl apply --upgrade
and furyctl will start from the last successful phase. If you want to start from a different phase, you can use the flag --start-from
like this:
furyctl apply --upgrade --start-from pre-distribution
you can find all the available parameters with the furyctl apply --upgrade --help
command.
Manual upgrade procedure
To upgrade your cluster to the next version manually, follow the release notes for each module and installer.