develop/wy
- 添加global.imageRegistry作为统一镜像仓库地址配置项 - 创建通用image模板函数处理镜像地址拼接逻辑 - 更新所有chart使用新的镜像配置结构 - 在README中添加镜像地址约定说明 - 修改CI命令示例以包含必要的镜像配置参数 - 将硬编码的镜像地址改为通过values动态配置
MixingX.Hub.Chart
本仓库以 git submodule 形式挂载在 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):
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 的运行镜像统一按下面的结构拼接:
<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 — 全项目指南
mixingx-deploy/— ArgoCD Application + 环境 valuesdocs/superpowers/specs/2026-07-01-node-tier-affinity-design.md— 三层调度设计
Languages
Go Template
100%