Cómo convertir comandos docker run a Docker Compose
En esta página 5 secciones
Respuesta corta: cada opción de docker run tiene su clave correspondiente en compose.: -p pasa a ports, -e a environment, -v a volumes, --restart a restart, y la imagen y los argumentos finales pasan a image y command. Convierte opción por opción, declara los volúmenes con nombre al final y comprueba el archivo con docker compose config. La herramienta docker run → Compose de DevSnip Pro hace la conversión en VS Code, para uno o varios comandos a la vez.
Los README suelen mostrar cómo arrancar un servicio con un largo comando docker run. Una vez está bien. Cuando un proyecto necesita una base de datos y una caché a diario, un archivo Compose es más fácil de leer, versionar y compartir: docker compose up -d lo arranca todo y docker compose down lo detiene.
| `docker run` | `compose.yaml` | Notas |
|---|---|---|
IMAGE (último argumento antes del comando) | image: | |
| argumentos después de la imagen | command: | |
--name db | container_name: db | La clave del servicio es lo que los demás servicios usan como nombre de host |
-p 5432:5432 | ports: | Entrecomíllalo: "5432:5432" |
-e KEY=value | environment: | O env_file: para un archivo . |
-v pgdata:/ | volumes: | Los volúmenes con nombre también se declaran en el nivel superior |
-v . | volumes: | Montaje enlazado; relativo al archivo Compose |
--restart unless-stopped | restart: unless-stopped | |
--network mynet | networks: | Declara también la red en el nivel superior |
--health-cmd, --health-interval | healthcheck: | test, interval, timeout, retries |
-d | (ninguna) | Usa docker compose up -d |
--rm, -it | (ninguna) | Opciones interactivas para ejecuciones puntuales |
Estos son dos comandos que podrías encontrar en las notas de configuración de un proyecto: PostgreSQL con un volumen con nombre y una comprobación de estado, y Redis con la persistencia activada.
docker run -d --name db -p 5432:5432 \
-e POSTGRES_PASSWORD=secret -e POSTGRES_DB=app \
-v pgdata:/var/lib/postgresql/data \
--restart unless-stopped \
--health-cmd "pg_isready -U postgres" --health-interval 10s \
postgres:16-alpine
docker run -d --name cache -p 6379:6379 redis:7-alpine redis-server --appendonly yesConvertidos, se convierten en un archivo con dos servicios:
services:
db:
image: postgres:16-alpine
container_name: db
ports:
- "5432:5432"
environment:
- POSTGRES_PASSWORD=secret
- POSTGRES_DB=app
volumes:
- pgdata:/var/lib/postgresql/data
restart: unless-stopped
healthcheck:
test:
- CMD-SHELL
- pg_isready -U postgres
interval: 10s
cache:
image: redis:7-alpine
container_name: cache
ports:
- "6379:6379"
command:
- redis-server
- --appendonly
- yes
volumes:
pgdata:Tres detalles son fáciles de equivocar a mano:
- Las correspondencias de puertos van entre comillas. YAML puede leer algunos valores
xx:yysin comillas como números en base 60. Entrecomillar todas las correspondencias de puertos evita el problema. - Los volúmenes con nombre necesitan una entrada
volumes:en el nivel superior. Sin ella, Compose se niega a arrancar. Un montaje enlazado (una ruta como.) no la necesita./ data - Una comprobación de estado escrita como
--health-cmd "…"se ejecuta en una shell, así que en Compose pasa a serCMD-SHELL.
El ejemplo deja POSTGRES_PASSWORD=secret en línea, lo que está bien para una base de datos local de usar y tirar, pero no para un archivo que vas a subir al repositorio. Pon los valores en un archivo . junto a compose., añade . a . y haz referencia a ellos:
environment:
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=appCompose lee automáticamente . del directorio del proyecto cuando sustituye los valores ${…}. Sube un . con valores de ejemplo para que los demás sepan qué definir. .env Checker & Generator de DevSnip Pro compara ambos y genera . por ti.
docker compose config
docker compose up -d
docker compose psdocker compose config valida el archivo y lo muestra completamente resuelto, con las variables sustituidas, así que los errores aparecen antes de que arranque nada. Dentro de la red de Compose, los servicios se comunican por nombre de servicio: un contenedor de la aplicación se conecta a postgres:/, no a localhost:5432. Desde tu propio equipo, los puertos publicados siguen funcionando en localhost.
- Copia los comandos
docker rundel README. Puedes convertir varios a la vez, uno tras otro. - Ejecuta DevSnip Pro: docker run → Compose, o busca «compose» en la barra lateral de herramientas de DevSnip Pro con Ctrl/Cmd+K.
- Pega los comandos o tómalos del editor activo. El
compose.se actualiza mientras escribes, con un recuento de servicios y avisos, como los secretos en línea.yaml - Guárdalo como
compose.en tu proyecto y ejecutayaml docker compose config.
La herramienta gestiona puertos, variables de entorno, volúmenes, redes, políticas de reinicio, comprobaciones de estado, límites de recursos y GPU. Para un servicio nuevo en lugar de un comando existente, Docker Compose Generator & Validator y Dockerfile Generator & Linter, de la misma sección, parten de tu stack.