Installation
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/installation.md
Installation
Voraussetzungen
| Was | Details |
|---|---|
| Zielhost | Ubuntu Server 26.04 LTS mit SSH-Zugang und sudo; Erstinstallation: a0000 |
| Steuerrechner | Ansible ≥ 2.14, make, git; für Lint zusätzlich yamllint und ansible-lint |
| Collections | ansible.posix, community.general, kubernetes.core, community.docker (requirements.yml) |
| Vault | Vault-Passwort für group_vars/all.yml, user_inventory_vault.yml und host_vars/*/vault.yml |
| Netz | Zugriff auf die Hosts per LAN oder Tailnet; Wake-on-LAN für die Worker |
Vollständige Voraussetzungen und Vorbereitung der Hosts: a0020, Installation Schritt für Schritt: a0030.
Setup
git clone https://github.com/pkr-lab/capulus-ansible.git
cd capulus-ansible
make deps
$EDITOR inventory/hosts.yml
$EDITOR group_vars/all.yml
make ping
make check
make install
| Target | Wirkung |
|---|---|
make deps |
installiert die Galaxy-Collections |
make ping |
prüft per Ansible-Ping, ob der Homeserver erreichbar ist |
make check |
Dry-Run von site.yml (--check --diff) |
make install |
führt site.yml aus und provisioniert den Homeserver samt TECH-Cluster |
Tailscale-Auth-Key verschlüsseln und in group_vars/all.yml eintragen:
ansible-vault encrypt_string 'tskey-auth-DEIN_KEY' --name 'tailscale_auth_key'
Reihenfolge beim ersten Rollout
make install
make controlplane-1
make worker-1
make libvirt-host
make worker-1-libvirt-host
make prod
make entw
make xibo-kiosks
make controlplane-1 und make worker-1 brauchen den Join-Token, den make install erzeugt. libvirt-host braucht libvirt_host_enabled: true. Nach make prod wird der PROD-Cluster im ArgoCD-Hub registriert, siehe bootstrap-prod. Die Kiosk-Playbooks sind optional und laufen nur manuell.
Lint und Syntax-Check
make lint
ansible-playbook -i inventory/hosts.yml site.yml --syntax-check
Fehlersuche: a0040 Troubleshooting.
Probleme bei der Installation
| Symptom | Ursache | Lösung |
|---|---|---|
make ping schlägt fehl |
SSH-Zugang, IP, Schlüssel | a0020: Fehlersuche |
| Playbook bricht bei der Vault-Entschlüsselung ab | Passwort fehlt oder falsch | Nutzung: Fehlersuche |
make controlplane-1 meldet Token-Fehler |
make install hat noch keinen Join-Token erzeugt |
zuerst make install |
make libvirt-host tut nichts |
libvirt_host_enabled: false |
auf true setzen |
make prod scheitert |
VM läuft nicht | make libvirt-host, libvirt_host |
| Ablauf der Erstinstallation hakt | siehe Schritt-für-Schritt-Anleitung | a0030: Fehlersuche, Troubleshooting |