外观
部署总览
rust_svc 用同一份服务代码、同一套对外契约和同一个镜像矩阵,提供两种装配形态:单机一体化(svc-all-in-one 单进程,外部只依赖一个 PostgreSQL)与云化(Helm chart 部署到 Kubernetes,九个服务各自成 Deployment)。这一页给出两种形态的对照、选择依据、镜像矩阵与云化前置依赖清单,是 deployment 其余各页的入口。部署面的落地操作手册随物料交付,本站各页与它同源但按主题拆开。
两种拓扑
单机形态的进程图(单机套件的 compose 文件):
云化形态(Helm chart 渲染产物):
形态对照
| 维度 | 单机一体化 | 云化(Helm + K8s) |
|---|---|---|
| 进程 | 1 个(svc-all-in-one,内含六服务面 + indexer + operator) | 9 个服务 Deployment + 5 个 migrator Job |
| 事件总线 | MemBus(进程内,无持久化) | NATS JetStream(ORCH_EVENTS 等流,durable 消费) |
| 对象存储 | local(data_dir 本地目录)或 mem | RustFS / S3 |
| 外部依赖 | 仅 PostgreSQL 17 + PostGIS 3 | PG 集群、NATS、对象存储、K8s、Istio ambient |
| 配置入口 | AIO__* 环境变量 + 服务级 env | ConfigMap TOML(chart 渲染)+ Secret(DB URL) |
| 数据库自举 | AIO__CREATE_DATABASES=true + AIO__AUTO_MIGRATE=true | migrator Job 前置(helm pre-install/pre-upgrade hook) |
| 发布方式 | 停进程换镜像/二进制,fail-fast | Argo Rollouts 金丝雀 + 指标分析自动回退 |
| 伸缩 | 不支持,单副本设计 | HPA(prod 已配 gateway/iam/metadata/orchestrator/metering/gis 六服务) |
| 适用场景 | 开发、演示、小站点、边缘 | 生产 |
两种形态不是两个产品。单机形态的启动次序、迁移协议、fail-closed 授权语义与云化完全一致,差异只在装配层:总线实现、存储后端与副本数。理解这一点后,从单机迁到云化不需要重新学习平台行为。
形态选择
text
需要高可用、多副本或金丝雀发布?
├─ 否 → 有 Docker?
│ ├─ 有 → standalone Docker Compose(单机套件)
│ └─ 没有 → 源码运行 svc-all-in-one + 本地 PG(见快速开始)
└─ 是 → Helm 云化(项目 chart)
├─ staging:values-staging.yaml(NATS + Istio + Rollouts + operator)
└─ prod:values-prod.yaml(再叠加副本/HPA 扩大 + KEDA 开关)判断依据展开说。单机形态的 MemBus 没有持久化,停机窗口内的事件不补投;限流与配额状态在进程内,多副本会各自计数。这两条决定了它只能单副本运行,也就决定了它承载不了对可用性有要求的负载。反过来,云化形态的全部前置依赖(K8s、Istio、ArgoCD、PG 集群、NATS、RustFS)都是集群侧一次性建设,小站点用云化是杀鸡用牛刀。
镜像矩阵
发布流水线在 push main 时构建 11 个镜像:
| 镜像 | 用途 | 构建文件 |
|---|---|---|
| svc-gateway / svc-iam / svc-metadata / svc-orchestrator / svc-metering / svc-gis / svc-gis-tantivy-indexer / svc-alert-bridge | 云化八服务 | Dockerfile(build-arg SERVICE) |
| svc-all-in-one | 单机一体化 | Dockerfile(SERVICE=svc-all-in-one) |
| svc-operator | 运维任务 | Dockerfile |
| migrator | 迁移 Job(sqlx-cli + /migrations) | Dockerfile.migrator |
镜像仓库与 tag:<registry>/rustsvc/<name>:sha-<12位 git sha>,由发布流水线的钉版环节写入 gitops values 钉版。镜像名与 Helm 模板的 rustsvc.image helper(svc-<component> 拼装)同名,这一对应关系由镜像引用守卫在 CI 里看护,chart 引用了矩阵外镜像即红。
云化环境分层
| 环境 | values 叠加 | 特征 |
|---|---|---|
| dev | values.yaml | mem 总线、istio 关、rollouts 关、operator 关、镜像 tag 缺省 latest |
| staging | values.yaml + values-staging.yaml | NATS、istio 开(host 留空待 overlay)、rollouts 金丝雀、operator 开、metadata authz=iam |
| prod | 再叠加 values-prod.yaml | gateway 6 副本 HPA 6-20;iam/metadata/orchestrator/metering 3 副本带 HPA;gis 2 带 HPA;indexer/operator/alert-bridge 各 1;KEDA 开 |
| gitops | 追加 values-gitops.yaml(末位覆盖) | CI 自动写的镜像钉版(当前 sha-cb746c1d49aa),勿手改 |
values 分层纪律:任何环境不在 values 写明文凭据,一律经 global.existingSecret(缺省 rustsvc-secrets)引用,Secret 由 sealed-secrets 或同形态工具在 GitOps 仓落盘。
云化前置依赖(集群侧一次性)
对照部署手册的前置表:
| 组件 | 用途 | 备注 |
|---|---|---|
| Kubernetes(N-1) | 运行面 | PodSecurity restricted 全命名空间强制 |
| Istio ambient(istiod + ztunnel + ingressgateway) | L4 mTLS 与南北向入口 | mesh 级 PeerAuthentication STRICT 由安装面持有 |
| ArgoCD | GitOps 同步 | AppProject 与两个 Application 见GitOps 发布管线 |
| Argo Rollouts | 金丝雀/蓝绿 | AnalysisTemplate 指标源 vmsingle |
| KEDA | gateway 定时伸缩(prod) | keda.enabled + keda.gatewayCron 条目 |
| VictoriaMetrics 单栈 + Grafana + Loki/Tempo | 可观测 | vmagent 按 prometheus.io 注解发现 |
| postgres_exporter / nats_exporter / kube-state-metrics / node_exporter | 基础设施序列 | 告警规则引用的 infra 指标来源 |
| cert-manager / sealed-secrets / 镜像仓库 | 制品与凭据 | 当前 registry 为 GHCR,可经 secrets 切换 |
| PG 集群(Patroni)+ NATS(3 节点 JetStream)+ RustFS | 数据与消息基础设施 | 不在随物料交付的 chart 内,chart 只部署 rustsvc 工作负载 |
各页导读
- 单机一体化:compose 栈逐服务解释、启动次序、bootstrap、升级与备份。
- Kubernetes 部署:chart 渲染产物清单、探针与安全上下文、副本与伸缩、迁移前置。
- Istio 接入面:chart 实际渲染的 AuthorizationPolicy 与入口 VirtualService,以及刻意不用的能力。
- GitOps 发布管线:从 merge main 到生产金丝雀的完整路径。
- 生产环境建议:已支持、待补齐、未支持三档清单与上生产检查单。