Docker Compose 多服务栈
中等 约 40 分钟
你将构建什么
一个 docker-compose.yml,启动完整技术栈:Node.js Web 应用、PostgreSQL 数据库、Redis 缓存和 Nginx 反向代理 —— 全部通过自定义网络连接。
学习目标
- 在 docker-compose.yml 中定义多个服务
- 用自定义网络连接服务
- 使用卷持久化数据
- 用 depends_on 配置服务依赖
前置要求
- Docker 基础(Dockerfile、build、run)
- 理解 Web 应用架构
- YAML 语法
步骤
- 1
创建 Web 应用 Dockerfile
创建一个简单的 Node.js Express 应用及其 Dockerfile。这将是 compose 栈中的主要 Web 服务。
代码// app/index.js const express = require('express'); const app = express(); app.get('/', (req, res) => { res.json({ message: 'Hello from the web app!', time: new Date() }); }); app.get('/health', (req, res) => res.json({ status: 'ok' })); app.listen(3000, () => console.log('App on :3000')); # app/Dockerfile FROM node:20-alpine WORKDIR /app COPY package*.json ./ RUN npm install COPY . . EXPOSE 3000 CMD ["node", "index.js"]预期结果
一个带 Dockerfile 的 Node.js 应用,准备被 compose。
- 2
定义带 Web 和数据库的 compose 文件
创建 docker-compose.yml,包含 Web 服务和 PostgreSQL 数据库。使用环境变量配置数据库连接。
代码# docker-compose.yml services: web: build: ./app ports: - "3000:3000" environment: - DB_HOST=db - DB_PORT=5432 - DB_NAME=myapp depends_on: db: condition: service_healthy db: image: postgres:16-alpine environment: - POSTGRES_DB=myapp - POSTGRES_PASSWORD=secret volumes: - db_data:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 5s timeout: 3s retries: 5 volumes: db_data:预期结果
运行 docker compose up 启动 Web 应用和带健康检查的数据库。
- 3
添加 Redis 缓存服务
在 compose 文件中添加 Redis 服务。Redis 将作为 Web 应用的缓存。
代码# Add to docker-compose.yml services: redis: image: redis:7-alpine ports: - "6379:6379" volumes: - redis_data:/data healthcheck: test: ["CMD", "redis-cli", "ping"] interval: 5s retries: 3 # Add to volumes: redis_data:预期结果
Redis 在 compose 网络内可通过 redis:6379 访问。
- 4
添加 Nginx 反向代理
添加一个 Nginx 服务,将请求代理到 Web 应用。这是外部流量的入口。
代码# nginx/nginx.conf upstream web_app { server web:3000; } server { listen 80; location / { proxy_pass http://web_app; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } # Add to docker-compose.yml services: nginx: image: nginx:alpine ports: - "80:80" volumes: - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro depends_on: - web预期结果
Nginx 将端口 80 代理到端口 3000 的 Web 应用。
- 5
定义自定义网络
添加自定义桥接网络,让服务通过名称通信。运行完整技术栈并验证连通性。
代码# Add to docker-compose.yml: networks: app_network: driver: bridge # Update each service to use the network: # networks: # - app_network # Run the full stack: # docker compose up -d # curl localhost/ → proxied to web app # docker compose exec web ping db → database reachable # docker compose exec web ping redis → cache reachable预期结果
四个服务全部启动,通过自定义网络连接,经 Nginx 在端口 80 可访问。
自己动手试试
起始代码
# docker-compose.yml
services:
web:
build: ./app
# TODO: add ports and environment
db:
image: postgres:16-alpine
# TODO: add environment and volume解决方案代码
services:
web:
build: ./app
ports: ["3000:3000"]
depends_on: [db]
db:
image: postgres:16-alpine
environment: [POSTGRES_PASSWORD=secret]
volumes: [db_data:/var/lib/postgresql/data]
volumes:
db_data:你学到了什么
你用 Docker Compose 编排了多服务栈 —— 本地开发环境的标准。你用网络连接服务,用卷持久化数据,并添加健康检查确保可靠的启动顺序。
相关资源
相关术语
- Docker Compose
多容器编排
- 容器
轻量级隔离
相关术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
- Docker Compose
多容器编排
- 容器
轻量级隔离
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。