Flag globali, exit code e CI

​

squarecloud help

squarecloud help [command]
squarecloud [command] --help

A command line application to manage your Square Cloud applications

Usage:
  squarecloud COMMAND [flags]
  squarecloud [command]

Available Commands:
  app         Manage your applications with these commands
  auth        Manage your Square Cloud login with these commands
  commit      Make a commit for your application
  db          Manage the databases of your account
  help        Help about any command
  status      Check the Square Cloud platform health
  upload      Upload a new application
  workspace   Manage your team workspaces
  zip         Zip the current folder

Flags:
  -h, --help      Show help for this command
      --json      Output raw JSON
  -v, --version   Print the CLI version

Use "squarecloud [command] --help" for more information about a command.

​

Flag globali

​

squarecloud status

squarecloud status [--json]

✓ <status message>

​

Debug

• Imposta SQUARECLOUD_DEBUG=1 per 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.
• Ctrl+C annulla la richiesta in corso; un secondo Ctrl+C chiude un comando in attesa di input.

SQUARECLOUD_DEBUG=1 squarecloud app list

​

Script e CI

• Autenticazione: imposta SQUARECLOUD_API_KEY invece di eseguire auth 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 codice 1 e non modifica nulla. I comandi che chiedono conferma sono app delete, app env replace, app env remove --all, app file delete, app file read -o su un file esistente, app network purge-cache, app snapshot restore, db delete, db snapshot restore, db credentials reset, workspace delete, workspace leave, workspace member remove e auth login quando 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.
• Analizza --json, non le tabelle. Sui sistemi non in inglese, le intestazioni delle tabelle e le etichette di info sono tradotte. Per forzare l’inglese, esegui con LC_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.

​

Correlati