From 4b18293dc5cb9392bbe85d13cb8bd6d505a53d81 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 61fcf0e4..046ebc7d 100644 --- a/docs/main/Solutioning/openebs-on-kubernetes-platforms/talos.md +++ b/docs/main/Solutioning/openebs-on-kubernetes-platforms/talos.md @@ -113,6 +113,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)