别再手动一个个启动容器了！用Docker Compose编排一个Web+MySQL+Redis的完整项目（附yml文件详解）
别再手动一个个启动容器了！用Docker Compose编排一个Web+MySQL+Redis的完整项目（附yml文件详解）
每次部署多容器项目时，最头疼的就是手动启动每个服务、配置网络、挂载数据卷。想象一下：先启动MySQL容器，设置root密码和存储卷；再启动Redis，配置持久化；最后部署Web应用，确保能连接到数据库和缓存。这种重复劳动不仅低效，还容易出错。而Docker Compose正是解决这一痛点的利器——它允许你用一份YAML文件定义整个应用栈，然后通过一条命令启动所有服务。
1. 为什么需要Docker Compose？
在真实开发场景中，几乎没有应用是单一容器能支撑的。以典型的Web项目为例：
- 核心服务：应用服务器（如Spring Boot）、数据库（MySQL）、缓存（Redis）
- 辅助服务：消息队列（RabbitMQ）、搜索引擎（Elasticsearch）
- 基础设施：负载均衡（Nginx）、监控（Prometheus）
手动管理这些容器的痛点包括：
- 启动顺序依赖：数据库必须先于应用启动
- 网络配置复杂：容器间需要互通但又要隔离外部访问
- 环境变量传递：数据库连接字符串需要注入到Web容器
- 数据持久化：数据库文件、缓存数据需要挂载到宿主机
Docker Compose通过声明式配置解决这些问题。下面是一个对比传统方式和Compose方式的典型流程：
| 操作步骤 | 手动操作命令示例 | Compose方式 |
|---|---|---|
| 创建网络 | docker network create app_net | 在yml中定义networks块 |
| 启动MySQL | docker run --name mysql -e MYSQL_ROOT_PASSWORD=123456... | services.mysql.environment |
| 启动Redis | docker run --name redis -v redis_data:/data... | services.redis.volumes |
| 启动Web应用 | docker run --name web --link mysql --link redis... | services.web.depends_on |
提示：Compose的
depends_on只能控制启动顺序，不能确保服务已就绪。对于数据库这类需要等待初始化完成的服务，建议结合健康检查使用。
2. 实战：编写docker-compose.yml
让我们构建一个Spring Boot + MySQL + Redis的完整项目。假设项目结构如下：
myapp/ ├── docker-compose.yml ├── backend/ │ ├── Dockerfile │ └── target/app.jar # Spring Boot打包结果 ├── mysql/ │ └── init.sql # 数据库初始化脚本 └── redis/ └── redis.conf # Redis自定义配置2.1 基础结构解析
每个Compose文件包含三个核心部分：
version: "3.8" # 指定Compose语法版本 services: # 定义所有服务容器 web: build: ./backend ports: - "8080:8080" volumes: # 声明数据卷 db_data: networks: # 定义网络 app_net: driver: bridge关键版本选择建议：
- 3.x版本支持Swarm模式扩展
- 生产环境建议使用3.8+以获得最新功能
- 不同Docker Engine版本有兼容性要求
2.2 完整配置详解
以下是带详细注释的yml文件：
version: "3.8" services: # Spring Boot应用服务 webapp: build: context: ./backend dockerfile: Dockerfile # 指定Dockerfile路径 container_name: myapp_web ports: - "8080:8080" environment: - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/mydb - SPRING_REDIS_HOST=redis depends_on: - mysql - redis networks: - app_net restart: unless-stopped # 异常退出时自动重启 # MySQL数据库服务 mysql: image: mysql:8.0 container_name: myapp_mysql environment: - MYSQL_ROOT_PASSWORD=mysecret - MYSQL_DATABASE=mydb volumes: - db_data:/var/lib/mysql - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql # 初始化脚本 ports: - "3306:3306" networks: - app_net healthcheck: # 健康检查 test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 5s timeout: 3s retries: 5 # Redis缓存服务 redis: image: redis:6 container_name: myapp_redis command: redis-server --requirepass mypassword # 设置密码 volumes: - redis_data:/data - ./redis/redis.conf:/usr/local/etc/redis/redis.conf # 挂载自定义配置 ports: - "6379:6379" networks: - app_net volumes: db_data: redis_data: networks: app_net: driver: bridge2.3 关键配置项解析
服务依赖与启动顺序
depends_on: - mysql - redis虽然depends_on定义了启动顺序，但更好的实践是：
- 为MySQL添加健康检查
- 在应用启动命令中添加等待脚本，例如：
# 在Dockerfile中添加健康检查等待脚本 HEALTHCHECK --interval=30s --timeout=3s \ CMD curl -f http://localhost:8080/actuator/health || exit 1数据持久化方案对比
| 方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 匿名卷 | 自动创建，简单 | 难以维护，删除容器会丢失 | 开发环境临时数据 |
| 命名卷（推荐） | 生命周期独立于容器 | 需要显式声明 | 生产环境数据库存储 |
| 宿主机目录绑定 | 直接访问宿主机文件 | 路径依赖宿主机环境 | 配置文件、初始化脚本 |
网络隔离策略
默认创建的app_net具有以下特性：
- 所有服务通过服务名（如
mysql）互相访问 - 对外暴露的只有
webapp服务的8080端口 - 可通过
networks定义多个网络实现更细粒度隔离
3. 高效开发技巧
3.1 常用操作命令
启动并构建所有服务（开发环境）：
docker-compose up -d --build仅重建并启动特定服务：
docker-compose up -d --no-deps --build webapp查看服务日志：
docker-compose logs -f webapp执行数据库迁移：
docker-compose exec webapp ./migrate.sh3.2 性能优化配置
对于生产环境，建议添加以下配置：
services: mysql: deploy: resources: limits: cpus: '2' memory: 2G ulimits: nproc: 65535 nofile: soft: 20000 hard: 400003.3 多环境配置方案
通过环境变量和多个Compose文件实现：
docker-compose.yml # 基础配置 docker-compose.override.yml # 开发环境配置（默认加载） docker-compose.prod.yml # 生产环境配置启动时指定配置：
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d4. 常见问题排查
4.1 容器启动失败排查步骤
- 查看日志：
docker-compose logs service_name - 检查配置：
docker-compose config - 进入容器：
docker-compose exec service_name sh - 验证网络：
docker network inspect myapp_app_net
4.2 典型错误解决方案
问题1：MySQL连接被拒绝
解决：确保depends_on配合健康检查使用，或在应用启动脚本中添加等待逻辑
问题2：端口冲突
解决：检查ports配置或使用docker-compose ps查看运行状态
问题3：卷权限问题
解决：在Dockerfile中正确设置用户权限，例如：
RUN mkdir -p /var/lib/mysql && chown -R mysql:mysql /var/lib/mysql问题4：环境变量未生效
解决：使用docker-compose exec service_name env验证环境变量
注意：修改
docker-compose.yml后，需要重新运行docker-compose up -d使更改生效。对于某些配置（如环境变量），可能需要先执行docker-compose down再重新启动。