Variables de entorno fuera de tu código
Guarda tokens, contraseñas y cadenas de conexión en la configuración de cada aplicación. Los valores quedan ocultos en pantalla, un .env entra con solo pegarlo y un reinicio aplica el cambio sin volver a subir nada.
Cómo funciona
Las variables pertenecen a la aplicación, no a los archivos que subes. Cambia una y el siguiente inicio ya la usa.
- 1
Añade o pega
Escribe una clave y su valor, pega líneas KEY=valor en un campo de clave o importa un archivo .env.
- 2
Guarda
Un solo guardado envía la lista completa. Los valores que el shell cortaría o expandiría van entre comillas.
- 3
Reinicia
Justo después de guardar, el panel te ofrece reiniciar. La aplicación arranca con los valores nuevos, sin volver a subir nada.
Los secretos quedan ocultos en pantalla
El editor en la configuración de tu aplicación oculta cada valor hasta que lo pides y mantiene juntas las claves relacionadas.
Valores ocultos
Los valores se ven como puntos. Revela uno con el ojo, cópialo sin revelarlo o haz clic en él para editarlo.
- Cada edición se confirma o se cancela por separado
- Mantén Shift para quitar una fila con un clic
Agrupadas por prefijo
Las claves con el mismo prefijo, como DB_HOST y DB_USER, aparecen juntas y en orden alfabético.
- Búsqueda por clave cuando la lista pasa de 15
- Un aviso aparece cuando quedan pocos espacios
Valores de Square Cloud
HOST, PORT y SQUARECLOUD_APP_ID vienen con cada aplicación, de solo lectura y con una nota sobre para qué sirve cada una.
- HOST 0.0.0.0 y PORT 80 para HTTP
- El ID de la propia aplicación, para tu código
- Hasta 256 variables por aplicación
- Claves de hasta 1024 caracteres, valores de hasta 4096
- En un workspace, solo los administradores abren el editor
- Incluido en todos los planes
Trae el .env que ya tienes
Importa un archivo .env y revísalo antes de que cambie nada: claves nuevas, claves que se reemplazarían y líneas que no pueden entrar, cada una con su número de línea y el motivo.
Pega líneas enteras
Pega varias líneas KEY=valor en un campo de clave y cada una se convierte en una fila. Una clave que ya tienes toma el valor pegado.
- Se tienen en cuenta los comentarios y el prefijo export
- Pegar en una fila con datos conserva esa variable
Defínelas al hacer deploy
El formulario de deploy también acepta variables y, cuando tu proyecto tiene un .env.example, te ofrece esas claves para que las completes.
- También lee .env.sample, .env.template y .env.dist
- Deja HOST y PORT a Square Cloud
Exporta o copia
Descarga todas las variables como un archivo de texto KEY=VALUE, o cópialas todas, para llevarlas a otra aplicación.
- Los valores salen entre comillas, listos para cargar
- Las filas sin clave quedan fuera
Los valores llegan a tu código tal como los escribiste
Tu aplicación carga sus variables a través de un shell, donde un espacio, un $ o un ; puede cortar o cambiar un valor. El editor pone esos valores entre comillas por ti.
Comillas donde hacen falta
Un valor con espacios o caracteres como
$,&,;,|o)va entre comillas simples cuando lo confirmas, lo importas o guardas.Comillas peligrosas rechazadas
Las comillas dobles alrededor de un valor con
$dejarían que el shell lo expanda, así que el editor te pide quitarlas o usar comillas simples.Claves siempre válidas
Los espacios en una clave se vuelven guiones bajos, y una clave no puede repetirse. Al importar, la clave debe empezar con una letra o
_.
Desde la terminal y la API
Las mismas variables están al alcance de la CLI, la acción de GitHub, la extensión de VS Code y la API REST.
squarecloud app env set DB_HOST=10.0.0.4 "GREETING=hi there"squarecloud app env set --from-file .envsquarecloud app env listDesde la versión 3.1.1, la CLI pone entre comillas los valores con espacios o símbolos. Mira todo lo que hace la CLI.
curl -X POST "https://api.squarecloud.app/v2/apps/$APP_ID/envs" \ -H "Authorization: $SQUARECLOUD_API_KEY" \ -H "Content-Type: application/json" \ -d '{"envs": {"NODE_ENV": "production", "LOG_LEVEL": "info"}}'curl -X POST "https://api.squarecloud.app/v2/apps/$APP_ID/restart" \ -H "Authorization: $SQUARECLOUD_API_KEY"Envía los valores como debe leerlos el shell, entre comillas simples cuando tengan espacios o símbolos. Un reinicio los aplica.
- GET
/v2/apps/{appId}/envsLista las variables de entorno de la aplicación.
- POST
/v2/apps/{appId}/envsAñade variables o cambia las existentes. Las demás siguen igual.
- PUT
/v2/apps/{appId}/envsReemplaza todas las variables por las que envíes.
- DELETE
/v2/apps/{appId}/envsElimina las variables que indiques.
- Las claves de API se pueden limitar a
envs:readoenvs:writey a una sola aplicación.
Preguntas sobre variables de entorno
¿Qué son las variables de entorno en Square Cloud?
¿Tengo que volver a hacer deploy después de cambiar una variable?
¿Qué variables proporciona Square Cloud?
¿Cómo guardo un valor con espacios, comillas o un $?
¿Puedo mantener un archivo .env en mi proyecto?
¿Quién puede ver los valores?
¿Cuántas variables puede tener una aplicación?
¿Los sitios estáticos tienen variables de entorno?
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