squarecloud help
Uso
Salida
Flags globales
Los comandos destructivos también aceptan
-y/--yes para omitir su confirmación y/N. Las páginas de cada comando lo indican.
squarecloud status
Uso
squarecloud app status o squarecloud db status.
Salida
✓ cuando la plataforma está online, con ⚠ durante un mantenimiento o una degradación, y con ? cuando la propia comprobación no pudo ejecutarse, lo que no significa que la plataforma esté caída. Debajo, la CLI lista los incidentes abiertos (título, estado, inicio y fin previsto) y los componentes afectados. Consulta también la página de estado.
Depuración
- Define
SQUARECLOUD_DEBUG=1para 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.
- Los errores sobre los que puedes actuar vienen con una sugerencia que indica qué hacer: una clave expirada o revocada, una clave sin el permiso que el comando necesita, demasiadas solicitudes, una restauración de snapshot o un snapshot ya en curso, otro cambio en las variables de entorno en curso, snapshots no disponibles temporalmente y un servidor en mantenimiento.
- Ctrl+C cancela la solicitud en curso; un segundo Ctrl+C sale de un comando que está esperando una entrada.
Scripts y CI
La CLI se comporta de forma predecible cuando se ejecuta sin una persona frente al teclado:- Autenticación: define
SQUARECLOUD_API_KEYen lugar de ejecutarauth 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
-yun comando que pide confirmación, sale con código1y no cambia nada. Los comandos que preguntan sonapp delete,app env replace,app env remove --all,app file delete,app file read -osobre un archivo existente,app network purge-cache,app snapshot restore,blob delete,db delete,db snapshot restore,db credentials reset,workspace delete,workspace leave,workspace member remove, yauth logincuando 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, yblob uploadsiempre envía ahí su progreso. - Analiza
--json, no las tablas. En sistemas que no están en inglés, los encabezados de las tablas y las etiquetas deinfose traducen. Para forzar el inglés, ejecuta conLC_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.

