Importar y exportar variables
Trae un .env completo a un proyecto con previsualización antes de guardar, y descarga un entorno completo en el formato que consume tu deploy.
Importa un .env
- 1
En la matriz del proyecto, haz clic en `Importar variáveis` (Importar variables).
El asistente se abre en dos pasos.
- 2
En el paso `Conteúdo` (Contenido): proporciona el texto y marca los `Ambientes de destino` (Entornos de destino).
Arrastra un archivo, elige uno o pega el texto (límite de 1 MiB). Cada entorno de destino tiene el interruptor
só as chaves (valor vazio)(solo las claves, valor vacío), que siembra la estructura sin copiar valores — útil para crear las lagunas de producción a partir de dev. - 3
Haz clic en `Pré-visualizar` (Previsualizar) y revisa la tabla.
El texto bruto va al servidor, cuyo parser endurecido (PEM multilínea, comentarios, comillas, BOM, CRLF, duplicados) es la fuente de la verdad. La tabla muestra, por clave y por entorno, el badge
nova(nueva),muda(cambia) oigual(igual), además de los avisos del parser, y permite excluir filas. Nada se guarda en este paso. - 4
Haz clic en `Importar N chave(s)` (Importar N clave(s)).
resultadoLas claves se escriben en los entornos marcados y la matriz refleja el resultado.
Importar nunca borra
La escritura tiene semántica de merge: las claves ausentes del archivo permanecen intactas. Reimportar el mismo archivo es un no-op — no se escribe ninguna versión nueva.
Exporta un entorno
Exportar variáveis (Exportar variables) descarga un entorno completo en .env, JSON, YAML o Docker (--env-file). La descarga sale en texto plano y se audita — una línea en el historial del proyecto listando las claves exportadas.
- La exportación
.envescapa saltos de línea y tabulaciones dentro de comillas, así que un export reimportado es fiel al byte — claves PEM y tokens con CRLF sobreviven a la ida y vuelta. - El formato Docker no representa saltos de línea: si algún valor es multilínea, el servidor rechaza la exportación nombrando las claves, en vez de emitir un archivo roto. Usa
.envoJSONen esos casos.
Límites
| Límite | Valor |
|---|---|
| Claves por escritura en lote | 1000 — la CLI trocea archivos más grandes automáticamente |
| Tamaño de cada valor | 64 KiB |
| Comentario por clave | 500 caracteres |
| Contenido de importación | 1 MiB |
| Entornos en la creación del proyecto | 20, con nombres de hasta 40 caracteres |
- Comentarios en la escritura en lote: una clave sin comentario nuevo mantiene el comentario almacenado; un comentario idéntico al almacenado cuenta como igual (reenviar el mismo formulario no genera versión); una cadena vacía limpia el comentario.