Aller au contenu

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.