王野 d7366869ed feat(helm): 统一镜像地址配置规范并更新CI示例
- 添加global.imageRegistry作为统一镜像仓库地址配置项
- 创建通用image模板函数处理镜像地址拼接逻辑
- 更新所有chart使用新的镜像配置结构
- 在README中添加镜像地址约定说明
- 修改CI命令示例以包含必要的镜像配置参数
- 将硬编码的镜像地址改为通过values动态配置
2026-11-03 09:52:35 +08:00

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 + 环境 values
  • docs/superpowers/specs/2026-07-01-node-tier-affinity-design.md — 三层调度设计
S
Description
auto-mirrored from internal gitea
Readme
569 KiB
0 Stars 1 Watchers 0 Forks
Languages
Go Template 100%