TAREAGuide

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. 1

    En la matriz del proyecto, haz clic en `Importar variáveis` (Importar variables).

    El asistente se abre en dos pasos.

  2. 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. 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) o igual (igual), además de los avisos del parser, y permite excluir filas. Nada se guarda en este paso.

  4. 4

    Haz clic en `Importar N chave(s)` (Importar N clave(s)).

    resultado
    Las 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 .env escapa 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 .env o JSON en esos casos.

Límites

LímiteValor
Claves por escritura en lote1000 — la CLI trocea archivos más grandes automáticamente
Tamaño de cada valor64 KiB
Comentario por clave500 caracteres
Contenido de importación1 MiB
Entornos en la creación del proyecto20, 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.

Siguiente