SuperAPI AI 工具集

nvca-chart-release

部署与运维

查看项目

更新于 10-16 15:49

技能介绍

NVCA Operator Chart Release 工作流用于将 Helm Chart 变更沿原生单体仓库路径传播,主要用途是更新 vendored NVCA Operator Chart、同步自管理默认值并发布 helm-nvca-operator。

核心路径分为三部分:NVCA 源位于 src/compute-plane-services/nvca,包含 Operator 和 agent 源码以及位于 deployments/nvca-operator/ 的源 Chart;vendored Chart 位于 deploy/helm/nvca-operator,用于 vendoring 源 Chart、应用自管理默认值并发布 helm-nvca-operator;自管理栈位于 deploy/stacks/self-managed,用于控制平面 Helmfile 部署与环境默认值。

使用方式:当 Operator、agent 或源 Chart 行为发生变化时,先在 src/compute-plane-services/nvca 中进行源变更并测试;再从 src/compute-plane-services/nvca/deployments/nvca-operator/ 的源 Chart 进行 vendoring。需要设置版本输入,可在环境或 deploy/helm/nvca-operator/.env 中配置 NVCA_OPERATOR_VERSION、NVCA_VERSION、NVCA_SHARED_STORAGE_IMAGE_TAG。随后在 deploy/helm/nvca-operator 目录执行 make vendor-chart、make lint、make template、make validate 进行 vendoring 与校验。若需针对本地自管理控制平面测试 Chart,可在该 Chart 子树中渲染 stack-aware values 并安装,使用 additional_values=override.yml 做一次性验证,不应为测试该 Chart 而修改 stack。

CI 与发布:伞形 CI 在 tools/ci/subproject-validations.yaml 中声明,子项目 id 为 nvca-operator,不应添加 Chart 本地 .gitlab-ci.yml。可通过 tools/ci/validate-helm-chart 校验与 CI 相同的 Chart 路径,并配合 tools/ci/helm-validate-values/nvca-operator.yaml。

本地镜像测试:在 k3d 中测试本地镜像时,需从 src/compute-plane-services/nvca 构建并导入测试集群,保持标签显式并与 Chart values 匹配,例如 export NVCA_OPERATOR_VERSION=dev-local 和 NVCA_VERSION=dev-local,再运行 docker build 构建 nvca-operator 与 nvca 镜像。创建或删除 k3d 集群前应遵循本地开发安全指引。

限制与注意事项:make vendor-chart 会覆盖 vendored nvca-operator/ Chart;Chart 发布生成依赖伞形层面的 Conventional Commit 语义,需要发布 Chart 时应使用 feat 或 fix;image.、nvcaImage.、ngcConfig.* 和 selfManaged.* 等值需与 stack 及源镜像标签保持同步;不得提交服务密钥、kubeconfig、渲染后的 secret 或本地仓库凭据。关于支持平台、收费与价格等信息暂未提供。