squarecloud help
Utilizzo
Output
Flag globali
I comandi distruttivi accettano anche
-y/--yes per saltare la conferma y/N. Le pagine di ciascun comando lo indicano.
squarecloud status
Utilizzo
squarecloud app status o squarecloud db status.
Output
✓ quando la piattaforma è online, con ⚠ durante una manutenzione o un degrado, e con ? quando non è stato possibile eseguire il controllo stesso, il che non significa che la piattaforma sia ferma. Sotto, la CLI elenca gli incidenti aperti (titolo, stato, inizio e fine prevista) e i componenti coinvolti. Consulta anche la pagina di stato.
Debug
- Imposta
SQUARECLOUD_DEBUG=1per tracciare ogni richiesta API su stderr: metodo, percorso, stato e durata. Header, query string e body non vengono mai registrati, quindi l’output è sicuro da condividere. - Le richieste di lettura vengono ritentate automaticamente dopo un errore di rete o quando la piattaforma è momentaneamente occupata.
- Gli errori su cui puoi intervenire arrivano con un suggerimento che indica cosa fare: una chiave scaduta o revocata, una chiave senza il permesso richiesto dal comando, troppe richieste, un ripristino di snapshot o uno snapshot già in corso, un’altra modifica alle variabili d’ambiente in corso, snapshot temporaneamente non disponibili e un server in manutenzione.
- Ctrl+C annulla la richiesta in corso; un secondo Ctrl+C chiude un comando in attesa di input.
Script e CI
La CLI si comporta in modo prevedibile quando viene eseguita senza una persona alla tastiera:- Autenticazione: imposta
SQUARECLOUD_API_KEYinvece di eseguireauth login. Vedi Autenticazione. - Passa gli ID in modo esplicito. I selettori di applicazioni e database hanno bisogno di un terminale. Vedi come la CLI trova la tua app.
- Exit code: ogni errore termina con codice
1, anche quando la CLI è stata installata tramite npm. Controlla gli exit code, non il testo dei messaggi. - Le conferme falliscono in modo sicuro. Rispondere no, o eseguire un comando che chiede conferma senza un terminale e senza
-y, termina con codice1e non modifica nulla. I comandi che chiedono conferma sonoapp delete,app env replace,app env remove --all,app file delete,app file read -osu un file esistente,app network purge-cache,app snapshot restore,blob delete,db delete,db snapshot restore,db credentials reset,workspace delete,workspace leave,workspace member removeeauth loginquando sostituirebbe la chiave di un altro account. - stdout contiene solo i risultati. Gli errori, il messaggio di accesso non effettuato, i prompt di conferma, le righe che segnalano un fallimento e l’avviso di aggiornamento vanno su stderr. Con
upload --json, anche i messaggi di avanzamento vanno su stderr, eblob uploadinvia sempre lì il suo avanzamento. - Analizza
--json, non le tabelle. Sui sistemi non in inglese, le intestazioni delle tabelle e le etichette diinfosono tradotte. Per forzare l’inglese, esegui conLC_ALL=en_US.UTF-8. - Essere già in quello stato è un successo. Avviare un’app o un database già in esecuzione, o arrestarne uno già fermo, viene segnalato e termina con codice
0.

