Skip to content

Commit 58661de

Browse files
ihelmer07smira
authored andcommitted
docs: update getting-started.md
Clarifies even further that Talos is loaded to RAM until configuration is applied. See #10349 Signed-off-by: ihelmer07 <ihelmer07@gmail.com> Signed-off-by: Andrey Smirnov <andrey.smirnov@siderolabs.com>
1 parent 94cf9fb commit 58661de

2 files changed

Lines changed: 13 additions & 5 deletions

File tree

website/content/v1.10/introduction/getting-started.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -86,14 +86,18 @@ The endpoint should be formatted like:
8686
When Talos boots without a configuration, such as when booting off the Talos ISO, it
8787
enters maintenance mode and waits for a configuration to be provided.
8888

89-
> A configuration can be passed in on boot via kernel parameters or metadata servers.
90-
> See [Production Notes]({{< relref "prodnotes#configure-talos" >}}).
89+
> NOTE: Talos initially loads the OS to RAM, and only installs to disk after the configuration is applied.
90+
> If you reboot the machine before applying machine config, make sure your boot media is still present.
9191
9292
Unlike traditional Linux, Talos Linux is _not_ configured by SSHing to the server and issuing commands.
9393
Instead, the entire state of the machine is defined by a `machine config` file which is passed to the server.
9494
This allows machines to be managed in a declarative way, and lends itself to GitOps and modern operations paradigms.
95+
9596
The state of a machine is completely defined by, and can be reproduced from, the machine configuration file.
9697

98+
> A configuration can be passed in on boot via kernel parameters or metadata servers.
99+
> See [Production Notes]({{< relref "prodnotes#configure-talos" >}}).
100+
97101
To generate the machine configurations for a cluster, run this command on the workstation where you installed `talosctl`:
98102

99103
```sh
@@ -158,7 +162,7 @@ You can verify which disks your nodes have by using the `talosctl get disks --in
158162
For example, the `talosctl get disks` command below shows that the system has a `vda` drive, not an `sda`:
159163

160164
```sh
161-
$ talosctl -n 192.168.0.2 disks --insecure
165+
$ talosctl -n 192.168.0.2 get disks --insecure
162166
DEV MODEL SERIAL TYPE UUID WWID MODALIAS NAME SIZE BUS_PATH
163167
/dev/vda - - HDD - - virtio:d00000002v00001AF4 - 69 GB /pci0000:00/0000:00:06.0/virtio2/
164168
```

website/content/v1.9/introduction/getting-started.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -86,14 +86,18 @@ The endpoint should be formatted like:
8686
When Talos boots without a configuration, such as when booting off the Talos ISO, it
8787
enters maintenance mode and waits for a configuration to be provided.
8888

89-
> A configuration can be passed in on boot via kernel parameters or metadata servers.
90-
> See [Production Notes]({{< relref "prodnotes#configure-talos" >}}).
89+
> NOTE: Talos initially loads the OS to RAM, and only installs to disk after the configuration is applied.
90+
> If you reboot the machine before applying machine config, make sure your boot media is still present.
9191
9292
Unlike traditional Linux, Talos Linux is _not_ configured by SSHing to the server and issuing commands.
9393
Instead, the entire state of the machine is defined by a `machine config` file which is passed to the server.
9494
This allows machines to be managed in a declarative way, and lends itself to GitOps and modern operations paradigms.
95+
9596
The state of a machine is completely defined by, and can be reproduced from, the machine configuration file.
9697

98+
> A configuration can be passed in on boot via kernel parameters or metadata servers.
99+
> See [Production Notes]({{< relref "prodnotes#configure-talos" >}}).
100+
97101
To generate the machine configurations for a cluster, run this command on the workstation where you installed `talosctl`:
98102

99103
```sh

0 commit comments

Comments
 (0)