Skip to content

Commit 683153a

Browse files
author
Dmitriy Matrenichev
committed
docs: remove the last mentions of preserve flag for Talos 1.8+
This flag no longer exists in Talos 1.8 and higher. Fixes #10172 Signed-off-by: Dmitriy Matrenichev <dmitry.matrenichev@siderolabs.com>
1 parent 33c7f41 commit 683153a

7 files changed

Lines changed: 2 additions & 24 deletions

File tree

website/content/v1.10/advanced/proprietary-kernel-modules.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,5 +61,5 @@ aliases:
6161
3. Deploying to your cluster
6262

6363
```bash
64-
talosctl upgrade --image ghcr.io/your-username/talos-installer:<talos version> --preserve=true
64+
talosctl upgrade --image ghcr.io/your-username/talos-installer:<talos version>
6565
```

website/content/v1.10/kubernetes-guides/configuration/ceph-with-rook.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,9 +102,6 @@ ceph-filesystem rook-ceph.cephfs.csi.ceph.com Delete Immediate
102102

103103
## Talos Linux Considerations
104104

105-
It is important to note that a Rook Ceph cluster saves cluster information directly onto the node (by default `dataDirHostPath` is set to `/var/lib/rook`).
106-
If running only a single `mon` instance, cluster management is little bit more involved, as any time a Talos Linux node is reconfigured or upgraded, the partition that stores the `/var` [file system]({{< relref "../../learn-more/architecture#the-file-system" >}}) is wiped, but the `--preserve` option of [`talosctl upgrade`]({{< relref "../../reference/cli#talosctl-upgrade" >}}) will ensure that doesn't happen.
107-
108105
By default, Rook configues Ceph to have 3 `mon` instances, in which case the data stored in `dataDirHostPath` can be regenerated from the other `mon` instances.
109106
So when performing maintenance on a Talos Linux node with a Rook Ceph cluster (e.g. upgrading the Talos Linux version), it is imperative that care be taken to maintain the health of the Ceph cluster.
110107
Before upgrading, you should always check the health status of the Ceph cluster to ensure that it is healthy.

website/content/v1.10/kubernetes-guides/configuration/local-storage.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,6 @@ description: "Using local storage for Kubernetes workloads."
66
Using local storage for Kubernetes workloads implies that the pod will be bound to the node where the local storage is available.
77
Local storage is not replicated, so in case of a machine failure contents of the local storage will be lost.
88

9-
> Note: when using `EPHEMERAL` Talos partition (`/var`), make sure to use `--preserve` set while performing upgrades, otherwise you risk losing data.
10-
119
## `hostPath` mounts
1210

1311
The simplest way to use local storage is to use `hostPath` mounts.

website/content/v1.10/learn-more/architecture.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,6 @@ Directories like this are `overlayfs` backed by an XFS file system mounted at `/
5050

5151
The `/var` directory is owned by Kubernetes with the exception of the above `overlayfs` file systems.
5252
This directory is writable and used by `etcd` (in the case of control plane nodes), the kubelet, and the CRI (containerd).
53-
Its content survives machine reboots, but it is wiped and lost on machine upgrades and resets, unless the
54-
`--preserve` option of [`talosctl upgrade`]({{< relref "../reference/cli#talosctl-upgrade" >}}) or the
53+
Its content survives machine reboots and on machine upgrades, but it is wiped and lost on resets, unless the
5554
`--system-labels-to-wipe` option of [`talosctl reset`]({{< relref "../reference/cli#talosctl-reset" >}})
5655
is used.

website/content/v1.10/talos-guides/upgrading-talos.md

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,6 @@ This scheme retains the previous Talos kernel and OS image following each upgrad
1515
If an upgrade fails to boot, Talos will roll back to the previous version.
1616
Likewise, Talos may be manually rolled back via API (or `talosctl rollback`), which will update the boot reference and reboot.
1717

18-
Unless explicitly told to `preserve` data, an upgrade will cause the node to wipe the [EPHEMERAL]({{< relref "../learn-more/architecture/#file-system-partitions" >}}) partition, remove itself from the etcd cluster (if it is a controlplane node), and make itself as pristine as is possible.
19-
(This is the desired behavior except in specialised use cases such as single-node clusters.)
20-
2118
*Note* An upgrade of the Talos Linux OS will not (since v1.0) apply an upgrade to the Kubernetes version by default.
2219
Kubernetes upgrades should be managed separately per [upgrading kubernetes]({{< relref "../kubernetes-guides/upgrading-kubernetes" >}}).
2320

@@ -62,10 +59,6 @@ as:
6259
--image ghcr.io/siderolabs/installer:{{< release >}}
6360
```
6461

65-
There is an option to this command: `--preserve`, which will explicitly tell Talos to keep ephemeral data intact.
66-
In most cases, it is correct to let Talos perform its default action of erasing the ephemeral data.
67-
However, for a single-node control-plane, make sure that `--preserve=true`.
68-
6962
Rarely, an upgrade command will fail due to a process holding a file open on disk.
7063
In these cases, you can use the `--stage` flag.
7164
This puts the upgrade artifacts on disk, and adds some metadata to a disk partition that gets checked very early in the boot process, then reboots the node.
@@ -154,7 +147,6 @@ From the user's standpoint, however, the processes are identical.
154147
However, since control plane nodes run additional services, such as etcd, there are some extra steps and checks performed on them.
155148
For instance, Talos will refuse to upgrade a control plane node if that upgrade would cause a loss of quorum for etcd.
156149
If multiple control plane nodes are asked to upgrade at the same time, Talos will protect the Kubernetes cluster by ensuring only one control plane node actively upgrades at any time, via checking etcd quorum.
157-
If running a single-node cluster, and you want to force an upgrade despite the loss of quorum, you can set `preserve` to `true`.
158150

159151
**Q.** Can I break my cluster by upgrading everything at once?
160152

website/content/v1.8/talos-guides/upgrading-talos.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,6 @@ This scheme retains the previous Talos kernel and OS image following each upgrad
1515
If an upgrade fails to boot, Talos will roll back to the previous version.
1616
Likewise, Talos may be manually rolled back via API (or `talosctl rollback`), which will update the boot reference and reboot.
1717

18-
Unless explicitly told to `preserve` data, an upgrade will cause the node to wipe the [EPHEMERAL]({{< relref "../learn-more/architecture/#file-system-partitions" >}}) partition, remove itself from the etcd cluster (if it is a controlplane node), and make itself as pristine as is possible.
19-
(This is the desired behavior except in specialised use cases such as single-node clusters.)
20-
2118
*Note* An upgrade of the Talos Linux OS will not (since v1.0) apply an upgrade to the Kubernetes version by default.
2219
Kubernetes upgrades should be managed separately per [upgrading kubernetes]({{< relref "../kubernetes-guides/upgrading-kubernetes" >}}).
2320

@@ -158,7 +155,6 @@ From the user's standpoint, however, the processes are identical.
158155
However, since control plane nodes run additional services, such as etcd, there are some extra steps and checks performed on them.
159156
For instance, Talos will refuse to upgrade a control plane node if that upgrade would cause a loss of quorum for etcd.
160157
If multiple control plane nodes are asked to upgrade at the same time, Talos will protect the Kubernetes cluster by ensuring only one control plane node actively upgrades at any time, via checking etcd quorum.
161-
If running a single-node cluster, and you want to force an upgrade despite the loss of quorum, you can set `preserve` to `true`.
162158

163159
**Q.** Can I break my cluster by upgrading everything at once?
164160

website/content/v1.9/talos-guides/upgrading-talos.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,6 @@ This scheme retains the previous Talos kernel and OS image following each upgrad
1515
If an upgrade fails to boot, Talos will roll back to the previous version.
1616
Likewise, Talos may be manually rolled back via API (or `talosctl rollback`), which will update the boot reference and reboot.
1717

18-
Unless explicitly told to `preserve` data, an upgrade will cause the node to wipe the [EPHEMERAL]({{< relref "../learn-more/architecture/#file-system-partitions" >}}) partition, remove itself from the etcd cluster (if it is a controlplane node), and make itself as pristine as is possible.
19-
(This is the desired behavior except in specialised use cases such as single-node clusters.)
20-
2118
*Note* An upgrade of the Talos Linux OS will not (since v1.0) apply an upgrade to the Kubernetes version by default.
2219
Kubernetes upgrades should be managed separately per [upgrading kubernetes]({{< relref "../kubernetes-guides/upgrading-kubernetes" >}}).
2320

@@ -157,7 +154,6 @@ From the user's standpoint, however, the processes are identical.
157154
However, since control plane nodes run additional services, such as etcd, there are some extra steps and checks performed on them.
158155
For instance, Talos will refuse to upgrade a control plane node if that upgrade would cause a loss of quorum for etcd.
159156
If multiple control plane nodes are asked to upgrade at the same time, Talos will protect the Kubernetes cluster by ensuring only one control plane node actively upgrades at any time, via checking etcd quorum.
160-
If running a single-node cluster, and you want to force an upgrade despite the loss of quorum, you can set `preserve` to `true`.
161157

162158
**Q.** Can I break my cluster by upgrading everything at once?
163159

0 commit comments

Comments
 (0)