【Docker基础】深入解析Docker-Compose核心配置：docker-compose.yml顶级元素详解

在现代容器化应用开发中，Docker Compose已经成为不可或缺的工具之一。它通过简单的YAML文件定义多容器应用的服务、网络和存储配置，极大简化了容器编排的复杂性。本文将剖析docker-compose.yml文件的核心顶级元素，包括：

version
services
networks
volumes

1 docker-compose.yml文件概述

docker-compose.yml是Docker Compose的核心配置文件，采用YAML（YAML Ain't Markup Language）格式编写
YAML是一种人类可读的数据序列化语言，特别适合用来表达层次化数据结构

一个基本的docker-compose.yml文件结构如下：

version: "3.8"

services:
  webapp:
    image: nginx:latest
    ports:
      - "80:80"

networks:
  frontend:
    driver: bridge

volumes:
  db_data:
    driver: local

2 version：指定Compose文件格式版本

2.1 version元素的作用

version字段用于指定docker-compose.yml文件所使用的Compose文件格式版本
这个版本号与Docker Engine版本有对应关系，不同版本的Compose文件支持不同的功能和语法

2.2 版本兼容性

以下是主要版本与Docker Engine的兼容性关系：

2.3 如何选择版本

选择版本时应考虑：

使用的Docker Engine版本
是否需要Swarm模式功能
是否需要特定版本支持的特性

一般来说，较新的项目建议使用3.x版本，以获得最佳兼容性和功能支持

3 services：定义容器服务

3.1 services元素概述

services是docker-compose.yml中最重要且必须的顶级元素，用于定义应用中的各个服务（容器）
每个服务代表一个可运行的容器实例，可以配置镜像、端口映射、环境变量等属性

3.2 服务定义结构

一个典型的多服务配置示例：

services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"
    depends_on:
      - db
      - redis

  db:
    image: postgres:13
    environment:
      POSTGRES_PASSWORD: example

  redis:
    image: redis:6
    ports:
      - "6379:6379"

3.3 核心服务配置项

image：指定容器镜像
build：定义构建镜像的Dockerfile路径
ports：端口映射（主机端口:容器端口）
environment：设置环境变量
volumes：挂载数据卷
depends_on：定义服务启动依赖关系
networks：指定连接的网络
restart：定义容器重启策略

3.4 服务依赖与启动顺序

depends_on可以控制服务启动顺序，但不会等待服务"就绪"。如果需要等待服务完全可用，需要使用健康检查或其他工具如wait-for-it

services:
  web:
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started

  db:
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

4 networks：自定义网络配置

4.1 networks元素的作用

networks顶级元素允许你定义自定义网络，而不是使用默认的bridge网络，自定义网络提供以下优势：

更好的容器隔离
自动DNS解析服务名称
更精细的网络控制

4.2 网络配置示例

networks:
  frontend:
    driver: bridge
    ipam:
      config:
        - subnet: 172.16.238.0/24
  backend:
    driver: bridge
    internal: true

services:
  web:
    networks:
      - frontend
  db:
    networks:
      - backend
      - frontend

4.3 网络驱动类型

bridge：默认驱动，适合单主机部署
overlay：多主机通信，适合Swarm集群
host：直接使用主机网络，性能最佳但隔离性差
macvlan：为容器分配MAC地址，使其显示为物理设备
none：禁用所有网络

4.4 网络别名与服务发现

在自定义网络中，Docker提供内置的DNS服务，可以通过服务名称进行解析，还可以为服务设置别名：

services:
  web:
    networks:
      frontend:
        aliases:
          - webapp
          - frontend

5 volumes：数据卷配置

5.1 volumes元素的作用

volumes顶级元素用于定义命名卷，这些卷可以被多个服务共享和重用
数据卷是持久化容器数据的首选方式

5.2 数据卷架构

5.3 卷类型比较

类型	说明	示例
命名卷	由Docker管理，存储在特定位置	db_data:/var/lib/mysql
绑定挂载	挂载主机文件系统特定路径	./cache:/tmp/cache
tmpfs挂载	仅存储在内存中	tmpfs:/tmp

5.4 卷配置示例

volumes:
  db_data:
    driver: local
    driver_opts:
      type: nfs
      o: addr=192.168.10.30,rw
      device: ":/path/nfs/share"

  cache:
    driver: local

services:
  db:
    volumes:
      - db_data:/var/lib/postgresql/data
      - /backups:/backups:ro

  web:
    volumes:
      - cache:/tmp/cache

5.5 卷驱动选项

local：默认驱动，使用主机文件系统
nfs：网络文件系统挂载
volume-plugin：第三方卷插件

6 高级配置技巧

6.1 多环境配置管理

通过多个Compose文件管理不同环境：

docker-compose -f docker-compose.yml -f docker-compose.prod.yml up

6.2 资源限制

services:
  db:
    deploy:
      resources:
        limits:
          cpus: '0.50'
          memory: 512M
        reservations:
          cpus: '0.25'
          memory: 256M