So funktioniert's

Installation, Update und Übernahme bestehender Systeme

1. Installieren

Auf der Proxmox-Node als root den Einzeiler der App ausführen – für einen Container ct.sh, für eine VM vm.sh. Ein Dialog fragt nach Standardwerten oder eigenen Einstellungen.

Ohne Dialog, z. B. für Automatisierung:

IAC_NONINTERACTIVE=1 var_net=192.168.40.20/24 var_gateway=192.168.40.1 \
  bash -c "$(curl -fsSL https://iac.heyer.systems/traefik/ct.sh)"

Weitere Variablen: var_id, var_hostname, var_cpu, var_ram, var_disk, var_bridge, var_vlan, var_storage, var_ssh_keys.

2. Aktualisieren

Im Gast:

update

Das aktualisiert die Debian-Pakete, die App (innerhalb ihrer Major-Version) und die iac-Konfiguration. Ein Wechsel auf die nächste Debian-Version geht kontrolliert mit update --release-upgrade.

3. Bestehende Systeme übernehmen

Viele Apps haben ein adopt.sh, das eine vorhandene Installation „gerade zieht“: prüfen, sichern, ins Standard-Layout überführen. Geht das nicht automatisch, bricht es vor jeder Änderung ab und verweist auf die Migrationsanleitung der App.

Was jeder Gast mitbringt

• Zugang nur per SSH-Key – root und heyeradmin haben kein Passwort
• Firewall (nftables): eingehend nur SSH und die Ports der App
• etckeeper: jede Änderung an /etc ist nachvollziehbar
• Dateien mit # managed by iac gehören iac und werden bei update überschrieben – eigene Anpassungen gehören in die jeweiligen local-Dateien

Integrität

VM-Images werden wöchentlich neu gebaut, vor der Veröffentlichung in einer Test-VM gestartet und geprüft, und mit SHA256-Prüfsumme ausgeliefert. Die Einzeiler prüfen sie vor dem Import.