如何将 docker run 命令转换为 Docker Compose
本页内容 5 个小节
简短回答:每个 docker run 参数在 compose. 中都有对应的键:-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 db | container_name: db | 其他服务会把服务键用作主机名 |
-p 5432:5432 | ports: | 加上引号:"5432:5432" |
-e KEY=value | environment: | 或用 env_file: 指定 . 文件 |
-v pgdata:/ | volumes: | 命名卷还需要在顶层声明 |
-v . | volumes: | 绑定挂载;相对于 Compose 文件 |
--restart unless-stopped | restart: unless-stopped | |
--network mynet | networks: | 网络也需要在顶层声明 |
--health-cmd、--health-interval | healthcheck: | test、interval、timeout、retries |
-d | (无) | 使用 docker compose up -d |
--rm、-it | (无) | 一次性运行时的交互选项 |
下面是你可能在项目配置说明中看到的两条命令:带命名卷和健康检查的 PostgreSQL,以及开启持久化的 Redis。
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转换后,它们会变成一个包含两个服务的文件:
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. 旁边的 . 文件中,把 . 加入 .,然后引用它们:
environment:
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=appCompose 在替换 ${…} 值时会自动读取项目目录下的 .。提交一个带占位值的 .,让其他人知道需要设置什么。DevSnip Pro 的 .env Checker & Generator 会比较这两个文件,并为你生成 .。
docker compose config
docker compose up -d
docker compose psdocker compose config 会校验文件,并输出完全解析、变量已替换的结果,让错误在启动前就暴露出来。在 Compose 网络内部,服务之间通过服务名互相访问:应用容器连接的是 postgres:/,而不是 localhost:5432。在你自己的电脑上,发布的端口仍然可以通过 localhost 访问。
- 从 README 中复制
docker run命令。可以一次转换多条,逐条排列即可。 - 运行 DevSnip Pro: docker run → Compose,或在 DevSnip Pro 工具侧边栏中按 Ctrl/Cmd+K 搜索“compose”。
- 粘贴命令,或从当前编辑器中读取。
compose.会随着输入实时更新,并显示服务数量和警告,例如明文写入的密钥。yaml - 将其保存为项目中的
compose.,然后运行yaml docker compose config。
该工具支持端口、环境变量、卷、网络、重启策略、健康检查、资源限制和 GPU。如果要创建新服务而不是转换现有命令,同一分区中的 Docker Compose Generator & Validator 和 Dockerfile Generator & Linter 会从你的技术栈出发生成配置。