Skip to content

Commit b40c7ed

Browse files
committed
docs(talos): warn against changing op: on the machine files block
Talos rejects op: create for files outside /var, so the lvm.conf customization must stay op: overwrite. A wrong op fails the WriteUserFiles boot step and reboot-loops the node with an opaque "bootstrap is not available yet". Assisted-By: Claude <noreply@anthropic.com> Signed-off-by: Aleksei Sviridkin <f@lex.la>
1 parent 7a5ab3c commit b40c7ed

2 files changed

Lines changed: 8 additions & 0 deletions

File tree

content/en/docs/next/install/kubernetes/talos-bootstrap.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,10 @@ talos-bootstrap --help
102102
- 10.96.0.0/16
103103
```
104104

105+
{{% alert title="Do not change op: on these entries" color="warning" %}}
106+
Talos rejects `op: create` for any file outside `/var` with `create operation not allowed outside of /var` — the only exception is the special-cased `/etc/cri/conf.d/20-customization.part`. Because `/etc/lvm/lvm.conf` already exists on the node, it must use `op: overwrite`. Changing the op (or pointing `create` at another `/etc` path) fails the `WriteUserFiles` boot step: the node pauses and reboots on a loop, and `talosctl bootstrap` reports only `bootstrap is not available yet` with no obvious cause.
107+
{{% /alert %}}
108+
105109
1. Make another configuration patch file `patch-controlplane.yaml` with settings exclusive to control plane nodes:
106110

107111
```yaml

content/en/docs/next/install/kubernetes/talosctl.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,10 @@ Discovered open port 50000/tcp on 192.168.123.13
126126
- 10.96.0.0/16
127127
```
128128

129+
{{% alert title="Do not change op: on these entries" color="warning" %}}
130+
Talos rejects `op: create` for any file outside `/var` with `create operation not allowed outside of /var` — the only exception is the special-cased `/etc/cri/conf.d/20-customization.part`. Because `/etc/lvm/lvm.conf` already exists on the node, it must use `op: overwrite`. Changing the op (or pointing `create` at another `/etc` path) fails the `WriteUserFiles` boot step: the node pauses and reboots on a loop, and `talosctl bootstrap` reports only `bootstrap is not available yet` with no obvious cause.
131+
{{% /alert %}}
132+
129133
1. Make another configuration patch file `patch-controlplane.yaml` with settings exclusive to control plane nodes:
130134

131135
Note that VIP address is used for `machine.network.interfaces[0].vip.ip`:

0 commit comments

Comments
 (0)