Cluster Upgrades
Upgrading Talos
-
Check the current Talos cluster info and version
talosctl get info talosctl get version -
Review the new features, support matrix, and upgrade steps in the Talos Docs.
The following links are for Talos v1.11:
- What's new in Talos
- Support Matrix
- Upgrading Talos
-
Locally update the value of
local.versioninplatform-layer/terraform/talos-cluster.tfwith the appropriate target version.locals { ... talos_install_version = "X.X.X" ... }Note
Talos requires step-upgrading to the latest patch of the current minor release before the latest patch of the next minor version. Upgrading from v1.10.2 to v.1.11.3, for example, would require first upgrading to v1.10.7 before upgrading to v1.11.3.
-
Generate and display the new Terraform outputs
cd platform-layer/terraform/ TF_WORKSPACE=homeops-pf-layer terraform init TF_WORKSPACE=homeops-pf-layer terraform plan -refresh-only -
Upgrade one of the Talos nodes with the new installer image from the Terraform output
talosctl upgrade \ --preserve \ --image 'factory.talos.dev/nocloud-installer/88d1f7a5c4f1d3aba7df787c448c1d3d008ed29cfb34af53fa0df4336a56040b:v1.10.7' \ --nodes '192.168.20.X' -
Repeat step 5 for each node in the cluster
- Repeat steps 1-6, step-upgrading until the final target version is reached
-
Run
terraform applyto view and reconcile any changesTF_WORKSPACE=homeops-pf-layer terraform apply -
Commit, push, and merge the changes