IntelliJ IDEA 2025.3 Help

Helm

Helm 是一种用于管理 Kubernetes 应用程序的工具。 Helm chart 是在 Kubernetes 集群内运行的预配置资源定义包。 图表包含包的描述( Chart.yaml )和一个或多个用于生成 Kubernetes 清单文件的模板。

启用 Kubernetes 插件

此功能依赖于 Kubernetes 插件,该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Kubernetes插件,并勾选插件名称旁边的复选框。

安装 Go Template 插件

此功能依赖于 Go Template 插件,您需要安装并启用该插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 Marketplace 选项卡,找到 Go Template 插件,然后点击 安装 (如果提示,请重启 IDE)。

为 Helm 指定自定义路径

如果您将 Helm 安装在自定义目录中,您可以手动指定其路径。

  1. 设置 对话框(Ctrl+Alt+S )中,选择 构建、执行、部署 | Kubernetes

  2. 请在 Helm 可执行文件的路径 字段中指定 helm 可执行文件的路径。

  3. 请点击 测试 查看文件位置。 如果未找到,您可以手动检查文件位置,或单击 安装 ,IntelliJ IDEA 将下载并安装缺失的软件。

Kubernetes 设置窗口

Helm 图表和模板的编码辅助包括代码补全、重构、检查、快速修复和快速文档。 代码补全包括指定仓库中的依赖项的值(默认情况下来自 Helm Hub)。

在 Go 模板指令中,IntelliJ IDEA 提供了对 Helm 内置对象 和从一个 values.yaml 文件或自定义 values 文件传递的值的补全。 您可以按 Ctrl+B 导航到对象值的来源,例如,导入到父图表中的子图表值。

在模板对象中,您可以使用 代码折叠 :按 Ctrl+NumPad +Ctrl+NumPad - 在值和指令之间切换。 您也可以将鼠标悬停在值上以展开并显示指令。

导入的 Helm 数据

您还可以使用边栏图标在标签定义与标签选择器之间以及在被覆盖值和覆盖值之间进行导航。

创建一个新的 Helm 图表

  1. 项目 工具窗口中,右键点击一个文件夹并选择 新建(N) | Helm 图表

  2. 新建Helm 图表 窗口中,输入图表的名称。

这将运行 helm create命令,它添加了所有开始所需的基础文件:

  • .helmignore :构建包时忽略的模式

  • Chart.yaml :带有元数据的基本图表描述

  • values.yaml :图表模板的默认值

  • charts/ :子图表的目录

  • templates/ :图表定义目录

    • _helpers.tpl :用于您模板的局部和函数

    • NOTES.txt :部署图表后打印出的信息

    • deployment.yaml :示例 Kubernetes 部署定义

    • ingress.yaml :Kubernetes 入口定义示例

    • service.yaml :示例 Kubernetes 服务定义

预览 Helm 模板渲染结果

您可以使用 helm template 命令在本地渲染图表模板。 指定一个或多个包含值的 YAML 文件,可来自文件系统中的任意文件夹。 这支持如为不同环境使用单独值文件的用例。

  1. 如果模板文件在编辑器中打开,请点击编辑器右侧的 Helm 模板

    或者,右键点击图表并从上下文菜单中选择 Helm(H) | Helm 模板(T)

  2. 呈现Helm 模板 对话框中,添加一个或多个用于渲染的包含值的文件。 这些可以是来自您的文件系统的任意 YAML 文件。

    您还可以在 附加值 部分中提供以逗号分隔的单个值。

    Render Helm Template 对话框
  3. 点击 继续。 这将运行 helm template 命令并使用指定的值渲染 Helm 图表。

    IntelliJ IDEA 会在差异查看器中打开渲染后的预览,与原始模板文件进行对比。

更新外部依赖

  • 右键点击图表并从上下文菜单中选择 Helm(H) | Helm 依赖项更新(D)

这将运行 helm dependency update 命令。

在 Helm 2 中,依赖项应在 requirements.yaml 文件中指定。 此操作还会生成或更新 requirements.lock

在 Helm 3 中,依赖项应在 Chart.yaml 文件中指定。 如果您在错误的文件中指定了依赖项,IntelliJ IDEA会提供一个检查,并有一个快速修复来移动它们。

也有用于更新依赖项的裂缝图标,分别在 requirements.yaml Chart.yaml 文件中。

检查 chart 是否存在潜在问题

  • 右键点击图表,指向 Helm(H) ,然后点击 Helm Lint(L)

这将运行 helm lint 命令,该命令执行一系列测试,以发现可能存在的问题,而无需实际安装图表。

最后修改日期: 2025年 12月 2日