Files
mixingx.deploy/RELEASE.md
T
ximenchuifeng 638d1bca8f feat(release): mxlexus 客户环境全套 + _common 共享 values(release 分支首提交)
- environments/_common/registry.yaml: 全客户共享非版本 values(ACR 地址+imagePullSecrets,铁律禁 tag)
- environments/mxlexus/: image-version 钉 v1.0.1(占位,首发由流水线改写)+ 8 个站点 values(第三方镜像显式 ACR 引用,TODO(D3) 标注现场核对项)
- applications/mxlexus/: 5 单应用 + edges/agents ApplicationSet(chart 钉 chart tag,deploy 钉 release,automated+selfHeal+prune 关)
- bootstrap/mixingx-mxlexus-root.yaml: 现场 root app
- RELEASE.md: 分支纪律(ADR-0068)
- 本地 helm 渲染验证:ACR 地址/v1.0.1/imagePullSecrets/IfNotPresent 全部正确
2026-08-22 13:11:26 +08:00

36 lines
1.8 KiB
Markdown

# release 分支纪律(ADR-0068)
本分支(`release`)是全部客户现场 ArgoCD 的唯一真相源。**平时静止,动即交付。**
## 谁能推
- 只有发布流水线(release-promote,mixingx.deploy 仓库的 Drone 流水线)可以推本分支。
- Gitee 分支保护:白名单 = 发布流水线机器账号,禁止 force push。(首次推送后配置,见改造清单 B1)
## 什么可以改
| 位置 | 谁改 | 怎么改 |
|------|------|--------|
| `environments/<customer>/image-version.yaml` | **仅流水线** | pin 步骤自动钉版 |
| `applications/<customer>/*.yaml` 的 chart targetRevision | **仅流水线** | pin 步骤自动替换 |
| `environments/<customer>/` 其余 values(站点参数) | 人工(走评审) | 直接 commit:密码、DNS、edge 清单等现场配置 |
| `environments/_common/` | 人工(走评审) | **铁律:只放非版本性内容(地址/secret 名/时区),禁止任何镜像 tag**——改这里会同时触发所有客户 |
| 其余一切(master 带来的 demo/dev 等) | **无人** | 只能通过 merge master 进入 |
## 共享变更怎么流
chart 结构/新应用等共享变化:先落 master(demo 验证),发布时流水线 pin 步骤前 `merge master`
(或人工 merge),一次惠及全部客户。
## 升级与回滚
- 升级 = 流水线推本分支 → 各现场 ArgoCD ~3 分钟自动 sync(leaf apps: automated + selfHeal,prune 关)
- 回滚 = revert 本分支上该客户目录的版本 commit → push
- 现场任何人手工 kubectl 的改动,selfHeal 会在几分钟内打回 git 版本
## 多客户演进
新客户 = 复制 `environments/mxlexus/` + `applications/mxlexus/` 为新目录 + `bootstrap/` 加 root app,
零结构改动。出现"某客户停机检修期间分支必须绝对静止"或客户数 >~5 时,再把该客户目录拆成
独立分支(结构不变,ADR-0068 Considered Options)。