Up : déployer la plateforme¶
task up enchaîne les phases 0 à 12 et est idempotent : on peut le relancer après une interruption, il reprend en rejouant chaque phase
(les étapes déjà faites ne changent rien). Chaque phase se joue aussi seule et se termine par une vérification OK/KO.
Le pas à pas complet (préparation de l'hôte, comptes, secrets, commandes, vérifications, erreurs) est dans le
Guide de déploiement ; cette page est l'aide-mémoire de reprise.
Avant de lancer¶
- [ ]
nix developactif,TF_VAR_state_passphraseexporté,SOPS_AGE_KEY_FILEdéfini. - [ ]
task phase:0-prereqssansKO(outils, secrets, accès à l'hôte, privilèges du jeton Proxmox). - [ ] Docker local démarré (cluster
kinddu bootstrap). - [ ] Clés age et phrase secrète des states sauvegardées hors machine.
Les phases¶
| Phase | Tâche | Vérification seule | Reprise |
|---|---|---|---|
| 0 | task phase:0-prereqs |
task check:0-prereqs |
lecture seule |
| 1 | task phase:1-reseau (00-host-network, ansible:host) |
task check:1-reseau |
rejouable |
| 2 | task phase:2-routeur (10-router, route de l'hôte, 60-opnsense-rules) |
task check:2-routeur |
rejouable ; import OPNsense manuel si besoin (infra/opnsense/README.md) |
| 3 | task phase:3-image-talos |
task check:3-image-talos |
rejouable |
| 4 | task phase:4-lxc |
task check:4-lxc |
rejouable |
| 5 | task phase:5-dns |
task check:5-dns |
rejouable |
| 6 | task phase:6-services-1 (monitoring, authentik, edge) |
task check:6-services-1 |
rejouable |
| 7 | task phase:7-identite (30-authentik, secrets:oidc-sync) |
task check:7-identite |
rejouable ; depuis le bastion/mgmt |
| 8 | task phase:8-services-2 (warpgate, netbird, monitoring) |
task check:8-services-2 |
rejouable |
| 9 | task phase:9-cluster |
task check:9-cluster |
reprenable, voir Bootstrap |
| 10 | task phase:10-gitops |
task check:10-gitops |
idempotent ; exige tout commité et poussé |
| 11 | task phase:11-acces (NetBird, 40-netbird, 50-warpgate) |
task check:11-acces |
exige les PAT créés à la main |
| 12 | task phase:12-verify |
task check:12-verify |
rejouable |
task status indique quelles phases semblent faites ; task status -- --live rejoue les vérifications. task plan:<stack> montre ce qu'un apply changerait.
Pourquoi les services sont déployés en deux passes
Les secrets des clients OIDC de NetBird, Warpgate et Grafana sont générés par la stack 30-authentik (phase 7), qui exige elle-même Authentik et l'edge en ligne.
Les rôles NetBird et Warpgate refusent de s'exécuter sans ces secrets : la phase 6 déploie donc monitoring, Authentik et l'edge, la phase 7 applique 30-authentik et recopie
les secrets dans les sops (scripts/sopsctl.py oidc-sync, sans jamais les afficher), la phase 8 déploie Warpgate, NetBird et rejoue le monitoring. Les rôles sont idempotents.
Les secrets du front et d'ArgoCD sont recopiés dans gitops/ : les commiter et les pousser avant la phase 10.
Les arrêts normaux d'un premier task up
Les phases 10 et 11 s'arrêtent tant que le dépôt n'est pas poussé (10) ou que les jetons NetBird/Warpgate n'existent pas (11) : c'est volontaire. Créer ce qu'elles
réclament (guide, phases 8 et 11 ; Actions manuelles), puis relancer task up ou la phase.
Après le déploiement¶
- Faire les actions manuelles restantes.
task phase:12-verifydepuis un poste connecté à NetBird.task backuppour disposer d'un premier point de restauration.- Parcourir la checklist finale du guide, puis ouvrir Grafana et vérifier que les dashboards se remplissent.
Dépannage¶
| Symptôme | Piste |
|---|---|
un KO |
la ligne à regarder de la vérification dit où chercher ; corriger puis relancer la même phase |
tofu : erreur d'authentification Proxmox |
jeton et privilèges : task check:0-prereqs |
| Ansible : hôte injoignable | clés SSH, ssh_host/ssh_user de secrets/site.sops.yaml, route de l'hôte (task host:route) |
bootstrap:cluster bloqué sur Provisioned |
kubectl --kubeconfig .state/kind.kubeconfig -n pad-cluster describe machine ; API Proxmox joignable ? |
ArgoCD en ksops / no identity matched |
Secret sops-age, voir Secrets |
Applications Progressing longtemps |
images à tirer ou empreintes 000… ; kubectl get pods -A ; Charges Kubernetes |