Automatisierung

In CI

Verwenden Sie einen API-Schlüssel statt einer OAuth-Anmeldung: Der Schlüssel gehört zum Workspace und läuft nicht ab, wenn jemand das Unternehmen verlässt.

export ATELIER201_API_KEY="atelier201_live_..."
atelier201 site push --build --wait

Legen Sie nur die erforderlichen Berechtigungen fest. Ein Job, der Builds erstellt und Vorschauen bereitstellt, benötigt sites:write. Lassen Sie sites:publish weg, damit der Job nicht ändern kann, was Besucher sehen. So kann ein offengelegtes Protokoll nichts online stellen.

In einem Skript benötigt publish die Option --yes, und sites delete benötigt --confirm <slug>. Ohne diese Optionen wird der Befehl mit Exit-Code 2 beendet, nimmt keine Änderungen vor und gibt den genauen Befehl zum erneuten Ausführen aus.

Mit einem Agent

atelier201 help --json

help --json gibt den vollständigen Befehlsbaum, die Exit-Codes, die Richtlinie für Wiederholungsversuche und den Fehlerumschlag als maschinenlesbares Dokument aus. Liest ein Agent die Ausgabe zuerst, muss er nicht mehr über Optionen spekulieren.

Verwenden Sie atelier201 help files read --json, um nur einen Befehl zu prüfen, oder atelier201 help --operation readSiteFile --json, um die vollständigen REST-Schemas und die CLI/MCP-Zuordnung anzuzeigen. Die Ermittlung funktioniert offline und ohne Zugangsdaten. Der integrierte Vertrag beschreibt die installierte CLI-Version; OpenAPI und die MCP-Ressource beschreiben die bereitgestellte API. Siehe Abdeckung der Operationen.

Wiederholungsversuche

Die CLI wiederholt jeden Befehl bei 429. Bei Lesevorgängen (GET, HEAD und OPTIONS) wiederholt sie auch bei 408 und 5xx. Schlägt ein Schreibvorgang mit 5xx fehl, wird der Fehler gemeldet, aber der Vorgang nicht wiederholt, da er möglicherweise bereits ausgeführt wurde. Lesen Sie die Website erneut aus, bevor Sie es selbst noch einmal versuchen. Ein Idempotency-Key-Header aktiviert keine automatischen Wiederholungsversuche für Schreibvorgänge. Überschreitet Retry-After 60 Sekunden, gibt die CLI den Fehler samt Angaben zur Behebung zurück, anstatt vorzeitig erneut zu versuchen oder unbegrenzt zu warten. Netzwerkfehler und Zeitüberschreitungen führen nicht zu Wiederholungsversuchen. Deaktivieren Sie diese mit --no-retry.