> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Flag globali, exit code e CI

> Usa i flag globali, l'output JSON, gli exit code e il tracing di debug della CLI di Square Cloud, controlla la piattaforma ed esegui la CLI in script e CI.

## `squarecloud help`

```bash Utilizzo theme={"system"}
squarecloud help [command]
squarecloud [command] --help
```

Elenca tutti i comandi, oppure ne spiega uno. L'aiuto segue la [lingua del tuo sistema](/it/cli-reference/installation#lingua).

```bash Output theme={"system"}
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

| Flag | Descrizione |
| - | - |
| `--json` | Stampa JSON grezzo, leggibile da macchina, nei comandi che stampano dati (`list`, `info`, `status`, `logs`, `auth whoami`, `upload`, ...). I comandi senza output JSON (`app start`, `app delete`, `commit`, `zip`, ...) rifiutano il flag con un errore. |
| `-h`, `--help` | Mostra l'aiuto di qualsiasi comando. |
| `-v`, `--version` | Stampa la versione della CLI. Solo su `squarecloud` stesso. |

I comandi distruttivi accettano anche `-y`/`--yes` per saltare la conferma `y/N`. Le pagine di ciascun comando lo indicano.

## `squarecloud status`

```bash Utilizzo theme={"system"}
squarecloud status [--json]
```

Verifica se la piattaforma Square Cloud funziona normalmente. Funziona anche senza login. Per una singola applicazione o un singolo database, usa [`squarecloud app status`](/it/cli-reference/status-and-metrics#squarecloud-app-status) o [`squarecloud db status`](/it/cli-reference/databases#squarecloud-db-status).

```bash Output theme={"system"}
✓ <status message>
```

Quando la piattaforma segnala un problema, la riga inizia invece con `X`. Consulta anche la [pagina di stato](https://status.squarecloud.app/).

## 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.

```bash theme={"system"}
SQUARECLOUD_DEBUG=1 squarecloud app list
```

## Script e CI

La CLI si comporta in modo prevedibile quando viene eseguita senza una persona alla tastiera:

* **Autenticazione:** imposta `SQUARECLOUD_API_KEY` invece di eseguire `auth login`. Vedi [Autenticazione](/it/cli-reference/authentication#ci-e-script).
* **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](/it/cli-reference/quickstart#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`.

Per effettuare il deploy da GitHub Actions, consulta il [workflow di deploy automatico](https://help.squarecloud.app/en-us/article/workflow-github-actions-automated-deploy-ff34mk/) del centro assistenza.

## Correlati

| Comando | API | SDK JavaScript |
| - | - | - |
| `status` | [`GET /v2/service/status`](/it/api-reference/endpoint/service/status) | [`api.service.status()`](/it/sdks/js/client) |