Bootstrap a Talos Linux cluster for Cozystack using Talm
Talm is a Helm-like utility for declarative configuration management of Talos Linux.
It was created by Ænix to allow more declarative and custom configurations for cluster management.
Talm comes with pre-built presets for Cozystack.
Initialize the new project:
mkdir -p cluster1
cd cluster1
talm init --preset cozystack
The structure of the project mostly mirrors an ordinary Helm chart:
charts- a directory that includes a common library chart with functions used for querying information from Talos Linux.Chart.yaml- a file containing the common information about your project; the name of the chart is used as the name for the newly created cluster.templates- a directory used to describe templates for the configuration generation.secrets.yaml- a file containing secrets for your cluster.values.yaml- a common values file used to provide parameters for the templating.nodes- an optional directory used to describe and store generated configuration for nodes.
You’re free to edit the files: Chart.yaml, values.yaml, and templates/* to meet your environment requirements.
Be aware that your nodes are booted Talos Linux image and awaiting in maintenance mode
If you are using DHCP, you might not be aware of the IP addresses assigned to your nodes.
You can use nmap to find them all:
nmap -Pn -n -p 50000 192.168.100.0/24 -vv | grep 'Discovered'
Where 192.168.100.0/24 is your network.
Example output:
Discovered open port 50000/tcp on 192.168.100.63
Discovered open port 50000/tcp on 192.168.100.159
Discovered open port 50000/tcp on 192.168.100.192
Now, create a nodes directory and collect the information from your node into a specific file:
talm template -e 192.168.100.63 -n 192.168.100.63 -t templates/controlplane.yaml -i > nodes/srv1.yaml
Where 192.168.100.63 is the IP address of your node.
Check the generated file, and if everything is okay, apply it:
talm apply -f nodes/srv1.yaml -i
In future operations, you can also use the following options:
--dry-run- dry run mode will show a diff with the existing configuration.-m try- try mode will rollback the configuration in 1 minute.
talm bootstrap -f nodes/srv1.yaml
To access the cluster, generate an admin kubeconfig:
talm kubeconfig kubeconfig -f nodes/srv1.yaml
export KUBECONFIG=$PWD/kubeconfig
Now follow Get Started guide starting from the Install Cozystack section, to continue the installation.