# 部署拓扑模板

本目录描述 Proxy Pool 的部署拓扑，覆盖 Compose、HAProxy、Prometheus、
Grafana 与 Kubernetes。镜像会构建 `proxy-controller`、`proxy-gateway` 与
`proxy-checker`；Controller 已装配 Redis BASIC 检查任务，Checker 可通过认证
控制面执行 HTTP/HTTPS BASIC 探测。

默认 Compose 和 Kubernetes Base 仍将 `controlPlane.enabled` 保持为 `false`。
跨节点控制面必须由环境 Overlay 提供 Controller 可拨号地址、独立 Worker/Checker
身份及 mTLS 证书，因此这些默认清单不能视为完整的生产发布配置。`checker.yaml`
保留为 Overlay 模板，尚未加入 Base。

当前可执行验证：

```powershell
docker compose -f deploy/docker-compose.yml config --quiet
docker compose -f deploy/docker-compose.test.yml config --quiet
kubectl kustomize deploy/kubernetes/base | Out-Null
go run ./deploy/tools/configcheck deploy/config/local.yaml
```

`docker-compose.test.yml` 为 Redis 与 PostgreSQL 18 提供互相独立的本地集成测试
服务。两者只绑定回环地址；Redis 禁止持久化，PostgreSQL 使用
`/var/lib/postgresql` tmpfs。`test-redis.ps1` 通过专属 Compose 项目只启动 Redis；
PostgreSQL Adapter 和对应执行脚本完成前，不把数据库契约记为通过。

发布前仍须通过 `production-readiness.md` 中的一致性、安全、恢复、竞态与容量门禁，
并完成代表性集群容量验证。