Kubernetes 生产多副本部署
Yearning v4 是完全无状态的 Go 控制面,所有会话、单库执行排他租约、定时预约与多副本 SSE 实时广播均通过 PostgreSQL 协调,不依赖本地持久化卷。
仓库在 backend/deploy/k8s/ 提供三份生产清单:
control-plane.yaml:至少 2 副本 Deployment(maxUnavailable: 0)、PDB、Service、UID10001非 root 只读容器migration-workloads.yaml:一次性 Schema 迁移 Job(yearning-schema-migration)与迁移窗口审查 Deployment(yearning-migration-review)network-policy.yaml:最小权限集群出入站 NetworkPolicy
1. 提前准备 5 份职责分离的 Secret
请严格按角色隔离创建以下 Secret(不要让迁移 Job 访问密钥环,也不要让控制面 Pod 访问迁移账号):
为 yearning-schema-migration Job 渲染独立的迁移配置文件 Secret(注意 target.password 指向容器内挂载的 migrator 凭据文件绝对路径):
2. 渲染不可变 Digest 镜像清单并发布
仓库源清单刻意使用 ghcr.io/cookiey/yearning@sha256:REPLACED_BY_RELEASE 占位符,正式上线前先用实际发布镜像的 SHA-256 Digest 渲染到 dist/release-manifests/:
若使用 ingress-nginx 对外暴露 Service/yearning:8080,请在 Ingress Annotation 中关闭缓冲并放大超时,避免实时审批/执行推送断开:
3. 四项 Readiness 生产就绪探针排障
Pod 通过 /api/v4/health/ready 后才会接入 Service 流量。如果 Pod 一直处于 0/1 Ready,请执行 kubectl logs deploy/yearning-control-plane -n yearning 对照以下 4 项探针排查:
滚动更新前请先确认平台中没有正在运行中的 DML、DDL 或 gh-ost 任务;若已存在 yearning-schema-migration 旧 Job 对象,发版前需先 kubectl delete job yearning-schema-migration -n yearning 再重新 apply。