CleanClientOverlays
Entfernt Overlay-URI-Einträge aus jedem blueprint-verwalteten Client im Tenant. Ohne -overlayName: entfernt jede Source, die 'overlay:*' entspricht. Mit -overlayName: entfernt nur Einträge, die exakt 'overlay:<name>' entsprechen. Destruktiv — typischerweise vor einem bereinigten DumpTenant-Export verwendet; der Operator kann danach mit Apply-IdentityOverlay erneut anwenden (idempotent, No-op, wenn der Zustand übereinstimmt).
Beispiele
Entfernt jeden overlay:*-Eintrag aus dem aktiven Tenant (fragt nach Bestätigung):
octo-cli -c CleanClientOverlays
Entfernt nur overlay:local-dev-Einträge; gerald-laptop und andere Overlays bleiben erhalten:
octo-cli -c CleanClientOverlays -n "local-dev"
Überspringt die Bestätigungsabfrage — typische CI-/Dump-Pipeline-Verwendung:
octo-cli -c CleanClientOverlays -y
Optionen
| Kurz | Lang | Erforderlich | Beschreibung |
|---|---|---|---|
-n | --overlayName | nein | Optionaler Overlay-Name. Ohne ihn wird jede 'overlay:*'-Source entfernt. Mit ihm wird nur 'overlay:<name>' entfernt. Dieselbe Regex-Beschränkung wie bei ApplyClientOverlay ([A-Za-z0-9._-]+). |
-y | --yes | nein | Überspringt die Bestätigungsabfrage |
Hinweise
Idempotent — Clients ohne zu entfernende Einträge überspringen das clientweise UpdateAsync + die Cache-Invalidierung.
base-/api-/family:-Einträge bleiben immer erhalten; nur overlay:-Treffer werden entfernt.
Typischer Ablauf vor dem Teilen eines Tenant-Dumps: CleanClientOverlays -y → DumpTenant → Apply-IdentityOverlay (wendet das kanonische local-dev-Set aus octo-tools/overlays/identity-local-dev.yaml erneut an).