Cluster API (core)¶
Couche : Cluster Kubernetes · Où : pods du cluster pad-prod (auto-hébergé) ; kind pendant le bootstrap · Version : v1.14.3 (contrat v1beta2)
À quoi elle sert ici et pourquoi ce choix¶
Le cluster pad-prod est décrit par des objets Kubernetes (Cluster, TalosControlPlane, MachineDeployment...) et Cluster API crée, met à jour et
détruit ses VM. Il est auto-hébergé : après un pivot, ses controllers tournent dans pad-prod lui-même, il n'y a pas de cluster de gestion permanent
(environ 6 Go de RAM économisés). Décision : ADR 5.
Où elle tourne et comment elle est déployée¶
Au bootstrap, clusterctl init dans un cluster kind éphémère installe les providers, puis clusterctl move pivote vers pad-prod. Ensuite, ArgoCD adopte
les providers à partir de manifestes rendus et commités (gitops/platform/capi-providers, sync-wave -4) et l'Application cluster-prod (vague 5) gère les objets du cluster lui-même.
Version épinglée¶
kubernetes.capi.core: v1.14.3 dans infra/contracts.yaml. Rendu des manifestes : task bootstrap:render-providers
(gitops/platform/capi-providers/manifests/core-cluster-api.yaml). URL de release : bootstrap/clusterctl.yaml.
Fichiers de configuration dans le dépôt¶
gitops/clusters/prod/:cluster.yaml,control-plane.yaml,pool-platform.yaml,pool-challenges.yaml,namespace.yaml.gitops/platform/capi-providers/(application.yaml,manifests/,README.md).bootstrap/scripts/cluster.sh,capi-common.sh,render-providers.sh,destroy.sh.
Interactions avec les autres briques¶
Providers associés : CAPMOX (infrastructure Proxmox), CABPT/CACPPT (bootstrap et control plane Talos), IPAM in-cluster.
Le cluster-autoscaler pilote la taille du MachineDeployment challenges.
Sécurité¶
- Le Secret
capmox-manager-credentials(jeton Proxmox) est créé au bootstrap depuis SOPS, jamais dans Git ni pruné par ArgoCD. - Garde-fous GitOps : pas de prune ni de finalizer sur l'Application des providers,
Delete=falsesur les CRD et sur leCluster.
Supervision¶
Objets Machine et Cluster observés par kube-state-metrics ; alertes KubeNodeNotReady, ClusterAutoscaler* : Autoscaling, Nœuds.
Opérations courantes¶
kubectl -n pad-cluster get cluster,machines,machinedeployments
clusterctl describe cluster pad-prod -n pad-cluster
task bootstrap:render-providers # après un changement de version dans le contrat
Pièges connus¶
- Le
ClusterporteDelete=false,Prune=false: supprimer l'Application ArgoCD ne détruit pas les VM ; la destruction passe partask bootstrap:destroy. - L'Application
cluster-prodignorereplicasdu poolchallenges(piloté par l'autoscaler). - Rotation du jeton Proxmox : modifier le Secret à la main, puis redémarrer
capmox-controller-manager. - Réseau des workers : chaque pool de workers est une zone CAPMOX (
ProxmoxCluster.spec.zoneConfig+network.zonedu template), jamais unipPoolRefsurnet0: CAPMOX forcedefaultIPv4: truesurnet0et ajouterait une IP du control plane, d'où deux routes par défaut (route already exists for destination/metric). Détails, cause et réparation : CAPMOX, pièges connus. - Templates d'infrastructure immuables : modifier un
ProxmoxMachineTemplateappliqué impose de le supprimer puis de le recréer (ou de le renommer) ; lesMachineexistantes ne sont pas modifiées, seules les nouvelles utilisent le nouveau template.
Documentation officielle¶
Retour à l'index des composants
- Modèles immuables :
ProxmoxMachineTemplateetTalosConfigTemplaterefusent toute modification (« Spec is immutable »). Pour changer la configuration des nœuds d'un pool, créer un modèle sous un nouveau nom et y faire pointer leMachineDeployment(déploiement progressif), ou, au bootstrap, supprimerMachineDeploymentet modèles puis réappliquergitops/clusters/prod. - Heure des nœuds CHALLENGES : sans egress Internet, ils se synchronisent sur OPNsense (
machine.time.servers: [<passerelle de la zone>], règlem10-chall-ntp). Symptôme sinon :talosctl service kubeletreste enWaiting for time sync.