Benutzen

Module

Bausteine für jede App – beim Anlegen wählen oder jederzeit nachrüsten, im Container wie in der VM.

Module ergänzen eine App um Bausteine, die viele Apps gebrauchen können. Jedes Modul ist für jede App wählbar, sofern es die Plattform unterstützt. Aktive Module laufen bei jedem update mit und bleiben so aktuell.

Alle Module

Modul	Inhalt	LXC	VM	Pflicht bei
`desktop` Desktop (XFCE, RDP)	XFCE-Desktop mit Firefox per RDP (Port 3389, nur private Netze). Login als root, Passwort: grep root_password /etc/iac/settings.env	–	✓	–
`node-exporter` Prometheus node exporter	System-Metriken auf Port 9100 (nur private Netze)	✓	✓	–
`postgresql` PostgreSQL	PostgreSQL-Server aus Debian, nur über localhost erreichbar	✓	✓	netbox
`unattended-upgrades` Automatische Sicherheitsupdates	Debian-Sicherheitsupdates täglich automatisch einspielen (ohne Neustart)	✓	✓	–
`valkey` Valkey (Redis)	Valkey-Server aus Debian (Redis-Protokoll), nur über localhost:6379	✓	✓	netbox

Pflicht bei heißt: Die App braucht das Modul selbst (z. B. NetBox seine Datenbank). Es ist dort immer aktiv und lässt sich nicht abwählen.

Beim Anlegen wählen

Dialog: „advanced“ wählen, dann die Module ankreuzen. Die Vorauswahl der App ist schon gesetzt.
Generator auf der App-Seite: Häkchen setzen, der Befehl enthält dann var_modules.
Ohne Dialog: var_modules=node-exporter,unattended-upgrades (var_modules='' = keine).

Nachträglich aktivieren

Im Gast als root – im Container und in der VM gleich:

update --list-modules                          # verfügbar für diesen Gast, [x] = aktiv
update --add-modules node-exporter             # hinzufügen
update --add-modules node-exporter,unattended-upgrades

update --add-modules macht ein normales update und installiert dabei die neuen Module. Ein Modul, das es auf dieser Plattform nicht gibt (z. B. desktop im Container), wird abgelehnt, bevor sich etwas ändert.

Ohne dich anzumelden, direkt vom Proxmox-Host:

pct exec 105 -- update --add-modules node-exporter              # Container 105
ssh [email protected] update --add-modules node-exporter       # VM

Entfernen

update --remove-modules desktop     # einzelne Module entfernen
update --modules ''                 # alle wählbaren Module entfernen
update --modules node-exporter      # Auswahl komplett festlegen

Ein entferntes Modul nimmt seine Pakete, Dienste, Firewall-Regeln und Konfiguration wieder mit. Daten bleiben erhalten – eine PostgreSQL-Datenbank z. B. wird nur gestoppt, nicht gelöscht.

Hinweise zu einzelnen Modulen

desktop

XFCE mit Firefox, erreichbar per RDP (Port 3389) aus privaten Netzen. Anmelden als root. Das Passwort erzeugt das Modul beim Aktivieren:

grep root_password /etc/iac/settings.env

SSH bleibt davon unberührt – dort gilt weiter nur der Key. Wird das Modul entfernt, wird das root-Passwort wieder gesperrt.

node-exporter

Prometheus-Metriken unter http://<IP>:9100/metrics, nur aus privaten Netzen erreichbar.

postgresql, valkey

Nur über localhost erreichbar – gedacht für die App im selben Gast. Apps, die eine Datenbank brauchen, legen sie selbst an.

unattended-upgrades

Spielt täglich die Sicherheitsupdates von Debian ein, ohne Neustart. Das vollständige update (App, Module, iac) bleibt trotzdem nötig.

Eigene Module

Ein Modul ist eine Ansible-Rolle in iac-core plus ein Eintrag im Katalog modules.json. Wie das geht, steht in der App-Referenz.