目录
前言
1 YAML基础语法解析
1.1 YAML格式简介
1.2 Docker-compose中的YAML语法规则
1.3 YAML数据类型在Compose中的应用
2 docker-compose.yml文件结构剖析
2.1 基本文件结构
2.2 版本声明详解
3 services配置深度解析
3.1 服务定义基础
3.2 镜像与构建配置
3.3 网络与端口配置
3.4 环境变量与机密数据
4 网络与存储配置
4.1 网络配置详解
4.2 数据卷配置详解
5 高级配置技巧
5.1 多环境配置管理
5.2 资源限制与部署策略
5.3 健康检查配置
6 常见问题与性能优化
6.1 配置优化建议
6.2 常见错误排查
6.3 性能调优技巧
7 总结
前言
Docker-compose作为容器编排的利器，其核心秘密全部隐藏在docker-compose.yml这个配置文件中。理解这个文件的语法结构和配置规则，是掌握Docker-compose的关键所在。
1 YAML基础语法解析
1.1 YAML格式简介
YAML（YAML Ain't Markup Language）是一种人类友好的数据序列化标准，被广泛用于配置文件，Docker-compose采用YAML作为其配置文件格式，主要因其具有以下特点：
- 可读性强：使用缩进表示层次，比JSON更易阅读
- 简洁明了：不需要大量括号和引号
- 注释支持：可以使用#添加注释
- 数据类型丰富：支持字符串、数字、布尔值、列表、字典等
1.2 Docker-compose中的YAML语法规则
基本规则：
- 缩进：使用空格（通常2或4个），不能使用Tab键
- 键值对：使用key: value形式，冒号后必须有一个空格
- 列表：使用短横线-表示，后面跟空格
- 多行字符串：使用|保留换行或>折叠换行
- 注释：以#开头，直到行尾
- 示例对比：
# 正确示例
services:web:image: nginx:alpineports:- "80:80"- "443:443"environment:NODE_ENV: production# 错误示例（Tab缩进）
services:web: # 使用了Tab键image: "nginx:alpine"1.3 YAML数据类型在Compose中的应用
| 数据类型 | 示例 | 说明 |
| 字符串 | image: "nginx:alpine" | 可加引号，特殊字符必须加 |
| 数字 | ports: - 8080:80 | 端口号等数值配置 |
| 布尔值 | restart: true | 启用/禁用选项 |
| 列表 | ports: ["80:80", "443:443"] | 多项配置 |
| 字典 | environment: {NODE_ENV: prod} | 嵌套配置 |
2 docker-compose.yml文件结构剖析
2.1 基本文件结构
- 一个完整的docker-compose.yml文件通常包含以下顶级部分：
version: '3.8' # 版本声明services: # 服务定义（必需）web:image: nginxnetworks: # 网络配置backend:driver: bridgevolumes: # 数据卷配置db-data:driver: localconfigs: # 配置项（高级功能）app-config:file: ./config.ymlsecrets: # 密钥管理（高级功能）db-password:file: ./db-password.txt
2.2 版本声明详解
- version字段指定了Compose文件格式的版本，不同版本支持的功能有所差异：
| 版本 | Docker Engine版本要求 | 重要特性 |
| 2.x | 1.10.0+ | 引入扩展字段、网络/卷顶级定义 |
| 3.x | 1.13.0+ | 简化语法，移除某些2.x特性 |
| 3.8 | 19.03.0+ | 支持GPU资源、更多部署选项 |
版本选择建议：
- 新项目推荐使用3.8版本
- 需要向后兼容时使用3.3
- 旧系统维护可使用2.4
3 services配置深度解析
3.1 服务定义基础
- 每个服务对应一个容器，基本结构如下：
services:service-name: # 服务名称（自定义）image: repo/image:tag # 镜像名称build: ./dir # 构建上下文ports: # 端口映射- "host:container"environment: # 环境变量- VAR=valuevolumes: # 数据卷- host_path:container_pathdepends_on: # 依赖关系- other-service3.2 镜像与构建配置
- 两种服务来源方式：
- 示例配置：
services:# 使用现有镜像redis:image: redis:alpineports:- "6379:6379"# 构建新镜像webapp:build:context: ./appdockerfile: Dockerfile.prodargs:NODE_ENV: productionimage: my-webapp:v13.3 网络与端口配置
- 网络模型：
- 端口配置示例：
ports:- "80:80" # 主机端口:容器端口- "443:443" # 明确指定- "8080" # 仅暴露，不映射到主机- "3000-3005:3000-3005" # 端口范围- target: 80 # 扩展语法published: 8080protocol: tcpmode: host3.4 环境变量与机密数据
- 三种配置方式对比：
| 方式 | 示例 | 适用场景 |
| 直接定义 | environment: {DB_HOST: db} | 非敏感配置 |
| 文件注入 | env_file: ./.env | 多环境配置 |
| 密钥管理 | secrets: - db-password | 敏感数据 |
4 网络与存储配置
4.1 网络配置详解
- 常见网络类型：
networks:frontend:driver: bridgedriver_opts:com.docker.network.enable_ipv6: "true"ipam:config:- subnet: "172.28.0.0/16"backend:external: truename: existing-network
4.2 数据卷配置详解
三种挂载方式：
- 匿名卷：- /var/lib/mysql
- 命名卷：- db-data:/var/lib/mysql
- 绑定挂载：- ./cache:/tmp/cache
- 示例配置：
volumes:db-data: # 命名卷driver: localdriver_opts:type: nfso: addr=192.168.1.1,rwlogs: # 外部卷external: truename: app-logs
5 高级配置技巧
5.1 多环境配置管理
- 推荐文件结构：
project/
├── docker-compose.yml # 基础配置
├── docker-compose.override.yml # 开发配置
├── docker-compose.prod.yml # 生产配置
└── .env # 环境变量- 合并规则：
5.2 资源限制与部署策略
- 生产环境推荐配置：
services:web:deploy:resources:limits:cpus: '0.5'memory: 512Mrestart_policy:condition: on-failuredelay: 5smax_attempts: 3update_config:parallelism: 2delay: 10sorder: start-first5.3 健康检查配置
healthcheck:test: ["CMD", "curl", "-f", "http://localhost"]interval: 30stimeout: 10sretries: 3start_period: 5s- 健康状态流转：
6 常见问题与性能优化
6.1 配置优化建议
- 版本控制：
- 将docker-compose.yml纳入版本控制
- 使用.dockerignore排除无关文件
- 敏感数据管理：
- 永远不要在配置中直接写入密码
- 使用secrets或环境变量文件
- 网络规划：
- 为不同服务组创建独立网络
- 生产环境禁用默认的bridge网络
6.2 常见错误排查
问题1：YAML格式错误
症状：
ERROR: yaml.parser.ParserError: while parsing a block mapping解决方法：
- 检查缩进是否一致
- 确认冒号后是否有空格
- 使用在线YAML验证工具检查
问题2：端口冲突
症状：
ERROR: for web Cannot start service web: driver failed programming external connectivity解决方法：
- netstat -tulnp | grep 查找占用进程
- 修改服务端口或停止冲突进程
6.3 性能调优技巧
- 构建缓存：
# 先复制依赖文件
COPY package.json yarn.lock ./
RUN yarn install# 再复制源代码
COPY . .- 资源限制：
deploy:resources:limits:memory: 1Gcpus: '0.5'- 日志轮转：
logging:driver: json-fileoptions:max-size: "10m"max-file: "3"7 总结
通过本文，我们学习了解了：
- YAML语法精髓：理解缩进、数据类型和结构规则
- Compose文件结构：从版本声明到服务、网络、存储配置
- 服务定义细节：镜像构建、环境变量、健康检查等
- 高级配置技巧：多环境管理、资源限制、部署策略
docker-compose.yml文件是Docker-compose的灵魂所在，精心设计的配置可以显著提高开发和运维效率。建议在实际项目中：
- 从简单配置开始，逐步添加复杂功能
- 做好配置的版本管理和环境隔离
- 定期检查Docker文档获取新特性
