Skip to content

Docker Compose 多服务栈

中等 约 40 分钟

你将构建什么

一个 docker-compose.yml,启动完整技术栈:Node.js Web 应用、PostgreSQL 数据库、Redis 缓存和 Nginx 反向代理 —— 全部通过自定义网络连接。

学习目标

  • 在 docker-compose.yml 中定义多个服务
  • 用自定义网络连接服务
  • 使用卷持久化数据
  • 用 depends_on 配置服务依赖

前置要求

  • Docker 基础(Dockerfile、build、run)
  • 理解 Web 应用架构
  • YAML 语法

步骤

  1. 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. 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. 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. 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. 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 编排了多服务栈 —— 本地开发环境的标准。你用网络连接服务,用卷持久化数据,并添加健康检查确保可靠的启动顺序。

相关资源

相关术语

相关术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题