.env ↔ K8s / Compose
Convierte variables .env en un Secret de Kubernetes (data en Base64 UTF-8 o stringData), un ConfigMap, un bloque environment de Docker Compose, JSON o un env de GitHub Actions, y decodifica un Secret, ConfigMap o servicio de Compose a .env.
Se ejecuta por completo en tu navegador: nada de lo que pegues se sube.
Lo que pegas no sale de esta pestaña; la conversión se ejecuta en memoria.
apiVersion: v1 kind: Secret metadata: name: app-secrets type: Opaque data: NEXT_PUBLIC_SUPABASE_URL: aHR0cHM6Ly94eXpjb21wYW55LnN1cGFiYXNlLmNv NEXT_PUBLIC_SUPABASE_ANON_KEY: ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SnliMnhsSWpvaVlXNXZiaUo5LmRlbW8= SUPABASE_SERVICE_ROLE_KEY: c2VydmljZS1yb2xlLWtleS1mcm9tLXRoZS1kYXNoYm9hcmQ= DATABASE_URL: cG9zdGdyZXM6Ly9wb3N0Z3Jlczpwd0BkYi5pbnRlcm5hbDo1NDMyL2FwcA== NODE_ENV: cHJvZHVjdGlvbg==
Los valores del Secret se codifican en Base64 UTF-8, que es lo que Kubernetes espera en data.
- NEXT_PUBLIC_SUPABASE_URLhttps://xyzcompany.supabase.co
- NEXT_PUBLIC_SUPABASE_ANON_KEYeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiJ9.demo
- SUPABASE_SERVICE_ROLE_KEYservice-role-key-from-the-dashboard
- DATABASE_URLpostgres://postgres:pw@db.internal:5432/app
Referencia de Secret de Kubernetes y Compose
referencia rápida- KEY=VALUE
- El formato dotenv: un par por línea, export opcional, # inicia un comentario y las comillas conservan espacios o un # dentro del valor.
- kubectl create secret generic app --from-env-file=.env
- Crea un Secret cuyas claves son las variables del archivo: la versión de línea de comandos de lo que escribe esta herramienta.
- data vs stringData
- data guarda Base64 de los bytes UTF-8 y es lo que devuelve la API; stringData acepta texto plano y Kubernetes lo codifica al escribir el objeto.
- printf %s "$VALUE" | base64
- Codifica un valor a mano. Usa printf o echo -n, porque un salto de línea final se convierte en parte del secreto sin avisar.
- environment:
- En Compose un mapa pasa las cadenas YAML tal cual, mientras que una lista - KEY=VALUE pasa por la interpolación de Compose y admite referencias ${VAR}.
- envFrom.secretRef
- Inyecta cada clave de un Secret como variable de entorno en un contenedor; envFrom.configMapRef hace lo mismo con un ConfigMap.
Preguntas frecuentes
respuestas bajo la herramienta¿Un Secret de Kubernetes usa data o stringData?
stringData acepta texto plano y se lee mejor; data lleva Base64 y es lo que devuelve la API. Los dos describen el mismo Secret.
El valor decodificado tiene un carácter de más.
echo añade un salto de línea antes de codificar. Usa printf %s o echo -n para que no acabe dentro del secreto.
¿Puedo volver de un Secret a .env?
Sí. Pega el Secret, el ConfigMap o el servicio de Compose y elige la dirección inversa; vuelven como líneas KEY=VALUE.
Guías de sintaxis de Docker
Todas las guías de DockerDocker: exec user process caused: exec format error
An arm64 image on an amd64 host is a runtime failure, not a pull failure. Diagnose the platform, build for the target, publish multi-arch, and spot the script variant.
DockerDocker Compose: bind: address already in use and Port Conflicts
A published port is a host socket, and two projects cannot own it. How to find the real owner, why an override file merged instead of replacing, and how to publish dynamically.
DockerAlpine musl vs Debian slim: DNS Timeouts and Native Builds
musl rejects manylinux wheels and linux-x64-gnu prebuilds, so the installer starts compiling without a toolchain. And ndots:5 in Kubernetes adds five seconds per lookup.
DockerDocker Compose Connection Refused: localhost vs Service DNS
localhost inside a container is that container. Compose resolves service names on a shared network, depends_on does not wait for readiness, and binding loopback breaks the rest.