Flags globales, códigos de salida y 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.

​

Flags globales

​

squarecloud status

squarecloud status [--json]

✓ <status message>

​

Depuración

• Define SQUARECLOUD_DEBUG=1 para registrar cada solicitud a la API en stderr: método, ruta, estado y duración. Los encabezados, las query strings y los cuerpos nunca se registran, así que la salida es segura para compartir.
• Las solicitudes de lectura se reintentan automáticamente después de un error de red o cuando la plataforma está ocupada por un momento.
• Ctrl+C cancela la solicitud en curso; un segundo Ctrl+C sale de un comando que está esperando una entrada.

SQUARECLOUD_DEBUG=1 squarecloud app list

​

Scripts y CI

• Autenticación: define SQUARECLOUD_API_KEY en lugar de ejecutar auth login. Consulta Autenticación.
• Pasa los IDs de forma explícita. Los selectores de aplicaciones y bases de datos necesitan una terminal. Consulta cómo encuentra la CLI tu aplicación.
• Códigos de salida: todo fallo sale con código 1, incluso cuando la CLI se instaló mediante npm. Comprueba los códigos de salida, no el texto de los mensajes.
• Las confirmaciones fallan en modo seguro. Responder que no, o ejecutar sin una terminal y sin -y un comando que pide confirmación, sale con código 1 y no cambia nada. Los comandos que preguntan son app delete, app env replace, app env remove --all, app file delete, app file read -o sobre un archivo existente, app network purge-cache, app snapshot restore, db delete, db snapshot restore, db credentials reset, workspace delete, workspace leave, workspace member remove, y auth login cuando reemplazaría la clave de otra cuenta.
• stdout solo lleva resultados. Los errores, el aviso de que no hay sesión iniciada, las preguntas de confirmación, las líneas de fallo y el aviso de actualización van a stderr. Con upload --json, los mensajes de progreso también van a stderr.
• Analiza --json, no las tablas. En sistemas que no están en inglés, los encabezados de las tablas y las etiquetas de info se traducen. Para forzar el inglés, ejecuta con LC_ALL=en_US.UTF-8.
• Estar ya en ese estado es un éxito. Si inicias una app o base de datos que ya está en ejecución, o detienes una que ya está detenida, la CLI lo indica y sale con código 0.

​

Relacionado