mirror of
https://github.com/siderolabs/talos.git
synced 2025-12-08 19:11:54 +01:00
docs: add Radxa ROCK 5B docs to Single Board Computer section
This adds documentation on how to setup a ROCK 5B with Talos initially and it adds the SBC to the support matrix. It also fixes a typo of an unreferenced link alias and spelling of ROCK 4C+ to align with existing documentations and manufacturers name. Signed-off-by: Christoph Hoopmann <choopm@0pointer.org> Signed-off-by: Noel Georgi <git@frezbo.dev>
This commit is contained in:
Christoph Hoopmann
Noel Georgi
parent
b21bdc5e50
commit
cf45f4764d
@ -4,26 +4,26 @@ weight: 60
|
|||||||
description: "Table of supported Talos Linux versions and respective platforms."
|
description: "Table of supported Talos Linux versions and respective platforms."
|
||||||
---
|
---
|
||||||
|
|
||||||
| Talos Version | 1.10 | 1.9 |
|
| Talos Version | 1.10 | 1.9 |
|
||||||
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||||
| Release Date | 2024-04-15 (TBD) | 2024-12-17 (1.9.0) |
|
| Release Date | 2024-04-15 (TBD) | 2024-12-17 (1.9.0) |
|
||||||
| End of Community Support | 1.11.0 release (2025-08-15, TBD) | 1.10.0 release (2024-04-15, TBD) |
|
| End of Community Support | 1.11.0 release (2025-08-15, TBD) | 1.10.0 release (2024-04-15, TBD) |
|
||||||
| Enterprise Support | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/) | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/) |
|
| Enterprise Support | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/) | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/) |
|
||||||
| Kubernetes | 1.33, 1.32, 1.31, 1.30, 1.29, 1.28 | 1.32, 1.31, 1.30, 1.29, 1.28, 1.27 |
|
| Kubernetes | 1.33, 1.32, 1.31, 1.30, 1.29, 1.28 | 1.32, 1.31, 1.30, 1.29, 1.28, 1.27 |
|
||||||
| NVIDIA Drivers | 550.x.x (PRODUCTION), 535.x.x (LTS) | 550.x.x (PRODUCTION), 535.x.x (LTS) |
|
| NVIDIA Drivers | 550.x.x (PRODUCTION), 535.x.x (LTS) | 550.x.x (PRODUCTION), 535.x.x (LTS) |
|
||||||
| Architecture | amd64, arm64 | amd64, arm64 |
|
| Architecture | amd64, arm64 | amd64, arm64 |
|
||||||
| **Platforms** | | |
|
| **Platforms** | | |
|
||||||
| - cloud | Akamai, AWS, GCP, Azure, CloudStack, Digital Ocean, Exoscale, Hetzner, OpenNebula, OpenStack, Oracle Cloud, Scaleway, Vultr, Upcloud | Akamai, AWS, GCP, Azure, CloudStack, Digital Ocean, Exoscale, Hetzner, OpenNebula, OpenStack, Oracle Cloud, Scaleway, Vultr, Upcloud |
|
| - cloud | Akamai, AWS, GCP, Azure, CloudStack, Digital Ocean, Exoscale, Hetzner, OpenNebula, OpenStack, Oracle Cloud, Scaleway, Vultr, Upcloud | Akamai, AWS, GCP, Azure, CloudStack, Digital Ocean, Exoscale, Hetzner, OpenNebula, OpenStack, Oracle Cloud, Scaleway, Vultr, Upcloud |
|
||||||
| - bare metal | x86: BIOS, UEFI, SecureBoot; arm64: UEFI, SecureBoot; boot: ISO, PXE, disk image | x86: BIOS, UEFI; arm64: UEFI; boot: ISO, PXE, disk image |
|
| - bare metal | x86: BIOS, UEFI, SecureBoot; arm64: UEFI, SecureBoot; boot: ISO, PXE, disk image | x86: BIOS, UEFI; arm64: UEFI; boot: ISO, PXE, disk image |
|
||||||
| - virtualized | VMware, Hyper-V, KVM, Proxmox, Xen | VMware, Hyper-V, KVM, Proxmox, Xen |
|
| - virtualized | VMware, Hyper-V, KVM, Proxmox, Xen | VMware, Hyper-V, KVM, Proxmox, Xen |
|
||||||
| - SBCs | Banana Pi M64, Jetson Nano, Libre Computer Board ALL-H3-CC, Nano Pi R4S, Pine64, Pine64 Rock64, Radxa ROCK Pi 4c, Radxa Rock4c+, Raspberry Pi 4B, Raspberry Pi Compute Module 4, Turing RK1 | Banana Pi M64, Jetson Nano, Libre Computer Board ALL-H3-CC, Nano Pi R4S, Orange Pi R1 Plus LTS, Pine64, Pine64 Rock64, Radxa ROCK Pi 4c, Raspberry Pi 4B, Raspberry Pi Compute Module 4, Turing RK1 |
|
| - SBCs | Banana Pi M64, Jetson Nano, Libre Computer Board ALL-H3-CC, Nano Pi R4S, Pine64, Pine64 Rock64, Radxa ROCK Pi 4C, Radxa ROCK 4C+, Radxa ROCK 5B, Raspberry Pi 4B, Raspberry Pi Compute Module 4, Turing RK1 | Banana Pi M64, Jetson Nano, Libre Computer Board ALL-H3-CC, Nano Pi R4S, Orange Pi R1 Plus LTS, Pine64, Pine64 Rock64, Radxa ROCK Pi 4C, Radxa ROCK 4C+, Radxa ROCK 5B, Raspberry Pi 4B, Raspberry Pi Compute Module 4, Turing RK1 |
|
||||||
| - local | Docker, QEMU | Docker, QEMU |
|
| - local | Docker, QEMU | Docker, QEMU |
|
||||||
| **Omni** | | |
|
| **Omni** | | |
|
||||||
| [Omni](https://github.com/siderolabs/omni) | >= 0.45.0 | >= 0.45.0 |
|
| [Omni](https://github.com/siderolabs/omni) | >= 0.45.0 | >= 0.45.0 |
|
||||||
| **Cluster API** | | |
|
| **Cluster API** | | |
|
||||||
| [CAPI Bootstrap Provider Talos](https://github.com/siderolabs/cluster-api-bootstrap-provider-talos) | >= 0.6.7 | >= 0.6.7 |
|
| [CAPI Bootstrap Provider Talos](https://github.com/siderolabs/cluster-api-bootstrap-provider-talos) | >= 0.6.7 | >= 0.6.7 |
|
||||||
| [CAPI Control Plane Provider Talos](https://github.com/siderolabs/cluster-api-control-plane-provider-talos) | >= 0.5.8 | >= 0.5.8 |
|
| [CAPI Control Plane Provider Talos](https://github.com/siderolabs/cluster-api-control-plane-provider-talos) | >= 0.5.8 | >= 0.5.8 |
|
||||||
| [Sidero](https://www.sidero.dev/) | >= 0.6.5 | >= 0.6.5 |
|
| [Sidero](https://www.sidero.dev/) | >= 0.6.5 | >= 0.6.5 |
|
||||||
|
|
||||||
## Platform Tiers
|
## Platform Tiers
|
||||||
|
|
||||||
|
|||||||
@ -1,6 +1,8 @@
|
|||||||
---
|
---
|
||||||
title: "Disk Management"
|
title: "Disk Management"
|
||||||
description: "Guide on managing disks"
|
description: "Guide on managing disks"
|
||||||
|
aliases:
|
||||||
|
- ../../guides/disk-management
|
||||||
---
|
---
|
||||||
|
|
||||||
Talos Linux version 1.8.0 introduces a new backend for managing system and user disks.
|
Talos Linux version 1.8.0 introduces a new backend for managing system and user disks.
|
||||||
|
|||||||
@ -2,7 +2,7 @@
|
|||||||
title: "Logging"
|
title: "Logging"
|
||||||
description: "Dealing with Talos Linux logs."
|
description: "Dealing with Talos Linux logs."
|
||||||
aliases:
|
aliases:
|
||||||
- ../../guiides/logging
|
- ../../guides/logging
|
||||||
---
|
---
|
||||||
|
|
||||||
## Viewing logs
|
## Viewing logs
|
||||||
|
|||||||
@ -0,0 +1,72 @@
|
|||||||
|
---
|
||||||
|
title: "Radxa ROCK 5B"
|
||||||
|
description: "Installing Talos on Radxa ROCK 5B SBC using raw disk image."
|
||||||
|
aliases:
|
||||||
|
- ../../../single-board-computers/rock5b
|
||||||
|
---
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
You will need
|
||||||
|
|
||||||
|
- follow [Installation/talosctl]({{< relref "../talosctl">}}) to intall `talosctl`
|
||||||
|
- an SD card
|
||||||
|
|
||||||
|
## Download the Image
|
||||||
|
|
||||||
|
Visit the [Image Factory](https://factory.talos.dev/), select `Single Board Computers`, select the version and select `Radxa ROCK 5B` from the options.
|
||||||
|
|
||||||
|
Choose `realtek-firmware` and any other desired extension.
|
||||||
|
Next fill in the kernel command line arguments if needed.
|
||||||
|
|
||||||
|
Download the image and decompress it:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -LO https://factory.talos.dev/image/[uuid]/{{< release >}}/metal-arm64.raw.xz
|
||||||
|
xz -d metal-arm64.raw.xz
|
||||||
|
```
|
||||||
|
|
||||||
|
## Writing the Image
|
||||||
|
|
||||||
|
This guide assumes the node should boot from SD card.
|
||||||
|
Booting from eMMC or NVMe has not been tested yet.
|
||||||
|
|
||||||
|
The path to your SD card can be found using `fdisk` on Linux or `diskutil` on macOS.
|
||||||
|
In this example, we will assume `/dev/mmcblk0`.
|
||||||
|
|
||||||
|
Now `dd` the image to your SD card:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo dd if=metal-arm64.raw of=/dev/mmcblk0 conv=fsync oflag=direct status=progress bs=4M
|
||||||
|
```
|
||||||
|
|
||||||
|
## First boot
|
||||||
|
|
||||||
|
Insert the SD card into the board, turn it on and proceed by following the
|
||||||
|
[getting started guide]({{< relref "../../../introduction/getting-started/#configure-talos-linux" >}})
|
||||||
|
for further steps on how to configure Talos.
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Serial console
|
||||||
|
|
||||||
|
If you experience any issues you can check the serial console.
|
||||||
|
Follow the [official guideline](https://wiki.radxa.com/Rock5/dev/serial-console)
|
||||||
|
on how to connect a serial adapter.
|
||||||
|
|
||||||
|
Hint: The rock5b overlay uses baudrate of `115200` instead of the default `1500000`
|
||||||
|
|
||||||
|
### Power supplies and endless restarts
|
||||||
|
|
||||||
|
It is a known issue that USB Power Delivery negotiation is performed at a late stage in kernel.
|
||||||
|
This can lead to endless restarts if the power supply cuts power to early.
|
||||||
|
Check the list of [known working](https://wiki.radxa.com/Rock5/5b/power_supply) power supplies.
|
||||||
|
|
||||||
|
## Tips and tricks
|
||||||
|
|
||||||
|
### EPHEMERAL on NVMe
|
||||||
|
|
||||||
|
The Radxa ROCK 5B SBC provides a M.2 NVMe SSD slot.
|
||||||
|
|
||||||
|
This allows to use a separate disk for the EPHEMERAL partition by following
|
||||||
|
[Disk Management]({{< relref "../../configuration/disk-management" >}}).
|
||||||
@ -4,26 +4,26 @@ weight: 60
|
|||||||
description: "Table of supported Talos Linux versions and respective platforms."
|
description: "Table of supported Talos Linux versions and respective platforms."
|
||||||
---
|
---
|
||||||
|
|
||||||
| Talos Version | 1.9 | 1.8 |
|
| Talos Version | 1.9 | 1.8 |
|
||||||
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||||
| Release Date | 2024-12-17 | 2024-09-23 (1.8.0) |
|
| Release Date | 2024-12-17 | 2024-09-23 (1.8.0) |
|
||||||
| End of Community Support | 1.10.0 release (2025-04-15, TBD) | 1.9.0 release (2024-12-17) |
|
| End of Community Support | 1.10.0 release (2025-04-15, TBD) | 1.9.0 release (2024-12-17) |
|
||||||
| Enterprise Support | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/) | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/) |
|
| Enterprise Support | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/) | [offered by Sidero Labs Inc.](https://www.siderolabs.com/support/) |
|
||||||
| Kubernetes | 1.32, 1.31, 1.30, 1.29, 1.28, 1.27 | 1.31, 1.30, 1.29, 1.28, 1.27, 1.26 |
|
| Kubernetes | 1.32, 1.31, 1.30, 1.29, 1.28, 1.27 | 1.31, 1.30, 1.29, 1.28, 1.27, 1.26 |
|
||||||
| NVIDIA Drivers | 550.x.x (PRODUCTION), 535.x.x (LTS) | 550.x.x (PRODUCTION), 535.x.x (LTS) |
|
| NVIDIA Drivers | 550.x.x (PRODUCTION), 535.x.x (LTS) | 550.x.x (PRODUCTION), 535.x.x (LTS) |
|
||||||
| Architecture | amd64, arm64 | amd64, arm64 |
|
| Architecture | amd64, arm64 | amd64, arm64 |
|
||||||
| **Platforms** | | |
|
| **Platforms** | | |
|
||||||
| - cloud | Akamai, AWS, GCP, Azure, CloudStack, Digital Ocean, Exoscale, Hetzner, OpenNebula, OpenStack, Oracle Cloud, Scaleway, Vultr, Upcloud | Akamai, AWS, GCP, Azure, CloudStack, Digital Ocean, Exoscale, Hetzner, OpenNebula, OpenStack, Oracle Cloud, Scaleway, Vultr, Upcloud |
|
| - cloud | Akamai, AWS, GCP, Azure, CloudStack, Digital Ocean, Exoscale, Hetzner, OpenNebula, OpenStack, Oracle Cloud, Scaleway, Vultr, Upcloud | Akamai, AWS, GCP, Azure, CloudStack, Digital Ocean, Exoscale, Hetzner, OpenNebula, OpenStack, Oracle Cloud, Scaleway, Vultr, Upcloud |
|
||||||
| - bare metal | x86: BIOS, UEFI, SecureBoot; arm64: UEFI, SecureBoot; boot: ISO, PXE, disk image | x86: BIOS, UEFI; arm64: UEFI; boot: ISO, PXE, disk image |
|
| - bare metal | x86: BIOS, UEFI, SecureBoot; arm64: UEFI, SecureBoot; boot: ISO, PXE, disk image | x86: BIOS, UEFI; arm64: UEFI; boot: ISO, PXE, disk image |
|
||||||
| - virtualized | VMware, Hyper-V, KVM, Proxmox, Xen | VMware, Hyper-V, KVM, Proxmox, Xen |
|
| - virtualized | VMware, Hyper-V, KVM, Proxmox, Xen | VMware, Hyper-V, KVM, Proxmox, Xen |
|
||||||
| - SBCs | Banana Pi M64, Jetson Nano, Libre Computer Board ALL-H3-CC, Nano Pi R4S, Pine64, Pine64 Rock64, Radxa ROCK Pi 4c, Radxa Rock4c+, Raspberry Pi 4B, Raspberry Pi Compute Module 4, Turing RK1 | Banana Pi M64, Jetson Nano, Libre Computer Board ALL-H3-CC, Nano Pi R4S, Orange Pi R1 Plus LTS, Pine64, Pine64 Rock64, Radxa ROCK Pi 4c, Raspberry Pi 4B, Raspberry Pi Compute Module 4 |
|
| - SBCs | Banana Pi M64, Jetson Nano, Libre Computer Board ALL-H3-CC, Nano Pi R4S, Pine64, Pine64 Rock64, Radxa ROCK Pi 4C, Radxa ROCK 4C+, Radxa ROCK 5B, Raspberry Pi 4B, Raspberry Pi Compute Module 4, Turing RK1 | Banana Pi M64, Jetson Nano, Libre Computer Board ALL-H3-CC, Nano Pi R4S, Orange Pi R1 Plus LTS, Pine64, Pine64 Rock64, Radxa ROCK Pi 4C, Raspberry Pi 4B, Raspberry Pi Compute Module 4 |
|
||||||
| - local | Docker, QEMU | Docker, QEMU |
|
| - local | Docker, QEMU | Docker, QEMU |
|
||||||
| **Omni** | | |
|
| **Omni** | | |
|
||||||
| [Omni](https://github.com/siderolabs/omni) | >= 0.45.0 | >= 0.43.0 |
|
| [Omni](https://github.com/siderolabs/omni) | >= 0.45.0 | >= 0.43.0 |
|
||||||
| **Cluster API** | | |
|
| **Cluster API** | | |
|
||||||
| [CAPI Bootstrap Provider Talos](https://github.com/siderolabs/cluster-api-bootstrap-provider-talos) | >= 0.6.7 | >= 0.6.6 |
|
| [CAPI Bootstrap Provider Talos](https://github.com/siderolabs/cluster-api-bootstrap-provider-talos) | >= 0.6.7 | >= 0.6.6 |
|
||||||
| [CAPI Control Plane Provider Talos](https://github.com/siderolabs/cluster-api-control-plane-provider-talos) | >= 0.5.8 | >= 0.5.7 |
|
| [CAPI Control Plane Provider Talos](https://github.com/siderolabs/cluster-api-control-plane-provider-talos) | >= 0.5.8 | >= 0.5.7 |
|
||||||
| [Sidero](https://www.sidero.dev/) | >= 0.6.5 | >= 0.6.5 |
|
| [Sidero](https://www.sidero.dev/) | >= 0.6.5 | >= 0.6.5 |
|
||||||
|
|
||||||
## Platform Tiers
|
## Platform Tiers
|
||||||
|
|
||||||
|
|||||||
@ -1,6 +1,8 @@
|
|||||||
---
|
---
|
||||||
title: "Disk Management"
|
title: "Disk Management"
|
||||||
description: "Guide on managing disks"
|
description: "Guide on managing disks"
|
||||||
|
aliases:
|
||||||
|
- ../../guides/disk-management
|
||||||
---
|
---
|
||||||
|
|
||||||
Talos Linux version 1.8.0 introduces a new backend for managing system and user disks.
|
Talos Linux version 1.8.0 introduces a new backend for managing system and user disks.
|
||||||
|
|||||||
@ -0,0 +1,72 @@
|
|||||||
|
---
|
||||||
|
title: "Radxa ROCK 5B"
|
||||||
|
description: "Installing Talos on Radxa ROCK 5B SBC using raw disk image."
|
||||||
|
aliases:
|
||||||
|
- ../../../single-board-computers/rock5b
|
||||||
|
---
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
You will need
|
||||||
|
|
||||||
|
- follow [Installation/talosctl]({{< relref "../talosctl">}}) to intall `talosctl`
|
||||||
|
- an SD card
|
||||||
|
|
||||||
|
## Download the Image
|
||||||
|
|
||||||
|
Visit the [Image Factory](https://factory.talos.dev/), select `Single Board Computers`, select the version and select `Radxa ROCK 5B` from the options.
|
||||||
|
|
||||||
|
Choose `realtek-firmware` and any other desired extension.
|
||||||
|
Next fill in the kernel command line arguments if needed.
|
||||||
|
|
||||||
|
Download the image and decompress it:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -LO https://factory.talos.dev/image/[uuid]/{{< release >}}/metal-arm64.raw.xz
|
||||||
|
xz -d metal-arm64.raw.xz
|
||||||
|
```
|
||||||
|
|
||||||
|
## Writing the Image
|
||||||
|
|
||||||
|
This guide assumes the node should boot from SD card.
|
||||||
|
Booting from eMMC or NVMe has not been tested yet.
|
||||||
|
|
||||||
|
The path to your SD card can be found using `fdisk` on Linux or `diskutil` on macOS.
|
||||||
|
In this example, we will assume `/dev/mmcblk0`.
|
||||||
|
|
||||||
|
Now `dd` the image to your SD card:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo dd if=metal-arm64.raw of=/dev/mmcblk0 conv=fsync oflag=direct status=progress bs=4M
|
||||||
|
```
|
||||||
|
|
||||||
|
## First boot
|
||||||
|
|
||||||
|
Insert the SD card into the board, turn it on and proceed by following the
|
||||||
|
[getting started guide]({{< relref "../../../introduction/getting-started/#configure-talos-linux" >}})
|
||||||
|
for further steps on how to configure Talos.
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Serial console
|
||||||
|
|
||||||
|
If you experience any issues you can check the serial console.
|
||||||
|
Follow the [official guideline](https://wiki.radxa.com/Rock5/dev/serial-console)
|
||||||
|
on how to connect a serial adapter.
|
||||||
|
|
||||||
|
Hint: The rock5b overlay uses baudrate of `115200` instead of the default `1500000`
|
||||||
|
|
||||||
|
### Power supplies and endless restarts
|
||||||
|
|
||||||
|
It is a known issue that USB Power Delivery negotiation is performed at a late stage in kernel.
|
||||||
|
This can lead to endless restarts if the power supply cuts power to early.
|
||||||
|
Check the list of [known working](https://wiki.radxa.com/Rock5/5b/power_supply) power supplies.
|
||||||
|
|
||||||
|
## Tips and tricks
|
||||||
|
|
||||||
|
### EPHEMERAL on NVMe
|
||||||
|
|
||||||
|
The Radxa ROCK 5B SBC provides a M.2 NVMe SSD slot.
|
||||||
|
|
||||||
|
This allows to use a separate disk for the EPHEMERAL partition by following
|
||||||
|
[Disk Management]({{< relref "../../configuration/disk-management" >}}).
|
||||||
Loading…
x
Reference in New Issue
Block a user