Docker-Compose-zu-Kubernetes-Konverter
Füge eine docker-compose.yml ein und erhalte Kubernetes-Manifeste: ein Deployment und einen Service pro Dienst, ConfigMaps für Umgebungsvariablen, ein Secret für Passwörter, PersistentVolumeClaims für Volumes und Probes aus Healthchecks. Hinweise erklären jede Einstellung, die deine Aufmerksamkeit braucht.
Zuletzt aktualisiert:
Anleitung: Docker-Compose-zu-Kubernetes-Konverter
- Füge deine docker-compose.yml ein oder öffne die Datei. Zuerst wird ein Beispiel mit Webserver, API, Datenbank und Cache geladen.
- Wähle die Optionen: Namespace, Service-Typ, Umgang mit Umgebungsvariablen und Bind Mounts sowie PVC-Größe.
- Lies die Hinweise unter der Ausgabe. Sie markieren Dinge, die Compose anders macht als Kubernetes, etwa depends_on oder lokal gebaute Images.
- Filtere nach Typ, um Deployments, Services oder PVCs einzeln zu prüfen, und kopiere oder lade dann das YAML oder ein ZIP herunter.
- Wende es an mit
kubectl apply -f k8s.yamlund prüfe die Pods mitkubectl get pods.
So werden Compose-Schlüssel auf Kubernetes abgebildet
| docker-compose.yml | Kubernetes | Hinweise |
|---|---|---|
| Dienst | Deployment + Service | Labels app.kubernetes.io/name verbinden sie |
image, command und entrypoint | image, args und command | Kubernetes-command ersetzt den ENTRYPOINT des Images |
ports: "8080:80" und expose | Service-port bzw. -targetPort | Host-Ports gelten nur für NodePort (30000-32767) |
environment | ConfigMap + envFrom | Sensible Namen kommen in ein Secret |
env_file | kubectl create configmap --from-env-file | Die Datei ist im Browser nicht verfügbar |
| benanntes Volume | PersistentVolumeClaim | Standardmäßig ReadWriteOnce |
| per Bind Mount eingebundene Datei | ConfigMap mit subPath | Aus der echten Datei befüllen |
healthcheck | livenessProbe und readinessProbe | interval → periodSeconds, retries → failureThreshold, start_period → initialDelaySeconds |
deploy.replicas | spec.replicas | deploy.mode: global wird zum DaemonSet |
deploy.resources, mem_limit und cpus | resources.limits bzw. requests | 512M → 512Mi, 0.5 CPU → 500m |
user, cap_add, privileged und read_only | securityContext | runAsUser braucht eine numerische UID |
depends_on, networks und container_name | (keine) | Probes, NetworkPolicies und Service-Namen nutzen |
Nach der Umwandlung: eine kurze Checkliste
- Images: Jedes Deployment muss auf ein Image in einer Registry verweisen, aus der der Cluster ziehen kann, idealerweise mit festem Tag.
- Secrets: Ersetze Platzhalter-Passwörter und halte echte Secret-Werte aus Git heraus (nutze Sealed Secrets, SOPS oder einen External Secrets Operator).
- Speicher: Prüfe die PVC-Größen und die Storage Class. Datenbanken gehören meist in ein StatefulSet, sobald ein einzelnes Replikat nicht mehr reicht.
- Traffic: Füge für öffentliche HTTP-Dienste ein Ingress oder Gateway hinzu, statt jeden Port als LoadBalancer freizugeben.
- Ressourcen: Setze CPU- und Speicher-Requests für jeden Container, damit der Scheduler Pods sinnvoll platzieren kann.
- Validiere das Ergebnis mit dem Kubernetes-YAML-Validator und speichere Passwörter mit dem Kubernetes-Secret-Generator.
Häufige Fragen
Kann Kubernetes eine docker-compose.yml direkt ausführen?
Nein. Kubernetes verwendet eigene Ressourcentypen, daher muss eine Compose-Datei übersetzt werden: Jeder Dienst wird zu einem Deployment, das die Pods ausführt, und, falls er Ports hat, zu einem Service, der ihm einen stabilen Namen und eine feste Adresse gibt. Dieses Tool erledigt diese Übersetzung in deinem Browser, ähnlich wie das Kommandozeilentool kompose.
Wie finden sich die Dienste nach der Umwandlung?
Jeder Service behält den Namen des Compose-Dienstes, und das Kubernetes-DNS löst diesen Namen innerhalb des Namespace auf, sodass eine App, die sich mit db:5432 verbindet, weiter funktioniert. Aus einem anderen Namespace verwendest du db.namespace.svc.cluster.local. Namen mit Unterstrichen oder Großbuchstaben werden umbenannt, weil Kubernetes-Namen DNS-Labels in Kleinbuchstaben sein müssen.
Was passiert mit depends_on?
Kubernetes kennt keine Startreihenfolge zwischen Deployments; alle Pods starten gleichzeitig. Lass jede App ihre Verbindungen wiederholen, verlass dich auf Readiness-Probes, damit Traffic nur bereite Pods erreicht, oder füge einen Init-Container hinzu, der auf die Abhängigkeit wartet.
Wie werden Volumes umgewandelt?
Benannte Volumes werden zu PersistentVolumeClaims, die unter demselben Pfad eingehängt werden, und Deployments, die eines nutzen, erhalten die Strategie Recreate, damit der alte Pod das Volume zuerst freigibt. Eine einzelne per Bind Mount eingebundene Datei wie nginx.conf wird zu einer ConfigMap, eingehängt mit subPath. Per Bind Mount eingebundene Ordner werden je nach gewählter Option zu einem PVC, emptyDir oder hostPath.
Warum ist mein veröffentlichter Port ein ClusterIP-Service?
Ein ClusterIP-Service ist nur innerhalb des Clusters erreichbar, was die sichere Voreinstellung ist. Um ihn von außen zu erreichen, wähle in den Optionen NodePort oder LoadBalancer, füge für HTTP-Traffic ein Ingress hinzu oder nutze beim Testen kubectl port-forward.
Was ist mit Images, die mit build: gebaut werden?
Kubernetes-Nodes ziehen Images aus einer Registry; sie können nicht aus einem Dockerfile in deinem Projekt bauen. Baue das Image, pushe es in eine Registry, die der Cluster erreichen kann, und trage diesen Image-Namen im Deployment ein. Das Tool markiert diese Dienste mit einem roten Hinweis.
Wird meine Compose-Datei hochgeladen?
Nein. Das YAML wird mit JavaScript in deinem Browser-Tab geparst und umgewandelt, sodass Passwörter und interne Hostnamen aus der Datei nie deinen Computer verlassen.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.