Cómo convertir comandos docker run a Docker Compose

Por Sayaib SarkarActualizado el 4 min de lectura

En esta página 5 secciones

Respuesta corta: cada opción de docker run tiene su clave correspondiente en compose.yaml: -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.

La correspondencia entre opciones y claves

`docker run``compose.yaml`Notas
IMAGE (último argumento antes del comando)image:
argumentos después de la imagencommand:
--name dbcontainer_name: dbLa clave del servicio es lo que los demás servicios usan como nombre de host
-p 5432:5432ports:Entrecomíllalo: "5432:5432"
-e KEY=valueenvironment:O env_file: para un archivo .env
-v pgdata:/var/lib/...volumes:Los volúmenes con nombre también se declaran en el nivel superior
-v ./data:/datavolumes:Montaje enlazado; relativo al archivo Compose
--restart unless-stoppedrestart: unless-stopped
--network mynetnetworks:Declara también la red en el nivel superior
--health-cmd, --health-intervalhealthcheck:test, interval, timeout, retries
-d(ninguna)Usa docker compose up -d
--rm, -it(ninguna)Opciones interactivas para ejecuciones puntuales

Un ejemplo completo

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.

Terminal
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 yes

Convertidos, se convierten en un archivo con dos servicios:

YAML
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:yy sin 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 ./data) no la necesita.
  • Una comprobación de estado escrita como --health-cmd "…" se ejecuta en una shell, así que en Compose pasa a ser CMD-SHELL.

Saca los secretos del archivo

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 .env junto a compose.yaml, añade .env a .gitignore y haz referencia a ellos:

YAML
    environment:
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=app

Compose lee automáticamente .env del directorio del proyecto cuando sustituye los valores ${…}. Sube un .env.example con valores de ejemplo para que los demás sepan qué definir. .env Checker & Generator de DevSnip Pro compara ambos y genera .env.example por ti.

Compruébalo y arráncalo

Terminal
docker compose config
docker compose up -d
docker compose ps

docker 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://db:5432, no a localhost:5432. Desde tu propio equipo, los puertos publicados siguen funcionando en localhost.

Hazlo en VS Code

  1. Copia los comandos docker run del README. Puedes convertir varios a la vez, uno tras otro.
  2. Ejecuta DevSnip Pro: docker run → Compose, o busca «compose» en la barra lateral de herramientas de DevSnip Pro con Ctrl/Cmd+K.
  3. Pega los comandos o tómalos del editor activo. El compose.yaml se actualiza mientras escribes, con un recuento de servicios y avisos, como los secretos en línea.
  4. Guárdalo como compose.yaml en tu proyecto y ejecuta 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.

Pruébalo en tu propio editor

Gratis, sin cuenta y en local. Para VS Code 1.93+ e IDE de JetBrains en Windows, macOS o Linux.

code --install-extension sayaib.hue-console