Saltar al contenido

Herramienta gratuita

Convertidor de Docker Compose a Kubernetes

Pega un compose.yaml o un docker-compose.yml y selecciona Convertir. Cada servicio se convierte en un Deployment, los puertos publicados en Services, las variables de entorno pasan a ConfigMaps y Secrets, y los volúmenes con nombre reciben un PersistentVolumeClaim. Revisa el YAML, descárgalo como kubernetes.yaml y mira el resultado dibujado como un diagrama de Kubernetes.

Resultado de ejemplo

Diagrama de ejemplo dibujado a partir de un ejemplo de Compose a Kubernetes
Prueba un ejemploApp web con PostgresAPI replicada con Redis

Cómo funciona

  1. Pega tu archivo de Compose

    Pega el archivo completo, con anclas y campos de extensión. Las líneas version y los bloques x- no son un problema.

  2. Selecciona Convertir y el modo de valores

    Solo nombres es el modo predeterminado y deja todos los valores fuera del resultado. Cambia a Conservar valores para copiar los que no parecen secretos.

  3. Revisa, descarga o abre

    Completa los valores marcados, descarga kubernetes.yaml o abre el diagrama en Archboard. Para registrarte basta una cuenta de Google o GitHub.

Qué objetos de Kubernetes obtienes

  • Un Deployment por cada servicio de Compose con su imagen, sus puertos de contenedor, sus límites de recursos y el número de réplicas de deploy.replicas. Etiquetas y selectores usan app: y el nombre del servicio.
  • Un Service por cada servicio de Compose que publica puertos; port es el puerto publicado y targetPort el del contenedor. Cada puerto recibe un nombre como tcp-8080.
  • Las variables de entorno se reparten: ajustes normales en un ConfigMap y nombres que parecen contraseñas, tokens o claves en un Secret. Los secrets de primer nivel se convierten en objetos Secret con un valor provisional.
  • Un PersistentVolumeClaim por cada volumen con nombre declarado en el primer nivel y usado por un servicio, montado en la misma ruta del contenedor.

Trata el resultado como un primer borrador

Los manifiestos están pensados para leerlos y terminarlos, no para aplicarlos a ciegas. Los valores de Secret se escriben como REPLACE_ME, los valores vacíos del ConfigMap llevan un comentario set value y cada reclamación de volumen pide 1Gi con un comentario adjust size. Las comprobaciones de estado se marcan como not converted: sondas, clases de almacenamiento, ingress y namespaces quedan en tus manos. El resumen cuenta cuántos valores faltan por completar.

Lo que omite el conversor de Compose a Kubernetes

  • Charts de Helm, capas de Kustomize y plantillas: el resultado es un único archivo YAML simple con varios documentos.
  • Services para contenedores sin puertos publicados. Un servicio que solo usa expose, o que no tiene puertos, no recibe un Service; los avisos indican cuáles añadir a mano si otros servicios los llaman por su nombre.
  • Montajes bind, montajes tmpfs y volúmenes anónimos. Se cuentan en los avisos; no se crea ningún volumen hostPath.
  • La construcción de imágenes y el orden de depends_on. Un servicio que solo tiene una sección build recibe un nombre de imagen provisional, y depends_on se marca como not converted encima del Deployment.

Solo nombres o Conservar valores

Solo nombres copia los nombres de las variables y deja fuera valores, comandos y entrypoints, así que un archivo de Compose con credenciales reales nunca acaba en el resultado. Conservar valores copia los valores normales al ConfigMap y pasa command y entrypoint a args y command. Los nombres que parecen contraseñas, tokens o claves se escriben como REPLACE_ME en los dos modos.

Preguntas sobre Compose y Kubernetes

¿Cuántas réplicas recibe cada Deployment?

El número de réplicas se toma de deploy.replicas en el archivo de Compose. Un servicio sin ese campo recibe una réplica. Los límites de CPU y memoria de deploy.resources se conservan, y las unidades de memoria como 512m pasan a 512Mi.

¿Puedo ejecutar kubectl apply sobre el resultado de inmediato?

Solo después de revisarlo. Sustituye cada REPLACE_ME, completa los valores vacíos del ConfigMap, ajusta el tamaño de los volúmenes y añade los Services que mencionan los avisos. El archivo es YAML de Kubernetes simple: cuando esté completo, puedes aplicarlo, dividirlo o convertirlo en un chart de Helm.

¿Qué pasa con los nombres de servicio que Kubernetes no admite?

Los nombres se pasan a minúsculas y se acortan para cumplir las reglas de nombres de Kubernetes, y las referencias entre objetos usan el nombre ajustado. Los avisos cuentan cuántos nombres cambiaron para que los revises antes de aplicar el archivo.

¿Qué pasa cuando abro el diagrama en Archboard?

La vista previa no se guarda. Cuando seleccionas Abrir en Archboard, el diagrama de los objetos generados se guarda como un diagrama nuevo en tu espacio de trabajo, donde puedes reorganizarlo, anotarlo y compartirlo. El kubernetes.yaml en sí no se guarda: cópialo o descárgalo antes de salir.

¿El conversor de Compose a Kubernetes es gratis?

Sí. Convertir archivos, copiar los manifiestos y descargar el diagrama en SVG o PNG no requieren cuenta. Para abrir el diagrama en Archboard necesitas una cuenta gratuita.

Abre un lienzo en un minuto

Inicia sesión con Google o GitHub. Gratis para un asiento. Mejora el plan cuando se una el equipo.