From 8701736c4b16b656e5f4446b281d80e5cfbc61a5 Mon Sep 17 00:00:00 2001 From: Bala Harish <161304963+balaharish7@users.noreply.github.com> Date: Tue, 15 Oct 2024 11:52:10 +0530 Subject: [PATCH] docs: Added Talos Upgrade Instructions Signed-off-by: Bala Harish <161304963+balaharish7@users.noreply.github.com> --- .../openebs-on-kubernetes-platforms/talos.md | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/docs/main/Solutioning/openebs-on-kubernetes-platforms/talos.md b/docs/main/Solutioning/openebs-on-kubernetes-platforms/talos.md index 47b3fb55..f0a8a8da 100644 --- a/docs/main/Solutioning/openebs-on-kubernetes-platforms/talos.md +++ b/docs/main/Solutioning/openebs-on-kubernetes-platforms/talos.md @@ -111,6 +111,38 @@ talosctl -n service kubelet restart Refer to the [OpenEBS Installation Documentation](../../quickstart-guide/installation.md#installation-via-helm) to install Replicated PV Mayastor using Helm on Talos. +## Talos Upgrade + +The Talos operating system provides a streamlined upgrade process for maintaining and enhancing system performance. It is crucial to follow the appropriate steps based on the version of Talos you are using to ensure data integrity and system stability during upgrades. + +### Version 1.7 or Lower + +Follow the below steps to perform an upgrade for version 1.7 or lower: + +1. Upgrade a node using the `--preserve` flag. + +``` +talosctl -n upgrade --preserve --image $IMAGE_URL +``` + +:::note +The `--preserve` flag explicitly instructs Talos to retain ephemeral data. Upgrading without this flag will compel Talos to reset node configurations and data, resulting in a more intrusive process that will erase the existing etcd state and other stored data. +::: + +2. Verify that the node is operating on the new version. + +``` +talosctl -n version +``` + +3. Repeat this process for all nodes in the cluster. + +### Version 1.8 or Above + +In the Talos Linux installer, the system disk is never wiped during upgrades. Consequently, the `--preserve` flag is automatically applied to the talosctl upgrade command, ensuring a seamless upgrade experience while preserving existing data. + +Refer [Upgrades](https://www.talos.dev/v1.8/introduction/what-is-new/#upgrades) for more details. + ## See Also - [Replicated PV Mayastor Installation on MicroK8s](microkubernetes.md)