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

# Options globales, codes de sortie et CI

> Utilisez les options globales de la CLI Square Cloud, la sortie JSON, les codes de sortie et le traçage debug, vérifiez la plateforme et exécutez la CLI en CI.

## `squarecloud help`

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

Liste toutes les commandes, ou en explique une. L'aide suit la [langue de votre système](/fr/cli-reference/installation#langue).

```bash Sortie 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.
```

## Options globales

| Option | Description |
| - | - |
| `--json` | Affiche un JSON brut, lisible par une machine, sur les commandes qui affichent des données (`list`, `info`, `status`, `logs`, `auth whoami`, `upload`, ...). Les commandes sans sortie JSON (`app start`, `app delete`, `commit`, `zip`, ...) rejettent l'option avec une erreur. |
| `-h`, `--help` | Affiche l'aide de n'importe quelle commande. |
| `-v`, `--version` | Affiche la version de la CLI. Uniquement sur `squarecloud` lui-même. |

Les commandes destructives acceptent aussi `-y`/`--yes` pour ignorer leur confirmation `y/N`. La page de chaque commande l'indique.

## `squarecloud status`

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

Vérifie si la plateforme Square Cloud fonctionne normalement. La commande fonctionne sans connexion. Pour une application ou une base de données précise, utilisez [`squarecloud app status`](/fr/cli-reference/status-and-metrics#squarecloud-app-status) ou [`squarecloud db status`](/fr/cli-reference/databases#squarecloud-db-status).

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

Lorsque la plateforme signale un problème, la ligne commence par `X` à la place. Consultez aussi la [page de statut](https://status.squarecloud.app/).

## Débogage

* Définissez **`SQUARECLOUD_DEBUG=1`** pour tracer chaque requête API vers stderr : méthode, chemin, statut et durée. Les en-têtes, les query strings et les corps ne sont jamais journalisés : la sortie peut donc être partagée sans risque.
* Les requêtes de lecture sont relancées automatiquement après une erreur réseau ou lorsque la plateforme est brièvement surchargée.
* **Ctrl+C** annule la requête en cours ; un second Ctrl+C quitte une commande qui attend une saisie.

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

## Scripts et CI

La CLI se comporte de manière prévisible lorsqu'elle s'exécute sans personne au clavier :

* **Authentification :** définissez `SQUARECLOUD_API_KEY` au lieu d'exécuter `auth login`. Consultez [Authentification](/fr/cli-reference/authentication#ci-et-scripts).
* **Passez les ID explicitement.** Les sélecteurs d'application et de base de données ont besoin d'un terminal. Consultez [comment la CLI trouve votre application](/fr/cli-reference/quickstart#comment-la-cli-trouve-votre-application).
* **Codes de sortie :** chaque échec se termine avec le code `1`, y compris lorsque la CLI a été installée via npm. Vérifiez les codes de sortie, pas le texte des messages.
* **Les confirmations refusent par défaut.** Si vous répondez non, ou si vous exécutez sans terminal et sans `-y` une commande qui demande une confirmation, elle se termine avec le code `1` et ne modifie rien. Les commandes qui demandent une confirmation sont `app delete`, `app env replace`, `app env remove --all`, `app file delete`, `app file read -o` sur un fichier existant, `app network purge-cache`, `app snapshot restore`, `db delete`, `db snapshot restore`, `db credentials reset`, `workspace delete`, `workspace leave`, `workspace member remove`, et `auth login` lorsqu'elle remplacerait la clé d'un autre compte.
* **stdout ne transporte que les résultats.** Les erreurs, le message indiquant que vous n'êtes pas connecté, les invites de confirmation, les lignes d'échec et l'avis de mise à jour vont vers stderr. Avec `upload --json`, les messages de progression vont aussi vers stderr.
* **Analysez `--json`, pas les tableaux.** Sur les systèmes qui ne sont pas en anglais, les en-têtes de tableau et les libellés de `info` sont traduits. Pour forcer l'anglais, exécutez avec `LC_ALL=en_US.UTF-8`.
* **Un état déjà atteint est un succès.** Si vous démarrez une application ou une base de données déjà en cours d'exécution, ou arrêtez une ressource déjà arrêtée, la CLI l'indique et se termine avec le code `0`.

Pour déployer depuis GitHub Actions, consultez le [workflow de déploiement automatisé](https://help.squarecloud.app/en-us/article/workflow-github-actions-automated-deploy-ff34mk/) du centre d'aide.

## Voir aussi

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