Gestire i codici di uscita della CLI dosya

La CLI dosya usa codici di uscita stabili per l’automazione: 0 per successo, 1 per errore generico, 2 per utilizzo, 3 per autenticazione, 4 per rete, 5 per accesso negato e 75 per manutenzione. I codici di uscita per segnale restano 130 per SIGINT e 143 per SIGTERM.

Prima di iniziare

• Acquisisci stdout, stderr e $? separatamente. Il testo ordinario e il JSON usano stdout; diagnostica, avvisi, output di debug e avanzamento usano stderr.
• Decidi per quali categorie il processo può riprovare. Gli errori di autenticazione e permesso richiedono una correzione, non tentativi ripetuti ravvicinati.
• Una risposta 503 con codice surface_disabled corrisponde direttamente al codice di uscita 75 per manutenzione.

Procedura

1. Esegui il comando senza passare stdout direttamente a un altro processo; prima conserva entrambi i flussi e il codice di uscita originale.
2. Considera il codice 0 come un comando riuscito. Se un comando collettivo è stato avviato con --json, uno o più elementi non riusciti producono normalmente JSON specifico del comando e il codice di uscita 1; analizza il risultato per conservare il conteggio dei successi e i dettagli degli errori.
3. Associa 2 a sintassi o argomenti non validi, 3 a una credenziale assente o rifiutata e 5 a un chiamante autenticato senza permesso.
4. Associa 4 a un errore di trasporto o connessione. Riprova un numero limitato di volte solo se è sicuro ripetere il comando.
5. Associa 75 alla manutenzione temporanea, incluso surface_disabled. Riprogramma dopo un intervallo approvato da un operatore, senza considerarlo un errore permanente di configurazione.
6. Registra stderr e il codice numerico. Mantieni 130 e 143 come annullamenti, così lo scheduler non classifica un processo interrotto come errore dell’applicazione.

Risultato previsto

L’automazione sceglie il percorso in base al codice numerico originale, conserva la diagnostica leggibile da stderr e non analizza il messaggio di errore per indovinare se si tratta di utilizzo, autenticazione, rete, accesso negato o manutenzione.

Risoluzione dei problemi

Una pipeline riporta lo stato del parser. Salva il codice del processo dosya prima di invocare jq, oppure abilita esplicitamente la gestione dello stato della pipeline nella shell.

Il codice di uscita 1 fornisce pochi dettagli. Controlla stderr: il codice 1 indica errori generici che non rientrano in un codice più specifico.

Un nuovo tentativo potrebbe modificare i dati due volte. Verifica prima lo stato remoto. Il codice identifica il tipo di errore, non se il server ha applicato la modifica prima della fine della connessione.

Guide correlate

• Autenticare la CLI dosya
• Usare l’output JSON della CLI