.env ↔ K8s / Compose
Converte variáveis .env em um Secret do Kubernetes (data em Base64 UTF-8 ou stringData), um ConfigMap, um bloco environment do Docker Compose, JSON ou um env do GitHub Actions, e decodifica um Secret, ConfigMap ou serviço do Compose de volta para .env.
Roda totalmente no seu navegador: nada do que você cola é enviado.
O que você cola não sai desta aba; a conversão roda na memória.
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==
Os valores do Secret são codificados em Base64 UTF-8, que é o que o Kubernetes espera em 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
Referência de Secret do Kubernetes e Compose
referência rápida- KEY=VALUE
- O formato dotenv: um par por linha, export opcional, # inicia um comentário e as aspas preservam espaços ou um # dentro do valor.
- kubectl create secret generic app --from-env-file=.env
- Cria um Secret cujas chaves são as variáveis do arquivo: a versão de linha de comando do que esta ferramenta escreve.
- data vs stringData
- data guarda Base64 dos bytes UTF-8 e é o que a API devolve; stringData aceita texto puro e o Kubernetes codifica ao gravar o objeto.
- printf %s "$VALUE" | base64
- Codifica um valor à mão. Use printf ou echo -n, porque uma quebra de linha no fim vira parte do segredo sem aviso.
- environment:
- No Compose um mapa passa as strings YAML direto, enquanto a lista - KEY=VALUE passa pela interpolação do Compose e aceita referências ${VAR}.
- envFrom.secretRef
- Injeta cada chave de um Secret como variável de ambiente no contêiner; envFrom.configMapRef faz o mesmo com um ConfigMap.
Perguntas frequentes
respostas abaixo da ferramentaO Secret do Kubernetes usa data ou stringData?
stringData aceita texto puro e é mais fácil de ler; data leva Base64 e é o que a API devolve. Os dois descrevem o mesmo Secret.
O valor decodificado tem um caractere a mais.
O echo adiciona uma quebra de linha antes de codificar. Use printf %s ou echo -n para a quebra não entrar no segredo.
Consigo voltar de um Secret para .env?
Sim. Cole o Secret, o ConfigMap ou o serviço do Compose e escolha a direção inversa; os valores voltam como linhas KEY=VALUE.
Guias de sintaxe de Docker
Todos os guias 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.