跳到主要内容

Helm 软件包 Release

软件包工作区提供四个视图,用于管理所选集群中的 Helm 软件:

  • 发布:查看已安装 Release、Values、渲染资源和修订历史。
  • Chart 目录:搜索 Artifact Hub、浏览托管 Helm 仓库和上传 .tgz Chart。
  • 仓库:由管理员管理 Helm 仓库和 OCI Registry。
  • 自动升级:管理受安全控制的 Chart 升级策略。

具备权限的用户可以安装 Chart、升级、回滚到早期修订或移除 Release。移除时必须 输入准确名称,同一 Release 的并发修改会被拒绝。

查找与检查 Chart

Artifact Hub 搜索同时支持 HTTPS Helm 仓库和公开 OCI Chart 引用。管理员可以浏览 已启用的托管 Helm 仓库。Editor 和管理员可以上传最大 50 MiB 的打包 Chart;上传 内容只在服务端受限内存中保留 30 分钟,绑定上传用户,并且不会持久化。

安装前可查看 Chart 的 README、默认 Values、模板、依赖、版本和摘要。KubeVision 不接受服务端本地路径或明文 HTTP Chart 来源。

仓库与凭据

管理员可以添加 HTTPS Helm 仓库和 OCI Registry、测试连接,并按需提供 Basic Auth 凭据。密码使用 KubeVision 配置的加密密钥进行静态加密,保存后 API 不会再次返回。

默认拒绝私网目标。管理员可以为单个托管仓库开启私网访问,该选项只应对可信的 内部服务启用。HTTPS 重定向跨域时会移除 Authorization 请求头。

托管仓库及其凭据仅限管理员使用。具有 package-releases:installpackage-releases:upgrade 权限的角色仍可使用公开 OCI Chart 和本人上传的临时 Chart。

安装或升级

可以在发布视图选择安装 Chart,也可以安装检查过的目录结果;在 Release 详情页选择升级。KubeVision 支持公开 oci:// 引用、HTTPS .tgz 直链、Chart 名称与 HTTPS Helm 仓库 URL 的组合、托管仓库以及临时上传。

以 JSON 对象填写覆盖值后选择预览变更。KubeVision 会执行服务端 Helm Dry Run, 展示渲染资源、Hook、风险和已脱敏清单。一次性确认信息十分钟后过期,并绑定用户、 集群、Release、Chart 来源、Values、操作类型和渲染摘要。执行前会再次 Dry Run, 输出发生变化时会拒绝操作。

检查更新

安装或升级成功后,KubeVision 会记录不含凭据的 Chart 来源。在 Release 详情页选择 检查更新,即可将当前 Chart 与索引 Helm 仓库中的最新稳定语义版本进行比较。 发现更新后,KubeVision 会自动填入 Chart 和目标版本并进入原有的受控升级流程。 覆盖值保持为空对象时,Helm 会复用 Release 已有 Values,包括长期密钥,不会把页面 中的脱敏值重新写回集群。

启用来源记录之前安装的 Release 只需填写一次 Chart 名称和仓库地址,KubeVision 验证仓库后会保存关联。OCI Chart、归档直链和临时上传不提供可移植的版本索引,仍 使用手动升级。检查更新不会跳过预览或高风险确认。

自动升级

管理员可以将已安装 Release 绑定到启用的托管 Helm 仓库,并配置语义化版本约束、 明确覆盖的 Values 和 15 分钟至 7 天的检查间隔。每次检查会选择符合约束的最新版 本,将新 Chart 默认值、当前 Release Values 和策略覆盖值依次合并,并使用与手动 变更相同的预览、摘要校验和原子升级流程。发现严重风险时会阻塞策略,等待人工审查。

自动升级目前只支持带索引的 Helm 仓库。OCI Chart 仍支持手动安装和升级,但暂未 启用 OCI 自动版本发现。

安全控制

严重风险包括 CRD、RBAC 角色或绑定、Admission Webhook、Namespace、特权或 root 容器、权限提升、增加 Linux Capability、主机端口、hostPath 和主机命名空间访问。 非管理员不能执行包含严重风险的预览,自动升级则始终阻塞此类变更。

除非管理员为托管仓库明确开启,否则下载会拒绝私网目标,同时拒绝不安全重定向、 过大的仓库索引和超过 50 MiB 的归档。使用 Helm lookup 函数的 Chart 会被拒绝, 因为使用仪表盘凭据渲染时可能暴露用户有效权限之外的资源。

Helm 操作使用 KubeVision 持有的集群凭据,因此应严格控制安装和升级权限,并在 每次操作前审查预览。Values 和 Secret 清单会在展示前脱敏,但敏感信息仍应通过 Kubernetes Secret 或外部密钥系统管理。