CI/CD / 系统课时

给 Chart 增加可控的依赖关系

给 Chart 增加可控的依赖关系

当应用依赖 Redis、数据库或其他可复用 Chart 时,不应靠人工分别安装。Helm 可以在 Chart.yaml 中声明依赖,并通过锁文件固定解析结果,让依赖下载、版本升级和最终渲染都进入可验证的发布流程。

学习目标

  • 会在 Chart.yaml 中声明 Chart 依赖并更新本地依赖包
  • 理解版本约束、Chart.lock 与 charts/ 目录各自控制什么
  • 能验证父 Chart 与依赖 Chart 最终渲染出的资源

声明依赖而不是手工安装

假设应用需要 Redis,可以把依赖直接写入父 Chart 的 Chart.yaml。下面使用 Bitnami Redis Chart 作为结构示例;实际使用前应根据目标仓库当前存在的版本调整约束。

yaml
apiVersion: v2
name: shop
version: 0.1.0
type: application
dependencies:
  - name: redis
    version: ">=20.0.0 <21.0.0"
    repository: "https://charts.bitnami.com/bitnami"
    condition: redis.enabled

这是配置文件示例,不直接产生控制台输出。condition 允许父 Chart 通过值控制是否启用该依赖,例如在 values.yaml 中提供:

yaml
redis:
  enabled: true

验证方法是进入 Chart 根目录执行依赖更新。Helm 会解析版本约束、下载依赖,并生成或更新锁文件。

bash
helm dependency update .

预期输出的具体版本和摘要会随仓库内容变化,成功时可看到依赖仓库更新和 Chart 下载完成的信息,例如:

text
...Successfully got an update from the "<REPOSITORY>" chart repository
...Update Complete.
Saving <COUNT> charts
Downloading redis from repo https://charts.bitnami.com/bitnami
Deleting outdated charts

<REPOSITORY>、<COUNT> 等实际值可能不同。更新后通常会出现 Chart.lock,并在 charts/ 中保存下载的依赖包。

让版本解析结果可重复

Chart.yaml 描述的是允许选择哪些依赖版本,而 Chart.lock 记录一次依赖解析得到的确定结果。团队和 CI 已经有锁文件时,应优先使用 helm dependency build 根据锁文件重建 charts/,而不是每次重新解析版本范围。

bash
rm -rf charts
helm dependency build .

预期输出会包含依赖下载信息,具体版本由当前 Chart.lock 决定:

text
Saving <COUNT> charts
Downloading redis from repo https://charts.bitnami.com/bitnami
Deleting outdated charts

因此,修改依赖约束属于一次显式升级动作:更新 Chart.yaml,执行 helm dependency update,检查新的 Chart.lock,再把两者作为同一次代码变更评审。这样 Git 中不仅记录“想要什么版本”,也记录“实际解析到了什么版本”。

Helm Chart依赖解析与锁定流程

理解渲染而不是依赖安装顺序

依赖 Chart 被打包进父 Chart 后,Helm 会把父 Chart 与启用的子 Chart 模板一起渲染成一组 Kubernetes manifests。不要把 dependencies 列表顺序理解成“先安装 Redis,再安装应用”的通用启动编排机制。

Kubernetes 资源创建和 Pod 就绪是不同问题。即使依赖中的 Service、StatefulSet 与应用 Deployment 都已提交给 API Server,也不能据此保证 Redis 已经 Ready。应用仍应通过 readiness probe、连接重试等机制处理运行期依赖。

可以在发布前直接查看完整渲染结果:

bash
helm template shop . --set redis.enabled=true > /tmp/shop-rendered.yaml
grep '^kind:' /tmp/shop-rendered.yaml

预期输出取决于父 Chart 和所选 Redis Chart 的模板,关键是同时能看到父 Chart 与启用依赖产生的资源类型,例如:

text
kind: <PARENT_RESOURCE_KIND>
kind: <DEPENDENCY_RESOURCE_KIND>
...

这里的资源数量和类型会随 Chart 版本变化,因此不应把某个固定清单当成验证标准。更可靠的检查是确认预期依赖资源存在、命名和 values 覆盖正确,并结合 helm lint . 做基础校验。

控制可选依赖的边界

并非所有外部系统都适合作为子 Chart。开发环境可能希望一键部署 Redis,而生产环境可能连接平台团队维护的独立 Redis,此时 condition 很有价值:开发 values 启用依赖,生产 values 关闭依赖并提供外部地址。

依赖管理的核心不是减少几条安装命令,而是让依赖声明、解析结果和渲染产物都可以在 Git 与 CI 中复现和审查。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

给 Chart 增加可控的依赖关系

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通