- 添加global.imageRegistry作为统一镜像仓库地址配置项 - 创建通用image模板函数处理镜像地址拼接逻辑 - 更新所有chart使用新的镜像配置结构 - 在README中添加镜像地址约定说明 - 修改CI命令示例以包含必要的镜像配置参数 - 将硬编码的镜像地址改为通过values动态配置
61 lines
2.7 KiB
Markdown
61 lines
2.7 KiB
Markdown
# MixingX.Hub.Chart
|
||
|
||
本仓库以 git submodule 形式挂载在 [mixingx.hub](https://gitee.com/mixing-tech/mixingx.hub) 的 `mixingx-chart/` 路径下。CI(Drone)和 ArgoCD 都通过 `release-charts/` 子目录访问,改路径名会破坏部署链路。
|
||
|
||
## 拆分 Release Charts(唯一部署入口)
|
||
|
||
所有部署(CI lint/template、ArgoCD Application)都使用 `release-charts/` 下的拆分 unit chart,不再有单体主 chart:
|
||
|
||
| Chart | 职责 |
|
||
|---|---|
|
||
| `release-charts/mixingx-infra` | 共享基础设施(redis/mongo/rabbitmq/postgres) |
|
||
| `release-charts/mixingx-platform` | 中央平台服务(sso/ultra/audit/gateway) |
|
||
| `release-charts/mixingx-edge-unit` | 单个 Edge 单元(后端+前端+独立 DB+NanoMQ broker) |
|
||
| `release-charts/mixingx-agent-unit` | 单个 Agent 单元(后端+前端+独立 DB) |
|
||
| `release-charts/mixingx-gateway` | Gateway(带 MQTT broker 发现 RBAC) |
|
||
| `release-charts/mixingx-sso` | SSO(独立发布) |
|
||
| `release-charts/mixingx-ultra` | Ultra(独立发布) |
|
||
| `release-charts/mixingx-audit` | Audit(独立发布) |
|
||
| `release-charts/mixingx-protocol-server-unit` | 协议模拟器单元 |
|
||
|
||
每个 chart 独立 `helm release`,平台升级不会误删客户自加的 edge/agent 单元。
|
||
|
||
## 使用
|
||
|
||
### CI(Drone)lint + template
|
||
|
||
CI 只对 `release-charts/` 做 lint/template(见 hub `.drone.yml`):
|
||
|
||
```bash
|
||
helm lint release-charts/mixingx-edge-unit \
|
||
--set global.imageRegistry=registry.invalid/mixingx \
|
||
--set images.edge.tag=ci \
|
||
--set images.edgeWeb.tag=ci
|
||
helm template ci-edge release-charts/mixingx-edge-unit \
|
||
--set global.imageRegistry=registry.invalid/mixingx \
|
||
--set images.edge.tag=ci \
|
||
--set images.edgeWeb.tag=ci
|
||
```
|
||
|
||
### ArgoCD 部署
|
||
|
||
`mixingx-deploy` 的 ApplicationSet 按 unit chart 逐个发布,每个 edge/agent 一个独立 Helm release。详见 `mixingx-deploy/`。
|
||
|
||
## 镜像地址约定
|
||
|
||
所有部署到 K3s 的运行镜像统一按下面的结构拼接:
|
||
|
||
```text
|
||
<global.imageRegistry>/<images.*.repository>:<images.*.tag>
|
||
```
|
||
|
||
`global.imageRegistry` 必须由 `mixingx-deploy` 的环境 values 提供,Chart 不保存 AL ACR、Harbor、内网 IP 或公网镜像仓库地址。业务镜像和 PostgreSQL、Redis、RabbitMQ、MongoDB、NanoMQ 等基础镜像遵守同一规则。
|
||
|
||
生产环境必须传入明确且不可变的 tag,不使用 `latest`。AL ACR 与现场 Harbor 必须保持相同的 repository/tag,只切换 `global.imageRegistry`。
|
||
|
||
## 关联文档
|
||
|
||
- hub [AGENTS.md](https://gitee.com/mixing-tech/mixingx.hub) — 全项目指南
|
||
- `mixingx-deploy/` — ArgoCD Application + 环境 values
|
||
- `docs/superpowers/specs/2026-07-01-node-tier-affinity-design.md` — 三层调度设计
|