Bootstrap du cluster¶
Le cluster pad-prod est géré par Cluster API (CAPI) depuis lui-même : il n'y a pas de cluster de gestion
permanent. Un cluster kind éphémère sert uniquement à le créer, puis lui transmet la gestion (pivot) et disparaît.
Cela économise environ 6 Go de RAM en régime établi.
flowchart TD
A[task bootstrap:cluster] --> B[kind éphémère sur le poste opérateur]
B --> C[clusterctl init : CAPI, CAPMOX, CABPT, CACPPT, IPAM]
C --> D[kubectl apply gitops/clusters/prod<br/>Cluster, TalosControlPlane, pool platform<br/>hors pool challenges]
D --> E[CAPMOX clone le template Talos<br/>et démarre les VM via l'API Proxmox]
E --> F[Cluster Provisioned, kubeconfig et talosconfig extraits]
F --> G[CRD Prometheus, cert-manager, Cilium et CCM Proxmox installés<br/>nœuds Ready et initialisés]
G --> H[clusterctl move : kind vers pad-prod]
H --> I[Vérification : Cluster et Machines présents dans pad-prod]
I --> J[kind supprimé]
J --> K[task bootstrap:gitops]
K --> L[ArgoCD via Helm]
L --> M[Secret sops-age, Secret repo]
M --> N[Application root]
N --> O[ArgoCD synchronise la plateforme<br/>puis les applications<br/>puis le cluster-prod lui-même]
Étapes détaillées¶
| Étape | Script | Ce qui se passe | Reprise |
|---|---|---|---|
| 1. kind | bootstrap/scripts/cluster.sh |
cluster kind (version épinglée par digest), clusterctl init avec les providers du contrat |
saute si le pivot est fait |
| 2. manifests | idem | kubectl apply --server-side du rendu de gitops/clusters/prod, sans les objets annotés pad.io/bootstrap: gitops (pool challenges) : sans egress Internet, ses workers tirent leurs images du miroir Zot, créé en phase 10 ; une Machine sans nodeRef bloquerait clusterctl move |
rejouable |
| 3. attente | idem | Cluster Provisioned, control plane prêt (30 min max) |
rejouable |
| 4. accès | idem | extraction du kubeconfig et du talosconfig dans .state/ |
|
| 5. CNI | idem | CRD Prometheus (prometheus-operator-crds : les values des charts déclarent des ServiceMonitor), puis cert-manager (sans le hook startupapicheck, qui ne peut pas tourner avant le CNI) et Cilium (sans kube-proxy), installés par Helm avec les mêmes versions que les Applications ArgoCD ; puis le cloud controller manager Proxmox : Secret proxmox-csi-config déchiffré par sops depuis gitops/platform/proxmox-csi/secret.sops.yaml et appliqué par un pipe (ksops n'existe pas encore ; jamais en clair sur disque), chart installé dans csi-proxmox ; il pose le providerID proxmox://<uuid> (CAPMOX) et retire le taint node.cloudprovider.kubernetes.io/uninitialized (kubelets en cloud-provider: external), sans quoi rien d'autre ne se planifie ; attente des nœuds Ready, des nœuds initialisés et de cert-manager |
rejouable |
| 6. pivot | idem | clusterctl move vers pad-prod, puis contrôle que le Cluster et les Machine y sont |
kind conservé si le contrôle échoue |
| 7. ArgoCD | bootstrap/scripts/gitops.sh |
helm upgrade --install argo-cd, Secret sops-age (clé du cluster), Secret du dépôt, Application root |
idempotent |
Après le pivot : ArgoCD gère tout¶
L'Application root synchronise gitops/platform ; l'ApplicationSet apps crée une Application par dossier de
gitops/apps/*. L'ordre d'installation est porté par les sync-wave :
| Vague | Composants |
|---|---|
| -10 | namespaces, CRD Prometheus |
| -9 | Cilium |
| -8 | Proxmox CCM (initialisation des nœuds ; lit le Secret du CSI) |
| -7 / -6 | cert-manager / Kyverno |
| -5 | ArgoCD (auto-géré), Proxmox CSI, CRD mariadb-operator |
| -4 | mariadb-operator, politiques Kyverno, providers CAPI |
| -3 | Traefik, KEDA, cluster-autoscaler, external-dns |
| -2 | Valkey, Garage, Zot |
| -1 | Alloy, kube-state-metrics, node-exporter |
| 5 | cluster-prod : les manifestes CAPI eux-mêmes, désormais sous ArgoCD ; crée le pool challenges (après Zot) |
| 10 | applications : CTFd, front, chall-manager, netbird-sync |
Les secrets sont à la vague -8 (voir Chaîne des secrets).
Pas de kubectl apply hors bootstrap/
Après le bootstrap, plus rien n'est appliqué à la main. Pour changer le cluster, on modifie gitops/ et on
pousse. Le cluster se met à jour ensuite via ArgoCD, y compris ses propres MachineDeployments.
Destruction¶
task bootstrap:destroy fait le chemin inverse : pivot inverse vers un kind frais, suppression du Cluster (CAPI
détruit les VM), avec repli sur l'API Proxmox (confirmation requise) si CAPI ne peut plus agir. Voir
destroy.