Despliega y controla tus aplicaciones desde la terminal
Inicia sesión con un código en el navegador, despliega cualquier carpeta con un solo comando y accede a logs, bases de datos y espacios de trabajo desde el mismo prompt, con una salida que tus scripts pueden leer.
Instala con un solo comando
El script de instalación y el paquete npm descargan la compilación para tu sistema desde la última versión y verifican su checksum antes de instalarla.
macOS, Linux y WSL
curl -fsSL https://cli.squarecloud.app/install | bashSe instala en /usr/local/bin, así que puede pedirte la contraseña.
Windows
npm i -g @squarecloud/cliRequiere Node.js con npm. El mismo comando también funciona en macOS y Linux.
- Verificada con los checksums SHA-256 de la versión
- Compilaciones para x86 y ARM, Apple silicon incluido
- Para actualizar, ejecuta el mismo comando otra vez
Inicia sesión sin copiar ninguna clave
La CLI muestra un código, lo apruebas en el navegador y la terminal recibe su propia clave, igual que se conecta la extensión de VS Code.
- 1
La terminal muestra un código
Ejecuta el comando de inicio de sesión y el navegador se abre en la página de aprobación, mientras la terminal muestra un código de ocho caracteres y una cuenta atrás.
- 2
Lo apruebas en el navegador
Escribe el código en la página de Square Cloud y apruébalo. Nunca escribas un código que te haya enviado otra persona.
- 3
La CLI queda conectada
La terminal confirma tu cuenta y guarda una clave creada para ella, solo con los permisos que usan sus comandos.
- Cada clave dura 90 días, y
auth whoamimuestra hasta cuándo - Pregunta antes de reemplazar otra cuenta en esta máquina
- Por SSH,
--no-browsermuestra el enlace para abrirlo donde quieras - ¿Ya tienes una clave? Usa
--tokeno--with-token
Despliega desde cualquier carpeta
Sube la carpeta en la que estás como una nueva aplicación, envía cambios a una que ya existe o vincula un repositorio de GitHub para que cada push la despliegue.
Sube una aplicación
La CLI comprime la carpeta actual con tus reglas de exclusión, crea la aplicación y muestra el enlace a su página en el panel.
uploadupload --file- O envía un zip que ya tengas
- Escribe el nuevo ID en squarecloud.app, si el proyecto tiene uno
Haz commit de cambios
Envía la carpeta, o un zip, a una aplicación que ya existe. Conserva su ID, su dominio y su configuración.
commitcommit -rcommit --path- Reinicia la aplicación después, si lo pides
- Puede colocar los archivos en una carpeta de la aplicación
Despliega con cada push
Vincula un repositorio y una rama con la GitHub App de Square Cloud, o crea un webhook con un token de GitHub, sin salir de la terminal.
app deploy github linkapp deploy webhookapp deploy list- Lista los despliegues recientes con commit, estado y rama
- O ejecuta la CLI en GitHub Actions
Un solo archivo de exclusión para la CLI y VS Code
upload, commit y zip dejan fuera lo que squarecloud.ignore indica en la raíz de tu proyecto. La extensión de VS Code lee el mismo archivo, con las mismas reglas.
La sintaxis de .gitignore
#para comentarios,!para recuperar una ruta,dir/solo para carpetas,/buildsolo en la raíz, y*,?,[abc]y**. Gana la última línea que coincide, sin distinguir mayúsculas de minúsculas.Valores predeterminados sensatos
node_modules,.git,.github,.vscodey los lockfiles de npm, pnpm y Yarn quedan fuera antes de aplicar tus reglas. Una línea como!yarn.lockrecupera uno.Revisa antes de enviar
squarecloud zipgenera el mismo archivo comprimido en tu carpeta, para que lo abras y veas exactamente qué se subiría.
Las variables llegan tal como las escribiste
Tu aplicación carga sus variables a través de un shell. Desde la versión 3.1.1, la CLI envía entre comillas los valores con espacios o caracteres como $, & o ;, para que el shell no los corte ni los expanda.
Desde la terminal
Pasa todos los pares KEY=VALUE que quieras. La CLI toma la aplicación de squarecloud.app o te deja elegirla de una lista.
app env setapp env list- Comillas simples, o dobles si el valor contiene una
- Un valor que ya está entre comillas se envía tal cual
Carga un archivo .env
Lee líneas KEY=VALUE de un archivo y omite comentarios y líneas en blanco. También admite líneas que empiezan con export y valores entre comillas.
--from-file .env- Funciona al definir o reemplazar variables
- La lista las muestra de nuevo como KEY=VALUE
Cambios en bloque
Reemplaza todas las variables a la vez o elimínalas todas. Ambas acciones piden confirmación antes de cambiar nada, y reemplazar requiere al menos una variable nueva.
app env replaceapp env remove --all-y- Un flag confirma por ti en scripts
- Responde que no y nada cambia
Hecha para scripts y CI
Resultados que un programa puede leer, códigos de salida que dicen la verdad y una clave que funciona sin navegador.
JSON cuando lo pides
Los comandos que muestran datos pueden responder en JSON, con solo el resultado en stdout. Los demás rechazan el flag con un error en lugar de imprimir texto con el que un parser tropezaría.
--jsonCódigos de salida
Todo fallo termina con 1. Cuando no se puede pedir una confirmación, sin terminal y sin un flag que la responda, el comando falla y no cambia nada.
-yUn stdout limpio
Los errores, las preguntas y los avisos van a stderr, y también el progreso cuando pides JSON, así que un pipe solo lleva el resultado.
stdoutstderrClave para pipelines
Define una clave de tu cuenta como variable de entorno y todos los comandos la usan, sin iniciar sesión. Con CI en true, el inicio de sesión en el navegador no se abre.
SQUARECLOUD_API_KEYCI=trueTrazas sin secretos
Una variable muestra en stderr el método, la ruta, el estado y la duración de cada llamada a la API, nunca encabezados, query strings ni cuerpos.
SQUARECLOUD_DEBUG=1GitHub Actions
La Action de Square Cloud instala la CLI en el runner, la verifica con los checksums de la versión y ejecuta cualquier comando con tu clave.
squarecloudofc/github-action@v2
El resto de la plataforma, también
Logs, métricas, archivos, snapshots, dominios, bases de datos y espacios de trabajo, cada uno a un comando de distancia.
Logs en tiempo real
Muestra las últimas líneas o sigue la salida en vivo junto con cada cambio de estado. Lo que tu aplicación escribe en stderr se queda en stderr.
app logsapp realtimeEstado y métricas
CPU, memoria, disco y tiempo activo de una aplicación o una línea por cada una, además de las métricas de las últimas 24 horas.
app status --allapp metricsArchivos remotos
Lista, lee, escribe, mueve y elimina los archivos de la aplicación. Escribir desde un archivo conserva intactos los binarios, y leer hacia uno pregunta antes de sobrescribirlo.
app file readapp file writeSnapshots
Crea un snapshot y descárgalo, lista sus versiones y restaura una, para aplicaciones y bases de datos.
app snapshot createdb snapshot restoreDominios y tráfico
Configura un dominio personalizado, obtén los registros DNS que debes crear, revisa analíticas, errores y rendimiento del edge, y purga la caché.
app network domainapp network analyticsBases de datos
Crea bases de datos MongoDB, MySQL, PostgreSQL y Redis, inícialas o detenlas, descarga el certificado TLS y rota la contraseña.
db createdb credentials reset
Cuidadosa, abierta y en tu idioma
En ocho idiomas
Los mensajes, la ayuda y las tablas siguen el idioma de visualización de tu sistema cada vez que usas la CLI. LC_ALL elige otro para un solo comando.
Sin ID que memorizar
La mayoría de los comandos toman la aplicación de squarecloud.app o listan las tuyas para que elijas una.
Pide confirmación
Eliminar, reemplazar todas las variables, restaurar un snapshot o purgar la caché pregunta antes, y los scripts pueden confirmar con un flag.
Código abierto
El código está en GitHub, y cada versión publica sus compilaciones con checksums SHA-256.
Un plan para cada etapa de tu proyecto
Empieza pequeño y escala cuando lo necesites, sin contratos de permanencia.
Hobby
Para validar ideas, bots y proyectos personales
Desde 12,49 BRL/mes ≈ 2,25 US$
- 1 GB de RAM
- 1 vCPU
- Hasta 4 proyectos
- Escala hasta 2 GB en el mismo plan
Standard
RecomendadoPara producción, con bases de datos y dominio propio
Desde 44,99 BRL/mes ≈ 8,10 US$
- 4 GB de RAM
- 4 vCPU
- Hasta 16 proyectos
- Escala hasta 8 GB en el mismo plan
Pro
Para alta escala, con snapshots diarios de las aplicaciones y analytics avanzado
Desde 124,99 BRL/mes ≈ 22,50 US$
- 12 GB de RAM
- 6 vCPU
- Hasta 48 proyectos
- Escala hasta 24 GB en el mismo plan
4,9 de 5 · 402 reseñas en Google + TrustpilotTrustpilot