容器与云原生 / 系统课时

编写 Compose 文件

编写 Compose 文件

本课将从零建立一个可验证的 compose.yaml,同时演示直接使用镜像、从 Dockerfile 构建镜像,以及端口、环境变量、启动命令和重启策略等基础运行参数。

学习目标

  • 认识 Compose 文件的顶层结构和服务定义方式
  • 为不同服务配置 image、build 与基础运行参数
  • 使用 Compose 命令检查配置是否可以被正确解析

确认 Compose 可用

现代 Compose 使用 compose.yaml 描述应用中的服务、网络和数据卷,当前推荐依据 Compose Specification 编写。服务统一放在顶层 services 下;旧教程常见的顶层 version 字段仅为兼容保留,继续填写会收到已过时提示。:contentReference[oaicite:0]{index=0}

先在终端确认 Compose 命令已经安装:

bash
docker compose version

预期输出

text
Docker Compose version v<MAJOR>.<MINOR>.<PATCH>

版本号会随安装环境变化;只要命令能够返回版本信息,而不是提示找不到子命令,就可以继续。

编写完整服务定义

在空目录中创建 compose.yaml 和 Dockerfile。下面的配置包含两个独立服务:web 直接运行 Nginx 镜像,worker 则从当前目录构建镜像。build 指定构建上下文和 Dockerfile,image 为构建结果设置可复用的镜像名称。:contentReference[oaicite:1]{index=1}

yaml
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-stopped

worker 使用一个最小 Dockerfile:

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}

校验配置

在两个文件所在目录执行配置检查:

bash
docker compose config --quiet && echo "compose config valid"

预期输出

text
compose config valid

docker 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 对容器、网络和数据卷的不同影响。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写 Compose 文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通