DockerSamples 101教程：使用Docker Compose编排多容器应用

什么是Docker Compose

Docker Compose是一个用于定义和运行多容器Docker应用程序的工具。通过编写一个简单的YAML文件，开发者可以配置应用程序所需的所有服务，然后只需一个命令就能创建并启动所有服务。

为什么需要Docker Compose

在开发多容器应用时，手动使用docker run命令启动每个容器既繁琐又容易出错。Docker Compose通过以下优势解决了这个问题：

1. 声明式配置：所有服务配置集中在一个YAML文件中
2. 环境一致性：确保开发、测试和生产环境的一致性
3. 简化协作：团队成员只需共享一个文件即可复现相同环境
4. 高效管理：单个命令即可启动/停止整个应用栈

安装Docker Compose

大多数情况下，Docker Compose已经包含在Docker Desktop安装包中。可以通过以下命令验证是否已安装：

docker-compose version

编写docker-compose.yml文件

基础结构

每个docker-compose.yml文件都包含以下基本部分：

version: "3.7"  # 指定使用的Compose文件格式版本

services:       # 定义应用中的各个服务
  service1:     # 服务名称
    # 服务配置
  service2:
    # 服务配置

volumes:        # 定义持久化存储
  volume1:
    # 卷配置

转换单容器命令为Compose配置

以Node.js应用为例，原始启动命令可能如下：

docker run -dp 3000:3000 \
  -w /app -v $PWD:/app \
  --network todo-app \
  -e MYSQL_HOST=mysql \
  -e MYSQL_USER=root \
  -e MYSQL_PASSWORD=secret \
  -e MYSQL_DB=todos \
  node:10-alpine \
  sh -c "yarn install && yarn run dev"

转换为Compose配置：

services:
  app:
    image: node:10-alpine
    command: sh -c "yarn install && yarn run dev"
    ports:
      - 3000:3000
    working_dir: /app
    volumes:
      - ./:/app
    environment:
      MYSQL_HOST: mysql
      MYSQL_USER: root
      MYSQL_PASSWORD: secret
      MYSQL_DB: todos

添加MySQL服务

MySQL服务的原始命令：

docker run -d \
  --network todo-app --network-alias mysql \
  -v todo-mysql-data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=todos \
  mysql:5.7

对应的Compose配置：

services:
  mysql:
    image: mysql:5.7
    volumes:
      - todo-mysql-data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: todos

volumes:
  todo-mysql-data:

完整的docker-compose.yml示例

version: "3.7"

services:
  app:
    image: node:10-alpine
    command: sh -c "yarn install && yarn run dev"
    ports:
      - 3000:3000
    working_dir: /app
    volumes:
      - ./:/app
    environment:
      MYSQL_HOST: mysql
      MYSQL_USER: root
      MYSQL_PASSWORD: secret
      MYSQL_DB: todos

  mysql:
    image: mysql:5.7
    volumes:
      - todo-mysql-data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: todos

volumes:
  todo-mysql-data:

启动和管理应用栈

启动服务

docker-compose up -d

-d参数表示在后台运行服务。

查看日志

docker-compose logs -f

-f参数表示持续跟踪日志输出。

停止服务

docker-compose down

要同时删除数据卷，使用：

docker-compose down --volumes

最佳实践建议

1. 服务依赖：确保应用服务等待数据库完全启动后再连接
2. 版本控制：将docker-compose.yml纳入版本控制系统
3. 环境变量：敏感信息应考虑使用环境变量文件
4. 网络隔离：Compose会自动创建专用网络，无需手动配置

常见问题解决方案

问题：应用启动时数据库尚未准备好

解决方案：在应用中添加等待逻辑，例如Node.js可以使用wait-port工具：

command: sh -c "while ! nc -z mysql 3306; do sleep 1; done && yarn install && yarn run dev"

问题：端口冲突

解决方案：检查并停止冲突的容器，或修改Compose文件中的端口映射。

通过Docker Compose，开发者可以轻松定义和管理复杂的多容器应用，大大简化了开发和部署流程。