# Helm

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

[Helm](https://helm.sh/) 是一种用于管理 Kubernetes 应用程序的工具。 Helm chart 是在 Kubernetes 集群内运行的预配置资源定义包。 chart 包含软件包的描述 (  `Chart.yaml` ) 以及一个或多个用于生成 Kubernetes 清单文件的模板。

Procedure: 启用 Kubernetes 插件

此功能依赖于 [Kubernetes](https://plugins.jetbrains.com/plugin/10485-kubernetes) 插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 在未订阅 Ultimate 版的情况下，IntelliJ IDEA 中无法使用 Kubernetes 插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Kubernetes  插件，然后点击   启用  。

Procedure: 安装 Go 模板插件

此功能性依赖于 [Go 模板](https://plugins.jetbrains.com/plugin/10581-go-template) 插件，需要安装并启用该插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Go 模板  插件，然后点击   安装  。 如果出现提示，请重启 IDE。

> **Note:**
> 如果您使用 Helm 功能（例如，创建一个 chart），但是您的计算机上没有安装 Helm，则会出现一个通知，提供下载和安装其最新稳定版本的选项。 Helm 将被安装在  `/usr/local/bin` （在 macOS 和 Linux 上）或  `<home>\.jetbrains` （在 Windows 上）。

Procedure: 为 Helm 指定自定义路径

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

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择  `构建、执行、部署 | Kubernetes` 。

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

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

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

IntelliJ IDEA 还为 [helmfiles](https://github.com/helmfile/helmfile) 提供代码洞察，包括针对  `helmfile.yaml`  中属性和值的补全、导航、高亮显示和其他辅助功能。

在 Go 模板指令中，IntelliJ IDEA 提供了对 Helm [内置对象](https://helm.sh/docs/chart_template_guide/builtin_objects/) 和从一个  `values.yaml`  文件或自定义 values 文件传递的值的补全。 您可以按 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) 导航到对象值的来源，例如，导入到父图表中的子图表值。

在模板对象中，可以使用 [代码折叠](working-with-source-code.html#code_folding): 按 `Ctrl+NumPad +` (Windows), `⌘ NumPad +` (macOS), `⌘ NumPad +` (IntelliJ IDEA Classic (macOS)), `⌘ NumPad +` (macOS System Shortcuts), `Ctrl+NumPad +` (XWin), `Ctrl+NumPad +` (GNOME), `Ctrl+NumPad +` (KDE), `Ctrl+NumPad +` (Emacs), `Ctrl+Shift+]` (Sublime Text), `⌘ ⌥ ]` (Sublime Text (macOS)), `Ctrl+M, E` (Visual Studio), `⌃ M, E` (Visual Studio (macOS)), `Ctrl+NumPad +` (NetBeans), `Ctrl+NumPad +` (Eclipse), `⌘ NumPad +` (Eclipse (macOS)) 和 `Ctrl+NumPad -` (Windows), `⌘ NumPad -` (macOS), `⌘ NumPad -` (IntelliJ IDEA Classic (macOS)), `⌘ NumPad -` (macOS System Shortcuts), `Ctrl+NumPad -` (XWin), `Ctrl+NumPad -` (GNOME), `Ctrl+NumPad -` (KDE), `Ctrl+NumPad -` (Emacs), `Ctrl+Shift+[` (Sublime Text), `⌘ ⌥ [` (Sublime Text (macOS)), `Ctrl+M, S` (Visual Studio), `⌃ M, S` (Visual Studio (macOS)), `Ctrl+NumPad -` (NetBeans), `Ctrl+NumPad -` (Eclipse), `⌘ NumPad -` (Eclipse (macOS)) 在值和指令之间切换。 您也可以将鼠标悬停在值上以展开并显示指令。

![导入的 Helm 数据](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_import_values.animated.gif)

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

Procedure: 创建一个新的 Helm 图表

1. 在   项目  工具窗口中，右键点击一个文件夹并选择  `新建 | Helm 图表` 。

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

这将运行 [helm create](https://helm.sh/docs/helm/helm_create/)命令，它添加了所有开始所需的基础文件：

* `.helmignore` ：构建包时忽略的模式

* `Chart.yaml` ：带有元数据的基本图表描述

* `values.yaml` ：图表模板的默认值

* `charts/` ：子图表的目录

* `templates/` ：图表定义目录 * `_helpers.tpl` ：用于您模板的局部和函数 * `NOTES.txt` ：部署图表后打印出的信息 * `deployment.yaml` ：示例 Kubernetes 部署定义 * `ingress.yaml` ：Kubernetes 入口定义示例 * `service.yaml` ：示例 Kubernetes 服务定义

Procedure: 预览 Helm 模板渲染结果

可以使用 [helm template](https://helm.sh/docs/helm/helm_template/) 命令在本地渲染 chart 模板。 指定来自文件系统中任意文件夹的一个或多个包含值的 YAML 文件。 这支持为不同环境使用单独的值文件等用例。

1. 如果模板文件在编辑器中打开，请点击编辑器右侧的 ![Helm 模板](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-kubernetes.icons.helmNotes.svg)。

或者，右键点击 chart，然后从上下文菜单中选择  `Helm | Helm 模板` 。

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

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

![“渲染 Helm 模板”对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/render-helm-template.png)

3. 点击   继续  。 这会运行 [helm template](https://helm.sh/docs/helm/helm_template/) 命令，并使用指定值渲染 Helm chart。

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

Procedure: 更新外部依赖

* 右键点击 chart，然后从上下文菜单中选择  `Helm | Helm 依赖项更新` 。

这将运行 [helm dependency update](https://helm.sh/docs/helm/helm_dependency_update/) 命令。

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

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

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

Procedure: 检查 chart 是否存在潜在问题

* 右键点击 chart，指向   Helm  ，然后点击   Helm Lint  。

这将运行 [helm lint](https://helm.sh/docs/helm/helm_lint/) 命令，该命令执行一系列测试，以发现可能存在的问题，而无需实际安装图表。

