diff --git a/public/docs.json b/public/docs.json index 0e3ffcc5..de68aa47 100644 --- a/public/docs.json +++ b/public/docs.json @@ -433,6 +433,7 @@ "talos/v1.12/learn-more/networking-resources", "talos/v1.12/learn-more/philosophy", "talos/v1.12/learn-more/process-capabilities", + "talos/v1.12/learn-more/talos-for-linux-admins", "talos/v1.12/learn-more/talos-network-connectivity", "talos/v1.12/learn-more/talos-platform-configuration", "talos/v1.12/learn-more/talosctl" @@ -750,6 +751,7 @@ "talos/v1.11/learn-more/networking-resources", "talos/v1.11/learn-more/philosophy", "talos/v1.11/learn-more/process-capabilities", + "talos/v1.11/learn-more/talos-for-linux-admins", "talos/v1.11/learn-more/talos-network-connectivity", "talos/v1.11/learn-more/talosctl" ] diff --git a/public/talos/v1.11/learn-more/talos-for-linux-admins.mdx b/public/talos/v1.11/learn-more/talos-for-linux-admins.mdx new file mode 100644 index 00000000..68832638 --- /dev/null +++ b/public/talos/v1.11/learn-more/talos-for-linux-admins.mdx @@ -0,0 +1,297 @@ +--- +title: Talos for Linux Admins +--- + +This document is intended for Linux administrators who are familiar with traditional Linux systems and want to understand how to inspect, manage, and reason about a Talos node. + +## How Talos differs from traditional Linux + +Talos is a minimal, API-driven operating system designed specifically to run Kubernetes. + +Unlike traditional Linux distributions, Talos does not have: + +* An interactive shell (SSH) +* A package manager +* A mutable user space +* Common Linux utilities by default + +Instead, all node inspection and management is performed through the Talos API using the talosctl CLI. This design allows Talos to remain immutable and consistently managed while still exposing the information required for day-to-day operations. + +For Linux administrators, this means familiar actions still exist conceptually, but they are accessed through API calls rather than local commands. + +## Things to note that you will use constantly + +In addition to learning the Talos command equivalents, there are a few concepts you’ll rely on frequently. + +* **Maintenance node**: When a node is in maintenance mode, meaning it has booted but has not yet received a machine configuration, commands must be run with the `--insecure` flag. Not all commands are available in this mode. Refer to [the --insecure flag documentation](../configure-your-talos-cluster/system-configuration/insecure) to understand which operations are supported and how to use them safely. +* **Discoverability**: To see all available resource definitions exposed by Talos, run: + + ```bash + talosctl get resourcedefinitions --nodes + ``` + +Here are some familiar Linux commands and its Talos equivalent. + +## Orientation and discovery + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux habit****Talos command****Notes**
Check kube context`talosctl config info`Shows active endpoints and context
"What objects exist?"`talosctl get rd`Lists all available Talos resources
node name`talosctl get nodename`Displays the name of the specified node
hostname`talosctl get hostname`Displays the hostname of the node
`kubectl get nodes``talosctl get members`Lists all cluster members
+ +## Files and filesystem + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ls``talosctl list`Lists exposed filesystem paths only
`cat``talosctl read`Read-only file access
`mount``talosctl mounts`, `talosctl get mounts`, and `talosctl get volumestatus`Shows mounted filesystems
+ +Talos has no interactive shell and no writable filesystem + +## Disks and storage + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`lsblk``talosctl get disks`High-level disk inventory
`lspci``talosctl get pcidevices`PCI device discovery
Volume discovery`talosctl get discoveredvolume`Used during installation / bootstrap
Disk usage`talosctl usage`Filesystem-level visibility
+ +## Hardware and system info + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`lscpu``talosctl get cpu`CPU topology and features
`free``talosctl memory`Memory usage summary
`dmidecode``talosctl get systeminformation`Vendor, model, UUID, firmware
`lsmod``talosctl get loadedkernelmodules`Loaded kernel modules
`modprobe``talosctl patch mc`Needs to be done from a configuration patch
+ +## Processes and services + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ps``talosctl processes`Shows running processes
`top`, `htop``talosctl dashboard`Live streaming view
`systemctl status``talosctl services`Talos services, not systemd
`systemctl restart``talosctl service restart [service]`Restart OS services
`docker stats``talosctl stats`Container runtime statistics
+ +Talos does not use systemd, services are Talos-native + +## Networking + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ip addr``talosctl get addresses | links`Interface IP addresses
`ip route``talosctl get routes`Routing table
`ethtool``talosctl get linkstatuses` and `talosctl get ethernetstatuses`Link state and speed
`netstat`, `ss``talosctl netstat`Socket inspection
`tcpdump``talosctl pcap`Packet capture (stream or file)
+ +## Logs and events + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`journalctl -u ``talosctl logs `Service logs
`journalctl -f``talosctl logs -f `Follow logs
`dmesg``talosctl dmesg` or `talosctl logs kernel`Kernel ring buffer
+ +## Additional commands + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`do-release-upgrade``talosctl upgrade`Upgrade talos
`talosctl wipe`Erase a drive or partition
`poweroff``talosctl shutdown` and `talosctl reboot`Shut down node
`docker pull``talosctl image pull`Pull a container image
`docker images``talosctl image list`Lists all available images
`scp``talosctl copy`Copy files from nodes
diff --git a/public/talos/v1.12/learn-more/talos-for-linux-admins.mdx b/public/talos/v1.12/learn-more/talos-for-linux-admins.mdx new file mode 100644 index 00000000..68832638 --- /dev/null +++ b/public/talos/v1.12/learn-more/talos-for-linux-admins.mdx @@ -0,0 +1,297 @@ +--- +title: Talos for Linux Admins +--- + +This document is intended for Linux administrators who are familiar with traditional Linux systems and want to understand how to inspect, manage, and reason about a Talos node. + +## How Talos differs from traditional Linux + +Talos is a minimal, API-driven operating system designed specifically to run Kubernetes. + +Unlike traditional Linux distributions, Talos does not have: + +* An interactive shell (SSH) +* A package manager +* A mutable user space +* Common Linux utilities by default + +Instead, all node inspection and management is performed through the Talos API using the talosctl CLI. This design allows Talos to remain immutable and consistently managed while still exposing the information required for day-to-day operations. + +For Linux administrators, this means familiar actions still exist conceptually, but they are accessed through API calls rather than local commands. + +## Things to note that you will use constantly + +In addition to learning the Talos command equivalents, there are a few concepts you’ll rely on frequently. + +* **Maintenance node**: When a node is in maintenance mode, meaning it has booted but has not yet received a machine configuration, commands must be run with the `--insecure` flag. Not all commands are available in this mode. Refer to [the --insecure flag documentation](../configure-your-talos-cluster/system-configuration/insecure) to understand which operations are supported and how to use them safely. +* **Discoverability**: To see all available resource definitions exposed by Talos, run: + + ```bash + talosctl get resourcedefinitions --nodes + ``` + +Here are some familiar Linux commands and its Talos equivalent. + +## Orientation and discovery + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux habit****Talos command****Notes**
Check kube context`talosctl config info`Shows active endpoints and context
"What objects exist?"`talosctl get rd`Lists all available Talos resources
node name`talosctl get nodename`Displays the name of the specified node
hostname`talosctl get hostname`Displays the hostname of the node
`kubectl get nodes``talosctl get members`Lists all cluster members
+ +## Files and filesystem + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ls``talosctl list`Lists exposed filesystem paths only
`cat``talosctl read`Read-only file access
`mount``talosctl mounts`, `talosctl get mounts`, and `talosctl get volumestatus`Shows mounted filesystems
+ +Talos has no interactive shell and no writable filesystem + +## Disks and storage + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`lsblk``talosctl get disks`High-level disk inventory
`lspci``talosctl get pcidevices`PCI device discovery
Volume discovery`talosctl get discoveredvolume`Used during installation / bootstrap
Disk usage`talosctl usage`Filesystem-level visibility
+ +## Hardware and system info + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`lscpu``talosctl get cpu`CPU topology and features
`free``talosctl memory`Memory usage summary
`dmidecode``talosctl get systeminformation`Vendor, model, UUID, firmware
`lsmod``talosctl get loadedkernelmodules`Loaded kernel modules
`modprobe``talosctl patch mc`Needs to be done from a configuration patch
+ +## Processes and services + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ps``talosctl processes`Shows running processes
`top`, `htop``talosctl dashboard`Live streaming view
`systemctl status``talosctl services`Talos services, not systemd
`systemctl restart``talosctl service restart [service]`Restart OS services
`docker stats``talosctl stats`Container runtime statistics
+ +Talos does not use systemd, services are Talos-native + +## Networking + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ip addr``talosctl get addresses | links`Interface IP addresses
`ip route``talosctl get routes`Routing table
`ethtool``talosctl get linkstatuses` and `talosctl get ethernetstatuses`Link state and speed
`netstat`, `ss``talosctl netstat`Socket inspection
`tcpdump``talosctl pcap`Packet capture (stream or file)
+ +## Logs and events + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`journalctl -u ``talosctl logs `Service logs
`journalctl -f``talosctl logs -f `Follow logs
`dmesg``talosctl dmesg` or `talosctl logs kernel`Kernel ring buffer
+ +## Additional commands + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`do-release-upgrade``talosctl upgrade`Upgrade talos
`talosctl wipe`Erase a drive or partition
`poweroff``talosctl shutdown` and `talosctl reboot`Shut down node
`docker pull``talosctl image pull`Pull a container image
`docker images``talosctl image list`Lists all available images
`scp``talosctl copy`Copy files from nodes
diff --git a/public/talos/v1.13/learn-more/talos-for-linux-admins.mdx b/public/talos/v1.13/learn-more/talos-for-linux-admins.mdx new file mode 100644 index 00000000..68832638 --- /dev/null +++ b/public/talos/v1.13/learn-more/talos-for-linux-admins.mdx @@ -0,0 +1,297 @@ +--- +title: Talos for Linux Admins +--- + +This document is intended for Linux administrators who are familiar with traditional Linux systems and want to understand how to inspect, manage, and reason about a Talos node. + +## How Talos differs from traditional Linux + +Talos is a minimal, API-driven operating system designed specifically to run Kubernetes. + +Unlike traditional Linux distributions, Talos does not have: + +* An interactive shell (SSH) +* A package manager +* A mutable user space +* Common Linux utilities by default + +Instead, all node inspection and management is performed through the Talos API using the talosctl CLI. This design allows Talos to remain immutable and consistently managed while still exposing the information required for day-to-day operations. + +For Linux administrators, this means familiar actions still exist conceptually, but they are accessed through API calls rather than local commands. + +## Things to note that you will use constantly + +In addition to learning the Talos command equivalents, there are a few concepts you’ll rely on frequently. + +* **Maintenance node**: When a node is in maintenance mode, meaning it has booted but has not yet received a machine configuration, commands must be run with the `--insecure` flag. Not all commands are available in this mode. Refer to [the --insecure flag documentation](../configure-your-talos-cluster/system-configuration/insecure) to understand which operations are supported and how to use them safely. +* **Discoverability**: To see all available resource definitions exposed by Talos, run: + + ```bash + talosctl get resourcedefinitions --nodes + ``` + +Here are some familiar Linux commands and its Talos equivalent. + +## Orientation and discovery + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux habit****Talos command****Notes**
Check kube context`talosctl config info`Shows active endpoints and context
"What objects exist?"`talosctl get rd`Lists all available Talos resources
node name`talosctl get nodename`Displays the name of the specified node
hostname`talosctl get hostname`Displays the hostname of the node
`kubectl get nodes``talosctl get members`Lists all cluster members
+ +## Files and filesystem + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ls``talosctl list`Lists exposed filesystem paths only
`cat``talosctl read`Read-only file access
`mount``talosctl mounts`, `talosctl get mounts`, and `talosctl get volumestatus`Shows mounted filesystems
+ +Talos has no interactive shell and no writable filesystem + +## Disks and storage + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`lsblk``talosctl get disks`High-level disk inventory
`lspci``talosctl get pcidevices`PCI device discovery
Volume discovery`talosctl get discoveredvolume`Used during installation / bootstrap
Disk usage`talosctl usage`Filesystem-level visibility
+ +## Hardware and system info + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`lscpu``talosctl get cpu`CPU topology and features
`free``talosctl memory`Memory usage summary
`dmidecode``talosctl get systeminformation`Vendor, model, UUID, firmware
`lsmod``talosctl get loadedkernelmodules`Loaded kernel modules
`modprobe``talosctl patch mc`Needs to be done from a configuration patch
+ +## Processes and services + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ps``talosctl processes`Shows running processes
`top`, `htop``talosctl dashboard`Live streaming view
`systemctl status``talosctl services`Talos services, not systemd
`systemctl restart``talosctl service restart [service]`Restart OS services
`docker stats``talosctl stats`Container runtime statistics
+ +Talos does not use systemd, services are Talos-native + +## Networking + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`ip addr``talosctl get addresses | links`Interface IP addresses
`ip route``talosctl get routes`Routing table
`ethtool``talosctl get linkstatuses` and `talosctl get ethernetstatuses`Link state and speed
`netstat`, `ss``talosctl netstat`Socket inspection
`tcpdump``talosctl pcap`Packet capture (stream or file)
+ +## Logs and events + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`journalctl -u ``talosctl logs `Service logs
`journalctl -f``talosctl logs -f `Follow logs
`dmesg``talosctl dmesg` or `talosctl logs kernel`Kernel ring buffer
+ +## Additional commands + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Linux command****Talos command****Notes**
`do-release-upgrade``talosctl upgrade`Upgrade talos
`talosctl wipe`Erase a drive or partition
`poweroff``talosctl shutdown` and `talosctl reboot`Shut down node
`docker pull``talosctl image pull`Pull a container image
`docker images``talosctl image list`Lists all available images
`scp``talosctl copy`Copy files from nodes
diff --git a/talos-v1.11.yaml b/talos-v1.11.yaml index 085cb0b8..5ec96a1d 100644 --- a/talos-v1.11.yaml +++ b/talos-v1.11.yaml @@ -253,5 +253,6 @@ navigation: - "networking-resources.mdx" - "philosophy.mdx" - "process-capabilities.mdx" + - "talos-for-linux-admins.mdx" - "talos-network-connectivity.mdx" - "talosctl.mdx" diff --git a/talos-v1.12.yaml b/talos-v1.12.yaml index 27c6f2b2..0aa3575d 100644 --- a/talos-v1.12.yaml +++ b/talos-v1.12.yaml @@ -295,6 +295,7 @@ navigation: - "networking-resources.mdx" - "philosophy.mdx" - "process-capabilities.mdx" + - "talos-for-linux-admins.mdx" - "talos-network-connectivity.mdx" - "talos-platform-configuration.mdx" - "talosctl.mdx"