.env ↔ K8s / Compose
.env 변수를 Kubernetes Secret(UTF-8 Base64 또는 stringData)이나 ConfigMap, Docker Compose environment 블록, JSON, GitHub Actions env로 변환하고, Secret·ConfigMap·Compose 서비스를 다시 .env로 풀어냅니다.
브라우저 안에서만 실행됩니다. 입력한 내용은 어디에도 업로드되지 않습니다.
붙여넣은 값은 이 브라우저 탭을 벗어나지 않습니다. 변환은 메모리에서 실행됩니다.
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==
Secret 값은 UTF-8 기준 Base64로 인코딩됩니다. Kubernetes의 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
Kubernetes Secret·Compose 참고
빠른 참조- KEY=VALUE
- dotenv 형식입니다. 한 줄에 하나씩 쓰고 export는 생략할 수 있으며, #은 주석을 시작하고 따옴표는 공백이나 값 안의 #을 보존합니다.
- kubectl create secret generic app --from-env-file=.env
- 이 파일의 변수를 키로 하는 Secret을 만듭니다. 이 툴이 출력하는 YAML의 명령줄 버전입니다.
- data vs stringData
- data는 UTF-8 바이트를 Base64로 담고 API가 돌려주는 형태이며, stringData는 평문을 받아 객체를 쓸 때 Kubernetes가 인코딩합니다.
- printf %s "$VALUE" | base64
- 값 하나를 직접 인코딩합니다. echo -n이나 printf를 쓰세요. 끝의 줄바꿈이 조용히 비밀값의 일부가 됩니다.
- environment:
- Compose에서 맵 형식은 YAML 문자열을 그대로 전달하고, - KEY=VALUE 리스트는 Compose 보간을 거쳐 ${VAR} 참조를 처리합니다.
- envFrom.secretRef
- Secret의 모든 키를 컨테이너 환경 변수로 넣습니다. envFrom.configMapRef는 ConfigMap에 같은 일을 합니다.
자주 묻는 질문
도구 아래에서 답을 확인하세요Kubernetes Secret은 data와 stringData 중 무엇을 쓰나요?
stringData는 평문이라 읽기 쉽고, data는 Base64로 API가 돌려주는 형태입니다. 같은 Secret의 두 표현입니다.
디코딩한 값이 한 글자 깁니다.
echo가 줄바꿈을 붙여 Base64로 인코딩하기 때문입니다. printf %s나 echo -n을 쓰면 줄바꿈이 값에 섞이지 않습니다.
Secret을 다시 .env로 되돌릴 수 있나요?
가능합니다. Secret, ConfigMap, Compose 서비스를 붙여 넣고 역방향을 고르면 KEY=VALUE 줄로 돌아옵니다.
Docker 관련 문법 가이드
Docker 가이드 전체Docker: 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.