Talos Linux¶
Couche : Cluster Kubernetes · Où : VM Proxmox (control plane en zone PROD, workers PROD et CHALLENGES) · Version : v1.11.6 (Kubernetes v1.34.1)
À quoi elle sert ici et pourquoi ce choix¶
Talos n'a ni SSH, ni shell, ni gestionnaire de paquets : tout passe par son API (talosctl). La surface d'attaque est minimale et la
configuration des nœuds est du code, ce qui convient à un cluster jetable. Les nœuds sont créés à partir d'un template construit avec un
schematic Image Factory contenant uniquement qemu-guest-agent. Décision : ADR 4.
Où elle tourne et comment elle est déployée¶
La stack tofu 15-talos-image télécharge l'image Talos (provider siderolabs/talos) et crée la VM template sur Proxmox. Ensuite
Cluster API la clone pour chaque nœud ; la configuration machine est générée par CABPT/CACPPT et passée en
cloud-init (datasource nocloud). Le control plane expose une VIP (10.20.60.5) et le kubeconfig/talosconfig sont extraits dans .state/.
Version épinglée¶
| Élément | Valeur | Où |
|---|---|---|
| Talos | v1.11.6 | infra/contracts.yaml (kubernetes.talos_version) |
| Kubernetes | v1.34.1 | kubernetes.kubernetes_version |
| schematic Image Factory | ce4c9805...c7515 |
kubernetes.talos_schematic_id |
| image d'installation | factory.talos.dev/nocloud-installer/<schematic>:v1.11.6 |
kubernetes.talos_installer_image |
| provider tofu | siderolabs/talos 0.12.0 |
infra/tofu/stacks/15-talos-image/versions.tf |
Fichiers de configuration dans le dépôt¶
infra/tofu/modules/talos-image/etinfra/tofu/stacks/15-talos-image/(schematic, téléchargement, VM template).gitops/clusters/prod/control-plane.yaml(patch de configuration : VIP, kubelet,cni: none,proxy.disabled, KubePrism, certificats serveur du kubelet).gitops/clusters/prod/pool-platform.yamletpool-challenges.yaml(workers).bootstrap/scripts/kubeconfig.sh: extraction du kubeconfig et du talosconfig.
Interactions avec les autres briques¶
- Créé par CAPMOX sur Proxmox ; reçoit sa config de CABPT/CACPPT.
- Sans CNI ni kube-proxy : Cilium les remplace (KubePrism sur le port 7445).
- Les flux d'administration (API Talos 50000, trustd 50001) viennent du bastion (matrice).
Sécurité¶
- Pas de SSH ni de shell ; API Talos accessible uniquement depuis le bastion.
allowSchedulingOnControlPlanes: false: le control plane ne porte aucune charge.- Certificats serveur du kubelet signés (
rotate-server-certificates) avec l'approbateurkubelet-serving-cert-approverv0.12.1. - Le pool
challengesporte le taintpad.io/pool=challenges:NoSchedule, héberge les instances de joueurs et son kubelet est borné :podPidsLimit: 256(fork bomb),maxPods: 40(remplissage du disque), feature gateUserNamespacesSupportet sysctluser.max_user_namespacespour les podshostUsers: false(valeurs du contratinstances.*). Un changement du patch ne remplace pas les machines existantes : créer un nouveauTalosConfigTemplate. - Les namespaces Cluster API (
pad-cluster, fournisseurs CAPI,csi-proxmox) sont en PSS et en NetworkPolicy default-deny.
Supervision¶
Alertes KubeNodeNotReady, KubeNodePressure : Nœuds Kubernetes. Métriques par node-exporter.
Opérations courantes¶
task bootstrap:kubeconfig # exports KUBECONFIG et TALOSCONFIG
talosctl --nodes <ip> health
talosctl --nodes <ip> dmesg | tail
Pièges connus¶
- Changer la version de Talos : modifier le contrat et rejouer
15-talos-image(nouveau template) avant de toucher aux MachineDeployments. extraManifeststélécharge deux manifestes depuis Internet au premier démarrage du control plane.- L'image d'installation doit rester cohérente avec le schematic (sinon
qemu-guest-agentdisparaît).
Documentation officielle¶
Retour à l'index des composants
Labels et taints des nœuds¶
machine.nodeLabels est appliqué par Talos après l'enregistrement du nœud (autorisé par NodeRestriction pour les préfixes
non réservés comme pad.io/). Un taint, lui, ne peut pas être modifié par le nœud après coup : il se déclare à
l'enregistrement du kubelet (kubelet.extraArgs.register-with-taints, pool challenges). Avec machine.nodeTaints, l'appel
de Talos était refusé (« node ... is not allowed to modify taints ») et emportait les labels avec lui.
Redémarrage des nœuds et configuration réseau¶
CAPMOX (v0.9.x) éjecte puis supprime l'ISO cloud-init (nocloud, qui porte l'IP statique du nœud) dès que la Machine est disponible ; aucun réglage ne la conserve. Au redémarrage, Talos réutilise la configuration réseau mise en cache dans la partition STATE au premier démarrage. Talos v1.11.3 écrase ce cache par une configuration vide quand l'ISO est absente (régression siderolabs/talos#12097, corrigée en v1.11.4) : le nœud redémarre sans IP. D'où la version minimale v1.11.6 du contrat.
Monter de version : kubernetes.talos_version et talos_installer_image dans le contrat, tofu stack 15-talos-image
(template), puis nouveaux noms de TalosConfigTemplate (immuables) ; les nœuds existants passent par
talosctl upgrade --image <talos_installer_image> un par un, avant tout redémarrage.
Nœud déjà redémarré sans IP (cache vide) : recréer une ISO cidata (meta-data, network-config v2 avec son IP, user-data
#cloud-config vide, la machine config étant persistée dans STATE), l'attacher en ide2 (CAPMOX nettoie ide0),
redémarrer, puis talosctl upgrade. Ou supprimer la Machine pour que CAPI la recrée (perte de l'etcd si c'est l'unique
control plane).