Generar Docker Compose Gratis – Tu docker-compose.yml sin Escribir YAML

Usa el Generador de Docker Compose gratuito abajo: tus datos nunca salen de tu navegador, todo el trabajo ocurre en tu dispositivo y no se sube a ningún servidor.

¿Qué es Docker Compose?

Docker Compose permite describir toda una aplicación de varios contenedores en un solo archivo YAML, normalmente llamado docker-compose.yml. En lugar de memorizar comandos docker run largos para cada servicio, escribes una vez los servicios, sus imágenes, puertos, variables de entorno y volúmenes, y luego arrancas todo con docker compose up. Un servidor web, una aplicación y una base de datos se convierten en tres bloques cortos en un archivo, y Compose los conecta en una red compartida para que puedan encontrarse por el nombre del servicio.

Esto importa porque las aplicaciones reales rara vez son un solo contenedor. Un proyecto típico tiene una parte frontal, una parte trasera y una base de datos, y cada una necesita ajustes distintos. Sin Compose, haces malabares con ventanas de terminal y comandos largos, y tarde o temprano escribes mal un puerto u olvidas un volumen y pierdes datos. Con Compose, la configuración queda escrita, bajo control de versiones y se puede repetir. Un compañero nuevo clona el repositorio, ejecuta un comando y obtiene la misma pila que tienes tú.

Cómo usar el generador de Compose

Añade una fila por servicio. Cada fila necesita un nombre y una imagen. El nombre es la forma en que otros servicios lo encuentran: un servicio web puede hablar con un servicio de base de datos llamado db usando simplemente db como nombre de host. La imagen es la imagen del contenedor, como nginx:alpine o postgres:16. Los puertos usan la forma host:contenedor, así que 8080:80 significa que el puerto 8080 de tu máquina reenvía al puerto 80 dentro del contenedor. Las variables de entorno van en forma CLAVE=valor, y los volúmenes en forma ruta-del-host:ruta-del-contenedor para los datos que quieres conservar.

El generador construye el YAML con la librería js-yaml directamente en tu navegador, así que el resultado sigue las reglas reales de YAML: sangría, listas y comillas se resuelven por ti. Pulsa Generar, revisa el resultado y guárdalo como docker-compose.yml en la carpeta de tu proyecto. Luego ejecuta docker compose up para arrancar la pila, docker compose down para detenerla y docker compose logs para ver qué imprimió cada servicio. Si un servicio falla, sus registros suelen ser la pista más rápida.

Un ejemplo completo

Imagina un sitio pequeño con una parte frontal estática y una API. Añades un servicio llamado web con imagen nginx:alpine y puerto 8080:80, y un servicio llamado api con imagen node:20-alpine y puerto 3000:3000. Le das a la API una variable de entorno como NODE_ENV=production y un volumen para su carpeta de subidas. Compose arranca ambos, los pone en una red y el servicio web puede llegar a la API en http://api:3000. Nunca tuviste que buscar una dirección IP, porque Compose tiene su propio DNS para los nombres de servicio.

Para una base de datos, añade un servicio llamado db con imagen postgres:16, un puerto como 5432:5432 solo si necesitas llegar desde tu máquina, una variable de entorno para la contraseña y un volumen con nombre para su directorio de datos. El volumen es la parte importante. Sin él, un docker compose down -v borraría tus datos. Con él, tus datos sobreviven a los reinicios. Nunca guardes contraseñas reales en el archivo si el repositorio se comparte; usa un archivo env o los secretos de tu plataforma, y guarda un docker-compose.example.yml con valores de ejemplo para que otros lo copien.

Consejos y errores comunes

Un error común es asignar el mismo puerto del host dos veces, lo que falla con un error de puerto ya en uso. Otro es olvidar que los contenedores en la misma red de Compose hablan por los puertos del contenedor, no por los del host, así que a la API se llega por el 3000 dentro de la red aunque la hayas publicado como 3001 fuera. Un tercer error es meter pasos de construcción en un archivo Compose que solo lista imágenes. Compose también puede construir desde un Dockerfile con un bloque build, pero para una primera versión, las imágenes publicadas mantienen las cosas simples.

Mantén los nombres de servicio cortos y en minúsculas, guarda el archivo bajo control de versiones y prueba docker compose up desde una copia limpia antes de compartirlo. Si funciona en una copia recién clonada, funcionará para tus compañeros. El generador te da un archivo inicial válido; tu trabajo es revisarlo, sustituir los valores de ejemplo por tus ajustes reales y hacerlo crecer despacio a medida que crezca tu pila.

Herramientas relacionadas

• Docker Compose Generator (English version)
• Calculadora de Versiones Semver
• Calculadora de Permisos Chmod