Skip to main content
Esta guía lleva un proyecto de tu máquina a una aplicación en ejecución en Square Cloud y luego muestra cómo enviar un cambio. Toma unos pocos minutos.
1

Instala la CLI

Comprueba que funciona con squarecloud --version. Si no se encuentra el comando, consulta Instalación.
2

Inicia sesión

La CLI muestra un código corto y abre la página de autorización en tu navegador. Escribe el código allí y aprueba. La página de Autenticación cubre las API keys y el uso en CI.
3

Agrega un archivo de configuración

En la raíz de tu proyecto, crea un archivo squarecloud.app. Le indica a Square Cloud qué archivo ejecutar, cuánta memoria reservar y qué versión del runtime usar:
squarecloud.app
Para un sitio web, agrega SUBDOMAIN=<name> para publicarlo en <name>.squareweb.app. Cada clave se explica en la guía del archivo de configuración.
4

Sube el proyecto

Desde la carpeta del proyecto, ejecuta:
La CLI comprime la carpeta, dejando fuera lo que lista squarecloud.ignore (además de node_modules, .git y los lockfiles por defecto), y crea una aplicación nueva:
Salida
También escribe el ID de la nueva aplicación en tu archivo de configuración, para que los siguientes comandos sepan a qué app te refieres:
squarecloud.app
5

Comprueba que funciona

No hace falta ningún ID: los dos leen la línea ID=. Para seguir la salida en vivo, ejecuta squarecloud app realtime y presiona Ctrl+C para detenerlo.
6

Envía un cambio

Edita tu código y luego envía la carpeta a la misma aplicación y reiníciala:
upload crea una aplicación nueva cada vez; commit actualiza la que ya tienes y conserva su ID, su dominio y su configuración.

​
Cómo encuentra la CLI tu aplicación

Los comandos que actúan sobre una aplicación muestran [appID] en su uso: el ID es opcional. La CLI elige la aplicación en este orden:
  1. El ID que pasas. Es el primer argumento, o --app <appID> en los comandos cuyos argumentos son otra cosa: app env set, remove y replace, todos los comandos app file, app deploy webhook, app deploy github link y unlink, y app network domain.
  2. La línea ID= del archivo squarecloud.app de la carpeta actual (o squarecloud.config; cuando existen los dos, gana squarecloud.app).
  3. Un selector con tus aplicaciones, cuando la CLI se ejecuta en una terminal. Usa las flechas y Enter; Esc cancela.
Algunos comandos funcionan de otra manera:
  • commit nunca abre el selector. Sin un argumento ni una línea ID=, se detiene con código de salida 1 y pide uno.
  • app snapshot restore siempre recibe el ID de la aplicación como primer argumento.
  • Las bases de datos no tienen archivo de configuración: los comandos db reciben el ID de la base de datos o abren un selector con tus bases de datos.
  • Los comandos workspace que actúan sobre un workspace siempre reciben su ID.
Para encontrar un ID, ejecuta squarecloud app list. En scripts y CI, pasa siempre el ID o conserva la línea ID=: el selector necesita una terminal interactiva.

​
Dónde se guarda el ID de la aplicación

upload escribe ID=<appID> solo cuando la carpeta ya tiene un archivo de configuración, que la subida necesita de todos modos. Cambia esa única línea y conserva tus demás claves y comentarios tal como están. Square Cloud ignora la línea al leer el archivo, así que puede quedarse en el zip. Ejecutar upload otra vez desde la misma carpeta crea otra aplicación y apunta la línea ID= a ella. Para actualizar la aplicación que ya tienes, usa commit. Para trabajar con otra aplicación desde esta carpeta, edita o elimina la línea.

​
Próximos pasos

Subir y hacer commit

Todos los flags de upload, commit y zip, y qué va dentro del zip.

Variables de entorno

Define variables desde la terminal o cárgalas de un archivo .env.

Deploys desde GitHub

Haz deploy en cada push con la GitHub App de Square Cloud.

Flags globales y CI

Salida JSON, códigos de salida y cómo ejecutar la CLI en pipelines.