Docker Compose 使用实例

一、Docker Compose 简介

Docker Compose 是用于定义和运行多容器 Docker 应用程序的工具，通过 YAML 文件配置应用程序服务，一键启动所有关联容器。

二、安装 Docker Compose

1. Linux：

sudo curl -L "https://mirrors.tuna.tsinghua.edu.cn/docker/compose/releases/download/v2.32.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

2. Windows/macOS：
   通过 Docker Desktop 安装（已内置 Compose）

验证安装：

docker-compose --version

三、基础配置文件示例（docker-compose.yml）

version: '3.8'  # Compose文件格式版本

services:
  web:
    build: .  # 使用当前目录的Dockerfile构建
    ports:
      - "8000:80"  # 主机端口:容器端口
    depends_on:
      - db
    environment:
      - DB_HOST=db
    networks:
      - mynetwork

  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: myapp
    networks:
      - mynetwork
    healthcheck:
      test: ["CMD-SHELL", "mysqladmin ping -h localhost"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  db_data:

networks:
  mynetwork:
    driver: bridge

四、关键配置解析

1. version：指定Compose文件格式版本（常用3.x）
2. services：定义服务（容器）
   • build：指定构建上下文路径（含Dockerfile）
   • image：直接使用官方镜像
   • ports：端口映射
   • depends_on：服务依赖关系
   • environment：环境变量设置
3. volumes：数据卷定义（持久化存储）
4. networks：自定义网络配置
5. healthcheck：容器健康检查

五、常用命令

1. 启动服务：

docker-compose up -d  # 后台启动
docker-compose up --build  # 重新构建后启动

2. 停止服务：

docker-compose down  # 停止并删除容器、网络等
docker-compose stop  # 仅停止容器

3. 查看日志：

docker-compose logs -f  # 实时查看日志
docker-compose logs web  # 查看指定服务日志

4. 进入容器：

docker-compose exec web bash  # 进入web容器

5. 构建镜像：

docker-compose build  # 构建所有服务镜像
docker-compose build web  # 仅构建web服务镜像

六、完整项目示例（Node.js + MySQL + Nginx）

1. 项目结构：

myapp/
├── docker-compose.yml
├── nginx/
│   ├── nginx.conf
│   └── Dockerfile
├── app/
│   ├── package.json
│   ├── server.js
│   └── Dockerfile
└── .env

2. docker-compose.yml：

version: '3.8'

services:
  nginx:
    build: ./nginx
    ports:
      - "80:80"
    depends_on:
      - app
    networks:
      - frontend
      - backend

  app:
    build: ./app
    environment:
      - NODE_ENV=production
      - DB_HOST=db
    networks:
      - backend
    depends_on:
      db:
        condition: service_healthy

  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD_FILE: /run/secrets/db_root_password
      MYSQL_DATABASE: myapp
    secrets:
      - db_root_password
    networks:
      - backend
    healthcheck:
      test: ["CMD-SHELL", "mysqladmin ping -h localhost"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  db_data:

networks:
  frontend:
  backend:

secrets:
  db_root_password:
    file: .env

3. app/Dockerfile：

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install --production
COPY . .
CMD ["npm", "start"]

4. nginx/Dockerfile：

FROM nginx:alpine
COPY nginx.conf /etc/nginx/conf.d/default.conf

5. nginx/nginx.conf：

server {
    listen 80;
    location / {
        proxy_pass http://app:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

6. .env：

DB_ROOT_PASSWORD=supersecret

七、高级功能

1. 扩展配置：

# 扩展服务实例
app:
  deploy:
    replicas: 3
  resources:
    limits:
      cpus: '0.5'
      memory: 512M

2. 多环境配置：

# docker-compose.override.yml（开发环境）
version: '3.8'
services:
  app:
    build: ./app
    volumes:
      - ./app:/app  # 挂载代码目录实现热更新
    environment:
      - NODE_ENV=development

3. 使用模板文件：

# docker-compose.yml
services:
  app:
    image: myapp:${TAG}

八、最佳实践

1. 使用.env文件管理敏感信息
2. 为不同环境创建独立的Compose文件（如docker-compose.prod.yml）
3. 使用健康检查确保服务启动顺序
4. 对持久化数据使用命名卷
5. 定期清理未使用的镜像和卷：

docker system prune -a

九、调试技巧

1. 查看容器状态：

docker-compose ps

2. 检查网络配置：

docker network inspect mynetwork

3. 验证配置文件：

docker-compose config