容器与云原生 / 系统课时
编写 Compose 文件
编写 Compose 文件
本课将从零建立一个可验证的 compose.yaml,同时演示直接使用镜像、从 Dockerfile 构建镜像,以及端口、环境变量、启动命令和重启策略等基础运行参数。
学习目标
- 认识 Compose 文件的顶层结构和服务定义方式
- 为不同服务配置
image、build与基础运行参数 - 使用 Compose 命令检查配置是否可以被正确解析
确认 Compose 可用
现代 Compose 使用 compose.yaml 描述应用中的服务、网络和数据卷,当前推荐依据 Compose Specification 编写。服务统一放在顶层 services 下;旧教程常见的顶层 version 字段仅为兼容保留,继续填写会收到已过时提示。:contentReference[oaicite:0]{index=0}
先在终端确认 Compose 命令已经安装:
docker compose version预期输出
Docker Compose version v<MAJOR>.<MINOR>.<PATCH>版本号会随安装环境变化;只要命令能够返回版本信息,而不是提示找不到子命令,就可以继续。
编写完整服务定义
在空目录中创建 compose.yaml 和 Dockerfile。下面的配置包含两个独立服务:web 直接运行 Nginx 镜像,worker 则从当前目录构建镜像。build 指定构建上下文和 Dockerfile,image 为构建结果设置可复用的镜像名称。:contentReference[oaicite:1]{index=1}
name: compose-demo
services:
web:
image: nginx:1.27-alpine
ports:
- "8080:80"
restart: unless-stopped
worker:
build:
context: .
dockerfile: Dockerfile
image: compose-demo-worker:1.0
environment:
APP_ENV: development
command: ["sh", "-c", "while true; do echo worker:$$APP_ENV; sleep 30; done"]
restart: unless-stoppedworker 使用一个最小 Dockerfile:
FROM busybox:1.36
WORKDIR /app这两个文件生效后,Compose 会把 web 的容器端口 80 映射到主机端口 8080,并在构建 worker 时使用当前目录作为构建上下文。此处只完成定义和校验,实际启动将在下一课进行。
理解关键字段
| 字段 | 作用 | 本例行为 |
|---|---|---|
services |
声明服务集合 | 定义 web 与 worker |
image |
指定或命名容器镜像 | 拉取 Nginx,命名 worker 构建结果 |
build |
描述源码构建方式 | 从当前目录的 Dockerfile 构建 |
ports |
建立主机与容器端口映射 | 访问主机 8080 转到容器 80 |
environment |
向容器注入环境变量 | 设置 APP_ENV=development |
restart |
设置容器重启策略 | 非人工停止时自动恢复 |
environment 适合普通运行参数,不应直接保存数据库密码、令牌等敏感值;敏感配置应改用 secrets 或外部密钥管理方式。:contentReference[oaicite:2]{index=2}
命令中的 $$APP_ENV 不是笔误。双美元符号会阻止 Compose 在解析阶段替换变量,并把单个 $ 传给容器内的 Shell,因此真正运行时由容器读取 APP_ENV。:contentReference[oaicite:3]{index=3}
校验配置
在两个文件所在目录执行配置检查:
docker compose config --quiet && echo "compose config valid"预期输出
compose config validdocker compose config --quiet 只验证并解析配置,不打印规范化内容;命令成功说明 YAML 语法、字段名称和服务模型可以被 Compose 接受。:contentReference[oaicite:4]{index=4}
如果校验失败,优先检查 YAML 缩进、冒号后的空格、重复键,以及 services 是否处于顶层。修改后再次执行同一命令,直到得到预期结果。
本课总结
- Compose 文件通过顶层
services集中定义多个容器服务 image适合直接使用已有镜像,build适合从源码和 Dockerfile 构建- 编写完成后应先运行
docker compose config --quiet,再进入启动阶段
下一课预告
下一课将使用同一类 Compose 服务栈完成创建、后台启动、停止、重新启动和销毁,并明确 stop、down 与 down -v 对容器、网络和数据卷的不同影响。