API-Sync pro Workspace
Per-Workspace Opt-out der Polycrate-API-Kopplung in workspace.poly: config.api.enabled: false unterbindet Validate, Action-Runs, Template-Publish und CLI-Audit, nicht aber Age-Encryption.
Ein Workspace kann die Kopplung zur Polycrate-API lokal abschalten, ohne die globale CLI-Config zu ändern. Das ist für Scratch-, Temp- oder Fork-Workspaces gedacht: sie sollen keine Templates, Action-Runs oder Validate-Lookups gegen die Produktions-API feuern.
Feld
# workspace.poly
config:
api:
enabled: false
enabled ist optional (*bool):
| Wert | Wirkung |
|---|---|
| Feld weggelassen | Kein Veto. Es gilt die globale CLI-Config (api.enabled + api_key in ~/.polycrate/polycrate.yml). |
false |
Dieser Workspace spricht die API nicht für Sync, Publish und Audit an. |
true |
Folgt der globalen Config. Schaltet eine global deaktivierte API nicht an. |
Es gibt kein CLI-Flag für dieses Veto. Der Override lebt nur in workspace.poly.
Was das Veto abschaltet
Wenn config.api.enabled: false:
- Validate-on-load (
ValidateWithAPI) - Action-Run-Submit
- Template-Publish nach
polycrate blocks push - CLI-Activity-Audit (SSH-Session,
workspace sync/git sync)
Die CLI loggt beim übersprungenen Template-Publish (Englisch): Skipping API template publish: workspace.config.api.enabled is false.
Der OCI-Push in die Registry läuft weiter. Ein bereits publiziertes Template oder Image wird durch das Feld nicht gelöscht.
Was das Veto nicht abschaltet
Age-Encryption (polycrate workspace encrypt / decrypt) darf die API weiter für den Workspace-Encryption-Key nutzen. Das Opt-out gilt für Workspace-Sync, nicht für Key-Material.
Globale API-Config bleibt Voraussetzung
Ohne globalen API-Key und ohne api.enabled: true in ~/.polycrate/polycrate.yml bleibt die Kopplung aus — unabhängig vom Workspace-Feld.