Skip to content

部署总览 ​

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 本地目录)或 memRustFS / S3
外部依赖仅 PostgreSQL 17 + PostGIS 3PG 集群、NATS、对象存储、K8s、Istio ambient
配置入口AIO__* 环境变量 + 服务级 envConfigMap TOML(chart 渲染)+ Secret(DB URL)
数据库自举AIO__CREATE_DATABASES=true + AIO__AUTO_MIGRATE=truemigrator Job 前置(helm pre-install/pre-upgrade hook)
发布方式停进程换镜像/二进制,fail-fastArgo 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 叠加特征
devvalues.yamlmem 总线、istio 关、rollouts 关、operator 关、镜像 tag 缺省 latest
stagingvalues.yaml + values-staging.yamlNATS、istio 开(host 留空待 overlay)、rollouts 金丝雀、operator 开、metadata authz=iam
prod再叠加 values-prod.yamlgateway 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 由安装面持有
ArgoCDGitOps 同步AppProject 与两个 Application 见GitOps 发布管线
Argo Rollouts金丝雀/蓝绿AnalysisTemplate 指标源 vmsingle
KEDAgateway 定时伸缩(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 到生产金丝雀的完整路径。
  • 生产环境建议:已支持、待补齐、未支持三档清单与上生产检查单。

以仓库代码为事实源构建 · RC Hardening 阶段