Automazione

Nella CI

Usa una chiave API, non un accesso OAuth: la chiave appartiene all’area di lavoro e non scade quando una persona se ne va.

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

Imposta gli ambiti più limitati necessari per il job. Un job che crea un build e un’anteprima ha bisogno di sites:write. Escludi sites:publish e il job non potrà modificare ciò che vedono i visitatori, così un log divulgato non potrà mettere nulla online.

In uno script, publish richiede --yes e sites delete richiede --confirm <slug>. Senza questi parametri, il comando termina con 2, non modifica nulla e stampa il comando esatto da rieseguire.

Con un agente

atelier201 help --json

help --json stampa in un unico documento leggibile dalle macchine l’intero albero dei comandi, i codici di uscita, i criteri per riprovare e la struttura degli errori. Se lo legge prima, l’agente evita di procedere a tentativi con i flag.

Usa atelier201 help files read --json per consultare un singolo comando oppure atelier201 help --operation readSiteFile --json per vedere gli schemi REST completi e la corrispondenza CLI/MCP. La consultazione funziona anche offline, senza credenziali. Il contratto incluso descrive la versione installata della CLI; le risorse OpenAPI e MCP in tempo reale descrivono l’API distribuita. Consulta la copertura delle operazioni.

Nuovi tentativi

La CLI riprova con 429 per tutti i comandi. Riprova con 408 e 5xx solo per le letture (GET, HEAD e OPTIONS). Se una scrittura restituisce 5xx, la CLI segnala l’errore senza ripetere l’operazione, perché potrebbe essere già stata applicata: prima di riprovare, leggi di nuovo il sito. Un’intestazione Idempotency-Key non abilita i nuovi tentativi automatici per le scritture. Se Retry-After supera 60 secondi, la CLI restituisce l’errore con le istruzioni per risolverlo, senza riprovare in anticipo né attendere a tempo indeterminato. Gli errori di rete e i timeout non vengono ritentati. Disattiva i nuovi tentativi con --no-retry.