容器与云原生 / 系统课时
编写基础 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。
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,任何一步失败都会立即停止。
set -euo pipefail
docker compose config -q
docker compose up -d >/dev/null 2>&1
curl -s http://127.0.0.1:8080/预期输出
{"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 服务替换成真实业务镜像后,可以继续增加应用环境变量、反向代理规则、资源限制和生产级密钥管理,而不需要推翻现有网络边界。