.env ↔ K8s / Compose
.env-Variablen in ein Kubernetes Secret (Base64-data oder stringData), eine ConfigMap, einen environment-Block für Docker Compose, JSON oder ein env für GitHub Actions umwandeln und ein Secret, eine ConfigMap oder einen Compose-Dienst zurück in .env dekodieren.
Läuft vollständig in Ihrem Browser – nichts, was Sie einfügen, wird hochgeladen.
Was Sie einfügen, verlässt diesen Tab nicht; die Umwandlung läuft im Speicher.
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-Werte werden als UTF-8-Base64 kodiert, genau das erwartet Kubernetes in 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
Kurzreferenz zu Secret und Compose
Kurzreferenz- KEY=VALUE
- Das dotenv-Format: ein Paar pro Zeile, export optional, # beginnt einen Kommentar, und Anführungszeichen erhalten Leerzeichen oder ein # im Wert.
- kubectl create secret generic app --from-env-file=.env
- Erzeugt ein Secret, dessen Schlüssel die Variablen der Datei sind — die Kommandozeilen-Variante dessen, was dieses Werkzeug schreibt.
- data vs stringData
- data enthält Base64 der UTF-8-Bytes und ist das, was die API zurückgibt; stringData nimmt Klartext und Kubernetes kodiert ihn beim Schreiben.
- printf %s "$VALUE" | base64
- Kodiert einen Wert von Hand. Nutzen Sie printf oder echo -n, denn ein Zeilenumbruch am Ende wird stillschweigend Teil des Geheimnisses.
- environment:
- In Compose reicht eine Map YAML-Strings direkt durch, während eine Liste - KEY=VALUE die Compose-Interpolation durchläuft und ${VAR}-Verweise auflöst.
- envFrom.secretRef
- Hängt jeden Schlüssel eines Secrets als Umgebungsvariable in den Container; envFrom.configMapRef macht dasselbe mit einer ConfigMap.
Häufige Fragen
Antworten unter dem WerkzeugNutzt ein Kubernetes Secret data oder stringData?
stringData nimmt Klartext und ist leichter zu lesen; data enthält Base64 und ist das, was die API zurückgibt. Beides beschreibt dasselbe Secret.
Der dekodierte Wert ist ein Zeichen länger.
echo hängt vor dem Base64-Kodieren einen Zeilenumbruch an. Mit printf %s oder echo -n landet er nicht im Secret.
Lässt sich ein Secret zurück in .env wandeln?
Ja. Secret, ConfigMap oder Compose-Service einfügen und die Gegenrichtung wählen; die Werte kommen als KEY=VALUE-Zeilen zurück.
Passende Docker-Syntax-Guides
Alle Docker-GuidesDocker: 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.