Cleanup Governance

Stand: 2026-05-26

Ziel

Cleanup Governance trennt Vorbereitungs-, Ausfuehrungs- und Abschlussphasen fuer Rueckbauaktionen.

Approval-Typen

Typ	Zweck	Live-Write
cleanup_prepare	Dependency Check, Archivplan, Risiko, Cooldown	nein
cleanup_execute	spaeterer eng gescopter Cleanup	ja, nur nach separater Freigabe
cleanup_finalize	Abschlusspruefung, Audit, Doku	optional, scoped

Destroy darf niemals in einem Schritt erfolgen.

Vorbereitete Actions

Nur als Plan-/Preflight-Schritte vorbereitet:

• proxmox:stop_lxc
• proxmox:archive_lxc_config
• proxmox:plan_remove_lxc
• netbox:plan_remove_vm_object
• mkdocs:plan_remove_doc_stub

Noch nicht aktiv:

• proxmox:remove_lxc
• netbox:remove_vm_object
• mkdocs:remove_doc_stub

Cleanup-Preflight fuer LXC 124

Chain:

lanstyle_ce_test_01_cleanup_prepare

Status:

• preflight_only
• live_write_performed=false
• remove_lxc_enabled=false
• rollback_possible_after_remove_lxc=false

Dependency-Befund am 2026-05-26:

• LXC 124 existiert und ist gestoppt.
• Kein NetBox-VM-Objekt lanstyle-ce-test-01.
• Keine NetBox-IP 10.222.70.124/32.
• Kein MkDocs-Doc-Stub.
• Keine DNS-/NPM-/Firewall-Schritte im Cleanup-Preflight.

Archivanforderungen vor spaeterem Destroy

• finaler LXC-Config-Export
• optionaler vzdump/Snapshot vor Destroy
• Execution-Audit-Export
• Chain-History-Export
• klare Warnung: Restore statt Rollback

State-/Drift-Bezug

Vor einem spaeteren cleanup_execute muss der State Layer bestaetigen:

• Objekt gehoert zur erwarteten Chain.
• letzter bekannter Sollzustand ist dokumentiert.
• aktueller beobachteter Zustand ist gehasht.
• offene Drift- oder Reconciliation-Punkte sind bewertet.
• cleanup_state ist explizit gesetzt.

Cleanup darf nicht genutzt werden, um ungeprueften Drift nebenbei zu korrigieren.

Cleanup Locks

Cleanup-Flows muessen eigene Locks nutzen:

• cleanup_prepare fuer Dependency-/Archivphase
• cleanup_execute fuer spaeteren destruktiven Schritt
• cleanup_finalize als Abschlusspruefung

cleanup_execute nutzt mindestens destructive_block. Ein paralleler Execution- oder Reconciliation-Flow auf demselben Objekt muss blockieren.