proxy-pool/deploy/README.md
youfak 84b564ba9c
Some checks are pending
ci / proto (push) Waiting to run
ci / test (ubuntu-latest) (push) Waiting to run
ci / test (windows-latest) (push) Waiting to run
ci / race (push) Waiting to run
ci / integration (push) Waiting to run
build: include checker in deployment image
2026-07-31 22:35:58 +08:00

29 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 部署拓扑模板
本目录描述 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` 中的一致性、安全、恢复、竞态与容量门禁,
并完成代表性集群容量验证。