Skip to content

Release 管理

Release 是 Helm 对一次安装的封装:一个 Release 对应一个命名空间下的一组 Kubernetes 资源,每执行一次安装、升级或回滚都会产生一个新的修订(revision)。本文介绍如何查看与维护已经安装的 Release。安装新应用请参考 安装 Release,升级与回滚请参考 升级与回滚

进入 Release 列表

  1. 在左侧导航中进入 集群 → 应用管理 → Helm Release
  2. 点击菜单项 Release 列表,打开 Release 列表页。

权限要求

进入列表页需要具备 helm.kuboard.cnreleases 资源 list 权限;查看详情、升级、回滚、卸载分别需要对应的 get / create / delete 权限,未授权的操作按钮不会显示。

列表页

列表页顶部有两个下拉选择器:

  • 集群:默认选中当前用户可访问的第一个集群;
  • 命名空间:默认选中 default

切换集群或命名空间后,列表会自动刷新。Release 按命名空间隔离,不同命名空间中的同名 Release 互不影响。

表格列如下:

说明
NameRelease 名称,点击可进入详情
Namespace所属命名空间
Revision当前修订号,每安装/升级/回滚一次递增
Status部署状态,以彩色标签显示,见下表
ChartChart 名称
Chart VersionChart 版本
App Version应用版本
Updated最近一次更新的时间
操作详情:进入详情页;升级:进入升级页面

状态标签含义

状态标签以不同颜色区分,含义如下:

状态含义颜色
deployed已成功部署,当前正在生效绿色
failed安装或升级失败红色
pending / pending-install / pending-upgrade / pending-rollback操作执行中,尚未完成黄色
uninstalled已被卸载灰色
superseded已被更新的修订取代(历史修订的常见状态)灰色
unknown未知状态灰色

列表页右上角的 安装 Release 按钮用于安装新应用,操作方式见 安装 Release

Release 详情

在列表中点击 Release 名称或 详情,进入该 Release 的详情页。

概览信息

页面顶部展示:

  • 集群 / 命名空间 / 名称 / Chart / App Version
  • 状态标签、Chart VersionRevisionUpdated(最近更新时间);
  • Description(描述):内容较长时只显示一行,鼠标悬停可查看完整文本。

右上角提供 升级卸载 两个操作按钮(按权限显示)。

修订历史与对比

Revision History 标签页列出该 Release 的完整修订历史,每行一个修订:

说明
Revision修订号
Updated修订创建时间
Status修订状态(当前生效的修订为 deployed
Chart该修订使用的 Chart
Description该修订的描述
操作回滚到此:将该 Release 回滚到这一修订(当前 deployed 修订的按钮为禁用状态)

对比两个修订的差异:

  1. 勾选行首复选框,选中两个或多个修订(多选时,对比的是所选范围内最早与最新的两个修订);
  2. 表格下方出现 对比 (N) 按钮,点击打开"Revision 对比"窗口;
  3. 窗口上方可分别调整要对比的 Revision 1 / Revision 2,下方提供两个标签页:
    • Values:两份修订的 values 差异;
    • Manifest:两份修订渲染出的 Kubernetes 资源清单差异。

回滚操作的具体步骤见 升级与回滚

查看 values / manifest / notes

详情页其余三个标签页均为只读查看(右上角提供 复制 按钮):

标签页内容
Values当前修订的 values 配置(YAML)
Manifest当前修订实际渲染出的 Kubernetes 资源清单
NotesChart 作者提供给用户的使用说明(如访问地址、默认账号等)

历史修订的 values 与 manifest

修订对比窗口内部按需加载所选修订的 values 与 manifest,因此即使是很久以前的修订,也可以查看和对比其完整配置。

卸载 Release

  1. 在 Release 详情页右上角点击 卸载
  2. 在弹出的 卸载 Release 确认对话框中核对 Release 名称与命名空间,并确认提示信息:此操作将删除该 Release 管理的所有 Kubernetes 资源
  3. 点击 确认卸载

卸载确认框中没有额外的勾选项:Helm 3 的卸载默认会同时删除 Release 记录与其修订历史(等价于旧版 Helm 的 --purge),因此不存在"是否保留记录"的选择。

卸载后

  • 点击确认后跳转到操作事件页,实时显示卸载进度与日志,直至完成;
  • 卸载完成后,该 Release 从列表页消失;
  • 卸载操作不可撤销,执行前请确认该应用不再需要,或已做好数据备份。

卸载影响范围

卸载会删除该 Release 管理的全部 Kubernetes 资源(Deployment、Service、ConfigMap 等),但不会删除由外部(非 Helm 管理)创建的资源。若希望保留 Release 记录以便追溯,可在集群上直接使用 helm uninstall --keep-history 命令行方式操作。

安装、升级、回滚、卸载等长任务都会在 操作事件 页面记录执行过程,可随时查看。