Susan

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

CoucheComposant
SystèmeUbuntu Desktop 26.04.1 sur chaque machine, MicroK8s depuis un canal snap 1.xx/stable
Modules du clusterrbac, hostpath-storage, ingress, cert-manager, helm3, observability (Prometheus, Loki, Tempo)
File de jobsKueue, qui admet les runs sous un plafond global du cluster
SuiteOpérateur, tableau de bord et Forgejo, installés par le chart deploy/helm/nexus-factory
ImagesLe registre de MicroK8s, alimenté par deploy/helm/nexus-factory/push-images.sh

Préparer une machine

  1. Réservez une adresse IP fixe à la machine dans votre box. MicroK8s lie les nœuds par leur adresse.

  2. 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-speedy
    
  3. Copiez user-data et meta-data sur une clé USB en FAT32 nommée CIDATA, 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.