Homelab
Bientôt disponible
Cette configuration fait de quelques machines de votre réseau local un cluster Kubernetes avec MicroK8s, puis y installe la suite avec un chart Helm. Chaque run (une exécution d’un workflow ; voir le glossaire) reçoit son propre pod, avec un collecteur qui garde ses messages sur disque, du TLS mutuel vers l’opérateur et une politique réseau.
La référence est le cluster sur lequel tourne ce projet : trois machines aujourd’hui, dix prévues. Le fichier de valeurs de ce cluster, deploy/helm/nexus-factory/values-nexus.yaml, sert de point de départ pour le vôtre. Le playbook Ansible nomme encore les machines de référence : avant de le jouer, remplacez les noms d’hôtes dans infra/playbooks/site.yml (les plays des modules et de Kueue visent herbie, celui de WireGuard vise lanning).
Ce que fait tourner le cluster
| Couche | Composant |
|---|---|
| Système | Ubuntu Desktop 26.04.1 sur chaque machine, MicroK8s depuis un canal snap 1.xx/stable |
| Modules du cluster | rbac, hostpath-storage, ingress, cert-manager, helm3, observability (Prometheus, Loki, Tempo) |
| File de jobs | Kueue, qui admet les runs sous un plafond global du cluster |
| Suite | Opérateur, tableau de bord et Forgejo, installés par le chart deploy/helm/nexus-factory |
| Images | Le registre de MicroK8s, alimenté par deploy/helm/nexus-factory/push-images.sh |
Préparer une machine
Réservez une adresse IP fixe à la machine dans votre box. MicroK8s lie les nœuds par leur adresse.
Générez les fichiers d’installation sans surveillance, par exemple pour une machine nommée
speedy:infra/bootstrap/make-seed speedy chemin/vers/cle-publique.pub /tmp/seed-speedyCopiez
user-dataetmeta-datasur une clé USB en FAT32 nomméeCIDATA, branchez-la avec la clé de l’installateur Ubuntu et démarrez. L’installation se déroule sans question.
Ajouter la machine au cluster
Depuis votre poste :
nexusadm node add speedy 192.168.1.132
Une fenêtre vous demande de confirmer. La commande écrit ensuite infra/inventory/noeud-speedy.yml et joue le playbook Ansible infra/playbooks/site.yml sur cette machine : système de base, MicroK8s, pare-feu, jonction au cluster. Relancer la même commande ne change rien.
nexusadm node list montre le nouveau nœud Ready au bout de quelques minutes. nexusadm doctor contrôle chaque nœud.
Installer la suite
Construisez et poussez les images, puis installez le chart. Les commandes et les accès à demander sont dans docs/installer-et-mettre-a-jour.md et dans deploy/helm/nexus-factory/README.md.
deploy/helm/nexus-factory/push-images.sh
nexushelm --nexusconfig <accès> upgrade --install nexus deploy/helm/nexus-factory -n nexus-system \
-f deploy/helm/nexus-factory/values-nexus.yaml --set images.tag=<version> ...
nexushelm et nexusctl enveloppent helm et kubectl : ils journalisent chaque appel, masquent les valeurs des Secrets et emploient des accès à durée limitée que vous accordez dans une fenêtre de confirmation (nexusadm grant request). Voir Outils.
Retirer une machine
nexusadm node remove speedy évacue les pods du nœud, le retire du plan de contrôle et supprime son fichier d’inventaire. --dry-run affiche les étapes sans les exécuter. Les volumes locaux du nœud ne sont pas déplacés.