记录使用 Docker Compose 编排多服务应用的实践经验，涵盖配置编写、网络管理与数据持久化。

基本概念

Docker Compose 通过一个 YAML 文件定义多个容器服务及其依赖关系，适合本地开发、CI 测试和小规模部署。

典型项目结构

myapp/
├── docker-compose.yml
├── .env
├── web/
│   ├── Dockerfile
│   └── app.py
├── api/
│   ├── Dockerfile
│   └── main.go
└── nginx/
    └── nginx.conf

完整示例：Web + API + Redis

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

version: "3.9"

services:
  web:
    build: ./web
    ports:
      - "3000:3000"
    environment:
      - API_URL=http://api:8080
    depends_on:
      - api
    restart: unless-stopped

  api:
    build: ./api
    expose:
      - "8080"
    environment:
      - REDIS_URL=redis://redis:6379
    depends_on:
      - redis
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    volumes:
      - redis-data:/data
    restart: unless-stopped

  nginx:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
    depends_on:
      - web
    restart: unless-stopped

volumes:
  redis-data:

网络管理

Compose 默认创建一个桥接网络，服务间通过服务名互相访问：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 查看网络
docker network ls

# 自定义网络
networks:
  frontend:
    driver: bridge
  backend:
    driver: bridge
    internal: true  # 仅内部访问，不可连外网

服务指定网络：

1
2
3
4
5
6
7
8

services:
  web:
    networks:
      - frontend
      - backend
  api:
    networks:
      - backend

数据持久化方案

方式 适用场景 示例
Named Volume 数据库等持久数据 db-data:/var/lib/postgresql/data
Bind Mount 开发环境代码热加载 ./src:/app/src
tmpfs 临时敏感数据 tmpfs: /tmp

常用命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

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

# 查看日志
docker compose logs -f web

# 进入容器
docker compose exec api sh

# 停止并清理
docker compose down

# 停止并删除数据卷（谨慎）
docker compose down -v

.env 环境变量管理

1
2
3
4

# .env
DB_PASSWORD=secret123
API_PORT=8080
NODE_ENV=production

在 compose 文件中引用：

1
2
3

environment:
  - DB_PASSWORD=${DB_PASSWORD}
  - PORT=${API_PORT}

小结

Docker Compose 适合中小规模多服务编排，生产环境大规模部署建议迁移到 Kubernetes。后续会记录 Compose 到 K8s 的迁移实践。