PKR-Lab

Installation

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/installation.md

Installation

Diese Seite beschreibt, wie der Stack aus capulus-ansible und capulus-core von null aufgebaut wird. Die Voraussetzungen und der Host-Teil stehen ausführlich in der Doku von capulus-ansible.

Voraussetzungen

Quickstart

git clone https://github.com/pkr-lab/capulus-ansible.git
cd capulus-ansible
$EDITOR inventory/hosts.yml
$EDITOR group_vars/all.yml
ansible-vault encrypt_string 'tskey-auth-DEIN_KEY' --name 'tailscale_auth_key'
make install
Schritt Was
Inventory ansible_host (Server-IP) und ggf. ansible_ssh_private_key_file anpassen
Variablen Pflicht: argocd_repo_url (zeigt auf capulus-core), local_subnet, timezone
Tailscale-Key mit ansible-vault encrypt_string verschlüsseln und den !vault-Block über den bestehenden tailscale_auth_key einfügen
Playbook make install installiert die Collections und führt site.yml aus

Am Ende druckt das Playbook die ArgoCD-URL und das Admin-Passwort:

ArgoCD UI:  https://argocd.tech.homeserver   (CLI/CI: argocd login argocd.tech.homeserver --grpc-web)
Username:   admin
Password:   <auto-generiert>

ArgoCD liest danach argocd/bootstrap/ und alle Apps unter argocd/apps/tech/ aus capulus-core und rollt sie aus.

Cluster aufbauen

Alle Befehle laufen im Verzeichnis von capulus-ansible, nach make install für TECH:

make controlplane-1 worker-1        # Worker in den TECH-Cluster aufnehmen
make libvirt-host             # KVM + Bridge auf dem Homeserver, legt prod-vm an
make prod                     # k3s in der prod-vm; danach im Hub registrieren
make worker-1-libvirt-host    # KVM + Bridge auf worker-1, legt entw-vm an
make entw                     # k3s + ArgoCD in der entw-vm

Die PROD-Registrierung im Hub steht in bootstrap-prod.

Prüfen

kubectl -n argocd get applications

Alle Applications sollten Synced und Healthy werden. Fehlersuche: a0040 Troubleshooting.

Fehlersuche beim Aufbau

Symptom Ursache Lösung
make install bricht ab Voraussetzung, Vault, Netz capulus-ansible: Installation, a0030: Fehlersuche
ArgoCD legt keine Apps an argocd_repo_url falsch oder Bootstrap-ApplicationSet nicht angewendet ArgoCD: Fehlersuche
Apps bleiben Degraded Secrets, Speicher, Netzwerk SealedSecrets, NAS-Speicher, zentrale Fehlersuche
PROD- oder ENTW-Cluster fehlen VMs, Registrierung im Hub PROD im Hub, ENTW-ArgoCD