docker-compose的使用总结

以下是一份 Docker Compose 使用总结，涵盖核心配置、网络管理、调试技巧及常见问题解决方案，适用于开发和生产环境：

一、核心概念与配置要点

1. 版本选择
   • 使用 version: '3.8' 及以上版本，支持更多新特性（如资源限制、健康检查）。

   • 新版 Compose（V2+）统一使用 docker compose 命令，无需 -f 指定文件。

2. 服务定义
   • services：定义每个容器的镜像、端口、卷、环境变量等。

   services:
     web:
       image: nginx:latest
       ports:
         - "80:80"
       volumes:
         - ./nginx.conf:/etc/nginx/nginx.conf
   

3. 网络管理
   • 默认网络：所有服务默认加入同一网络，通过服务名互通。

   • 自定义网络：显式定义网络提高可读性，隔离不同环境。

   networks:
     frontend:
       driver: bridge
     backend:
       driver: bridge
   

4. 依赖与启动顺序
   • depends_on：仅控制容器启动顺序，不保证服务可用性。

   • 健康检查（Healthcheck）：确保依赖服务真正就绪。

   services:
     db:
       image: postgres
       healthcheck:
         test: ["CMD-SHELL", "pg_isready -U postgres"]
         interval: 5s
         timeout: 3s
         retries: 5
     backend:
       depends_on:
         db:
           condition: service_healthy
   

二、数据持久化与资源控制

1. 卷（Volumes）
   • 匿名卷：数据随容器删除丢失（仅开发调试用）。

   • 命名卷：持久化数据，推荐生产使用。

   volumes:
     db_data:  # 命名卷
       driver: local
   services:
     db:
       volumes:
         - db_data:/var/lib/mysql
   

2. 资源限制
   • 防止单一服务耗尽宿主机资源。

   services:
     redis:
       deploy:
         resources:
           limits:
             cpus: '0.5'
             memory: 512M
   

三、网络通信最佳实践

1. 服务间通信
   • 使用服务名：直接通过服务名（如 http://backend:8000）访问。

   • 避免硬编码 IP：依赖 Docker DNS 自动解析。

2. 端口暴露规则
   • 仅暴露必要端口：如 Web 服务的 80:80。

   • 内部端口优先：服务间通信使用容器内部端口（如 8000），而非宿主机映射端口。

3. 解决 Host 头校验问题
   • 修正请求头：确保 Host 头不含端口（如 algorithm_service 而非 algorithm_service:8000）。

   • 调整服务配置：如 Django 的 ALLOWED_HOSTS 添加服务名或通配符（仅开发环境）。

四、调试与日志管理

1. 日志查看
   • 实时查看日志：docker compose logs -f service_name

   • 过滤错误日志：docker compose logs service_name | grep -i error

2. 进入容器调试

   docker compose exec service_name sh  # 进入容器 Shell
   curl -v http://dependent_service:port # 测试内部通信
   

3. 网络诊断
   • 检查容器 IP：docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' container_name

   • 测试端口连通性：nc -zv service_name port

五、多环境配置技巧

1. 多 Compose 文件
   • 分离开发、测试、生产配置：

   # 开发环境
   docker compose -f docker-compose.yml -f docker-compose.dev.yml up
   
   # 生产环境
   docker compose -f docker-compose.yml -f docker-compose.prod.yml up
   

2. 环境变量文件
   • 使用 .env 管理敏感信息：

   # .env
   DB_PASSWORD=secret
   

   • 在 Compose 中引用：

   services:
     db:
       environment:
         - POSTGRES_PASSWORD=${DB_PASSWORD}
   

六、常见问题与解决

七、性能优化建议

1. 镜像瘦身
   • 使用多阶段构建（Multi-stage Build）减少生产镜像体积。

   # Dockerfile
   FROM node:18 as builder
   WORKDIR /app
   COPY . .
   RUN npm build
   
   FROM nginx:alpine
   COPY --from=builder /app/dist /usr/share/nginx/html
   

2. 缓存优化
   • 在 docker-compose.yml 中利用缓存加速构建：

   services:
     web:
       build:
         context: .
         cache_from:
           - myapp:latest
   

3. 并行启动
   • 使用 docker compose up --parallel 并行启动无依赖的服务。

八、安全注意事项

1. 最小化权限
   • 避免容器以 root 用户运行：

   services:
     app:
       user: "1000:1000"
   

2. 密钥管理
   • 使用 Docker Secrets 或环境变量文件（.env）管理敏感信息，禁止硬编码。

3. 镜像来源
   • 优先使用官方镜像，定期扫描漏洞（如 docker scan）。

通过以上总结，可快速定位 Docker Compose 的配置问题，优化容器化应用的部署和管理效率。