Back to Details

helm

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Helm

Helm

Helm helps you manage Kubernetes applications via Charts (packages of pre-configured K8s resources). Helm v4 (2025) improves OCI integration and enables server-side apply.
Helm 帮助你通过Charts（预配置K8s资源的包）管理Kubernetes应用。Helm v4（2025版）提升了OCI集成能力，并支持服务端应用（server-side apply）。

When to Use

适用场景

  • Packaging: Distribute your K8s app to others.
  • Templating: Manage complexity. One 
    deployment.yaml
    template for Dev, Staging, and Prod.
  • Management: Easy upgrades/rollbacks (
    helm rollback
    ).
  • 打包发布：将你的K8s应用分发给其他用户。
  • 模板化管理：应对复杂场景。仅需一个
    deployment.yaml
    模板，即可适配开发、预发布和生产环境。
  • 应用生命周期管理：轻松完成升级/回滚操作（使用
    helm rollback
    命令）。

Quick Start

快速开始

bash
undefined
bash
undefined

Install a chart

安装Chart

helm install my-release oci://registry-1.docker.io/bitnamicharts/nginx
helm install my-release oci://registry-1.docker.io/bitnamicharts/nginx

Create a chart

创建Chart

helm create my-chart

```yaml
helm create my-chart

```yaml

values.yaml

values.yaml

replicaCount: 2 image: repository: nginx tag: "1.25"
undefined
replicaCount: 2 image: repository: nginx tag: "1.25"
undefined

Core Concepts

核心概念

Charts

Charts

A collection of files that describe a related set of Kubernetes resources. 
Chart.yaml
, 
values.yaml
, 
templates/
.
一组描述相关Kubernetes资源的文件集合。包含
Chart.yaml
、
values.yaml
、
templates/
目录。

OCI Registries

OCI 镜像仓库

Helm v4 treats OCI (Docker) registries as first-class citizens. You push Charts to Docker Hub/ECR/GHCR just like container images.
Helm v4 将OCI（Docker）镜像仓库视为一等公民。你可以像推送容器镜像一样，将Charts推送到Docker Hub/ECR/GHCR等仓库。

Release

Release

An instance of a chart running in a cluster.
Chart在集群中运行的实例。

Best Practices (2025)

2025年最佳实践

Do:
  • Store Charts in OCI: Push charts to your container registry (
    helm push
    ). Deprecate HTTP chart repositories.
  • Use 
    helm upgrade --install
    : Idempotent command for CI/CD pipelines.
  • Use 
    helm lint
    & 
    kubeval
    : Validate templates before deploying.
Don't:
  • Don't overuse logic in templates: If your Go templates look like spaghetti code, consider using a simpler tool (Kustomize) or an Operator.
建议：
  • 将Charts存储在OCI仓库：使用
    helm push
    命令将Charts推送到你的容器镜像仓库。弃用HTTP Chart仓库。
  • 使用
    helm upgrade --install
    命令    ：这是CI/CD流水线中的幂等命令。
  • 使用
    helm lint
    & 
    kubeval
    工具    ：在部署前验证模板的有效性。
不建议：
  • 不要在模板中过度使用逻辑：如果你的Go模板变得杂乱无章，考虑使用更简单的工具（如Kustomize）或Operator。

References

参考资料