如何将 docker run 命令转换为 Docker Compose

作者:Sayaib Sarkar更新于 阅读约 4 分钟

本页内容 5 个小节

简短回答:每个 docker run 参数在 compose.yaml 中都有对应的键:-p 变成 ports,-e 变成 environment,-v 变成 volumes,--restart 变成 restart,镜像和末尾的参数则变成 image 和 command。逐个参数转换,在文件末尾声明命名卷,然后用 docker compose config 检查文件。DevSnip Pro 的 docker run → Compose 工具可以在 VS Code 中完成转换,一次处理一条或多条命令。

README 中通常用一条长长的 docker run 命令来演示如何启动服务。用一次没问题,但当项目每天都需要数据库和缓存时,Compose 文件更易于阅读、提交和分享:docker compose up -d 启动所有服务,docker compose down 则全部停止。

参数与键的对应关系

`docker run``compose.yaml`说明
IMAGE(命令前的最后一个参数)image:
镜像后面的参数command:
--name dbcontainer_name: db其他服务会把服务键用作主机名
-p 5432:5432ports:加上引号:"5432:5432"
-e KEY=valueenvironment:或用 env_file: 指定 .env 文件
-v pgdata:/var/lib/...volumes:命名卷还需要在顶层声明
-v ./data:/datavolumes:绑定挂载;相对于 Compose 文件
--restart unless-stoppedrestart: unless-stopped
--network mynetnetworks:网络也需要在顶层声明
--health-cmd、--health-intervalhealthcheck:test、interval、timeout、retries
-d(无)使用 docker compose up -d
--rm、-it(无)一次性运行时的交互选项

完整示例

下面是你可能在项目配置说明中看到的两条命令:带命名卷和健康检查的 PostgreSQL,以及开启持久化的 Redis。

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

转换后,它们会变成一个包含两个服务的文件:

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:

有三个细节手动转换时很容易出错:

  • 端口映射要加引号。YAML 可能会把某些不带引号的 xx:yy 值解析为六十进制数字。给每个端口映射加上引号即可避免这个问题。
  • 命名卷需要顶层的 volumes: 条目。缺少它,Compose 会拒绝启动。绑定挂载(例如 ./data 这样的路径)则不需要。
  • 以 --health-cmd "…" 编写的健康检查会在 Shell 中运行,因此在 Compose 中要写成 CMD-SHELL。

把密钥移出文件

示例中把 POSTGRES_PASSWORD=secret 直接写在文件里,对于用完即弃的本地数据库没问题,但不适合要提交的文件。把这些值放到 compose.yaml 旁边的 .env 文件中,把 .env 加入 .gitignore,然后引用它们:

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

Compose 在替换 ${…} 值时会自动读取项目目录下的 .env。提交一个带占位值的 .env.example,让其他人知道需要设置什么。DevSnip Pro 的 .env Checker & Generator 会比较这两个文件,并为你生成 .env.example。

先检查,再启动

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

docker compose config 会校验文件,并输出完全解析、变量已替换的结果,让错误在启动前就暴露出来。在 Compose 网络内部,服务之间通过服务名互相访问:应用容器连接的是 postgres://db:5432,而不是 localhost:5432。在你自己的电脑上,发布的端口仍然可以通过 localhost 访问。

在 VS Code 中完成

  1. 从 README 中复制 docker run 命令。可以一次转换多条,逐条排列即可。
  2. 运行 DevSnip Pro: docker run → Compose,或在 DevSnip Pro 工具侧边栏中按 Ctrl/Cmd+K 搜索“compose”。
  3. 粘贴命令,或从当前编辑器中读取。compose.yaml 会随着输入实时更新,并显示服务数量和警告,例如明文写入的密钥。
  4. 将其保存为项目中的 compose.yaml,然后运行 docker compose config。

该工具支持端口、环境变量、卷、网络、重启策略、健康检查、资源限制和 GPU。如果要创建新服务而不是转换现有命令,同一分区中的 Docker Compose Generator & Validator 和 Dockerfile Generator & Linter 会从你的技术栈出发生成配置。

在你自己的编辑器中试试

免费、无需账号、本地运行。支持 Windows、macOS 和 Linux 上的 VS Code 1.93+ 与 JetBrains IDE。

code --install-extension sayaib.hue-console