Docker Compose编排多容器应用实战指南

1. 项目背景与核心价值多容器应用编排是现代云原生开发中的必备技能。去年我在迁移公司老旧单体架构时第一次真正体会到Docker Compose的威力——原本需要3天手动部署的NginxMySQLRedis服务栈用Compose文件20分钟就搞定了。这种基础设施即代码的体验让我彻底成为容器化部署的信徒。这个方案特别适合需要快速搭建LNMP/LAMP开发环境的全栈开发者准备将传统应用容器化的运维工程师想学习服务编排的DevOps初学者2. 环境准备与工具选型2.1 基础环境配置推荐使用Ubuntu 22.04 LTS作为基础系统这是我实测最稳定的组合# 安装必要工具 sudo apt update sudo apt install -y git curl wget # 安装Docker引擎 curl -fsSL https://get.docker.com | sudo sh # 当前用户加入docker组需重新登录生效 sudo usermod -aG docker $USER重要提示生产环境务必配置docker daemon的TLS加密通信开发环境可暂时跳过2.2 Docker Compose安装虽然现在Docker Desktop自带Compose但服务器环境我更推荐独立安装# 获取最新稳定版截至2023年7月为v2.18.1 DOCKER_COMPOSE_VERSION$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep tag_name | cut -d -f 4) sudo curl -L https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose验证安装docker-compose version # 应输出类似Docker Compose version v2.18.13. 服务栈架构设计3.1 组件交互关系我们的目标架构客户端 → Nginx (80端口) ↳ 静态文件 ↳ 动态请求 → 应用容器 ↳ MySQL (3306) ↳ Redis (6379)3.2 网络拓扑规划默认情况下Compose会创建1个自定义bridge网络服务间通信每个服务的独立容器建议显式声明网络配置networks: app_net: driver: bridge ipam: config: - subnet: 172.20.0.0/244. 编写Compose文件4.1 基础模板结构创建docker-compose.ymlversion: 3.8 services: # 各服务定义将放在这里 networks: app_net: driver: bridge volumes: mysql_data: redis_data:4.2 Nginx服务配置nginx: image: nginx:1.23-alpine ports: - 80:80 - 443:443 volumes: - ./nginx/conf.d:/etc/nginx/conf.d - ./static:/var/www/html depends_on: - app networks: - app_net配套的Nginx配置文件示例./nginx/conf.d/default.confserver { listen 80; location / { proxy_pass http://app:3000; proxy_set_header Host $host; } location /static/ { alias /var/www/html/; } }4.3 MySQL服务配置mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: your_secure_password MYSQL_DATABASE: app_db MYSQL_USER: app_user MYSQL_PASSWORD: user_password volumes: - mysql_data:/var/lib/mysql - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql networks: - app_net healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 5s timeout: 3s retries: 34.4 Redis服务配置redis: image: redis:7-alpine command: redis-server --requirepass your_redis_password volumes: - redis_data:/data networks: - app_net healthcheck: test: [CMD, redis-cli, ping] interval: 5s timeout: 3s retries: 35. 应用容器示例假设我们有个Node.js应用app: build: ./app environment: DB_HOST: mysql DB_USER: app_user DB_PASSWORD: user_password REDIS_URL: redis://default:your_redis_passwordredis:6379 depends_on: mysql: condition: service_healthy redis: condition: service_healthy networks: - app_net对应的Dockerfile./app/DockerfileFROM node:18-alpine WORKDIR /app COPY package*.json ./ RUN npm install COPY . . EXPOSE 3000 CMD [npm, start]6. 运维管理实战6.1 常用操作命令启动整个栈后台模式docker-compose up -d查看日志可指定服务名docker-compose logs -f nginx执行一次性命令如在mysql中执行SQLdocker-compose exec mysql mysql -uapp_user -p app_db6.2 配置热重载修改Nginx配置后无需重启容器docker-compose exec nginx nginx -s reload6.3 备份与恢复MySQL数据备份docker-compose exec mysql sh -c exec mysqldump --all-databases -uroot -p$MYSQL_ROOT_PASSWORD backup.sqlRedis数据持久化已在配置中自动启用docker-compose exec redis redis-cli save7. 性能调优技巧7.1 资源限制services: mysql: deploy: resources: limits: cpus: 2 memory: 2G reservations: memory: 1G7.2 MySQL优化参数通过自定义配置文件./mysql/my.cnf[mysqld] innodb_buffer_pool_size 1G innodb_log_file_size 256M在compose中挂载volumes: - ./mysql/my.cnf:/etc/mysql/conf.d/custom.cnf8. 常见问题排查8.1 容器启动顺序问题症状应用启动时报数据库连接失败解决方案使用depends_on healthcheck组合应用添加重试逻辑8.2 端口冲突症状docker-compose up时报端口被占用排查sudo netstat -tulnp | grep 808.3 数据卷权限问题症状MySQL无法写入数据目录解决方法docker-compose down sudo chown -R 999:999 ./mysql_data9. 生产环境建议使用单独的.env文件管理敏感信息echo MYSQL_ROOT_PASSWORD$(openssl rand -base64 12) .env启用Swarm模式获得更高可用性docker swarm init docker stack deploy -c docker-compose.yml my_stack配置日志轮转logging: options: max-size: 10m max-file: 3这个配置方案已经在我们的预发布环境稳定运行了6个月期间经历过3次平滑升级。最让我惊喜的是当需要新增一个Elasticsearch服务时只需要在compose文件中添加20行配置就完成了集成。