容器与云原生 / 系统课时

编写基础 Compose 配置

编写基础 Compose 配置

这一节把四服务拓扑真正写成一个可启动的 compose.yaml:Nginx 负责唯一入口,Web 同时连接前后端网络,Redis 与 PostgreSQL 保持内部可见。完成后可直接启动并用一次 HTTP 请求验证整条链路。

学习目标

  • 为四个服务定义镜像、网络、依赖和持久化职责。
  • 使用健康检查让 Web 在 Redis 与数据库可用后再进入健康状态。
  • 通过 docker compose config 和 HTTP 请求验证配置与服务连通性。

建立可以直接启动的最小系统

为了让示例只依赖一个 compose.yaml,Web 服务使用 Python 标准库启动一个极简 HTTP 服务,并通过 TCP 连接检查 Redis 与 PostgreSQL 是否可达。真实项目中应把 web 替换成自己的应用镜像,而网络、依赖和端口设计可以保持不变。

把下面内容保存为当前目录下的 compose.yaml。

yaml
services:
  nginx:
    image: nginx:1.27-alpine
    ports:
      - "8080:80"
    depends_on:
      web:
        condition: service_healthy
    command:
      - /bin/sh
      - -c
      - |
        printf 'server { listen 80; location / { proxy_pass http://web:8000; } }\n' > /etc/nginx/conf.d/default.conf
        exec nginx -g 'daemon off;'
    networks:
      - frontend

  web:
    image: python:3.12-alpine
    environment:
      REDIS_HOST: redis
      DB_HOST: db
    depends_on:
      redis:
        condition: service_healthy
      db:
        condition: service_healthy
    command:
      - python
      - -c
      - |
        import json
        import os
        import socket
        from http.server import BaseHTTPRequestHandler, HTTPServer

        def reachable(host, port):
            try:
                with socket.create_connection((host, port), timeout=1):
                    return True
            except OSError:
                return False

        class Handler(BaseHTTPRequestHandler):
            def do_GET(self):
                status = {
                    "redis": reachable(os.environ["REDIS_HOST"], 6379),
                    "db": reachable(os.environ["DB_HOST"], 5432),
                }
                body = json.dumps(status).encode("utf-8")
                self.send_response(200 if all(status.values()) else 503)
                self.send_header("Content-Type", "application/json")
                self.send_header("Content-Length", str(len(body)))
                self.end_headers()
                self.wfile.write(body)

            def log_message(self, format, *args):
                pass

        HTTPServer(("0.0.0.0", 8000), Handler).serve_forever()
    healthcheck:
      test:
        - CMD
        - python
        - -c
        - "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/', timeout=2)"
      interval: 5s
      timeout: 3s
      retries: 10
    networks:
      - frontend
      - backend

  redis:
    image: redis:7-alpine
    healthcheck:
      test:
        - CMD
        - redis-cli
        - ping
      interval: 5s
      timeout: 3s
      retries: 10
    networks:
      - backend

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: app
      POSTGRES_USER: app
      POSTGRES_PASSWORD: app-pass
    volumes:
      - db-data:/var/lib/postgresql/data
    healthcheck:
      test:
        - CMD-SHELL
        - pg_isready -U app -d app
      interval: 5s
      timeout: 3s
      retries: 10
    networks:
      - backend

networks:
  frontend:
  backend:
    internal: true

volumes:
  db-data:

这个配置只把 Nginx 的 80 端口发布为宿主机的 8080;Web 没有宿主机端口,但 Nginx 能通过 frontend 网络访问 web:8000;Redis 与 PostgreSQL 只存在于 backend,Web 则通过服务名 redis 和 db 访问它们。数据库数据写入 db-data 命名卷,重建容器不会自动清空数据。

理解 depends_on 与健康检查

短写法 depends_on 只能表达启动顺序,不能证明依赖服务已经可用。这里使用长写法并指定 condition: service_healthy:Redis 通过 redis-cli ping 检查,PostgreSQL 通过 pg_isready 检查,Web 再检查自身 HTTP 端点。

这种依赖关系适合“启动时先等基础服务可用”的场景,但它不是运行期高可用机制。容器启动完成后,如果数据库后来宕机,应用仍应自行实现重试、超时和错误处理。

验证配置和整条请求链路

先让 Compose 解析配置,再后台启动四个服务,最后访问 Nginx 暴露的端口。命令启用 set -euo pipefail,任何一步失败都会立即停止。

bash
set -euo pipefail
docker compose config -q
docker compose up -d >/dev/null 2>&1
curl -s http://127.0.0.1:8080/

预期输出

text
{"redis": true, "db": true}

如果得到这个 JSON,说明请求已经经过宿主机 8080 进入 Nginx,再转发到 Web;Web 同时成功解析并连接了 redis:6379 与 db:5432。若 docker compose config -q 无输出但返回码为 0,则 YAML 结构和 Compose 字段解析通过。

检查访问边界是否符合设计

启动成功不代表边界一定正确。最终配置应满足:只有 nginx 存在 ports;nginx 不在 backend;redis 和 db 不在 frontend;web 是唯一同时加入两个网络的服务;数据库使用命名卷保存数据。

这套基础配置已经形成一个完整的四服务部署骨架。把实验用的 Python Web 服务替换成真实业务镜像后,可以继续增加应用环境变量、反向代理规则、资源限制和生产级密钥管理,而不需要推翻现有网络边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写基础 Compose 配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通