HELM40 cmd

Helm チート集

Helm の install/upgrade/rollback、Chart 構造、values、テンプレート関数、dependencies、repository、OCI、hooks、release 確認をまとめたチート集。

更新日: 2026-05-29
参照範囲: 公式ドキュメント / man page / 主要ベンダーCLI
対象実装: 主要 Linux / BSD / ネットワーク機器 CLI の一般的な実装
免責: OS とバージョン差分は実環境で確認してください。

このチートシートの使いどころ

Helm チート集は、Helm の install/upgrade/rollback、Chart 構造、values、テンプレート関数、dependencies、repository、OCI、hooks、release 確認をまとめたチート集。対象は公式ドキュメント、man page、主要ベンダー CLI で確認できる現行の一般的な実装です。カテゴリはインストール・運用、Chart 構造、テンプレート、release 管理、repositoryを中心に、40件のコマンドや値を用途別に引けます。障害調査、設定変更前の確認、作業メモ作成で、Helm、Kubernetes、Chart、values.yaml、templateに関連する操作を短時間で探すために使います。

40 / 40

helm install

Chart をインストールする。

Example

helm install web ./charts/web -n prod --create-namespace

helm upgrade --install

存在すれば更新、なければ作成する。

Example

helm upgrade --install web ./charts/web -n prod -f values-prod.yaml

helm uninstall

release を削除する。

Example

helm uninstall web -n prod

helm list

release 一覧を表示する。

Example

helm list -A

helm status

release 状態を確認する。

Example

helm status web -n prod

helm history

release 履歴を確認する。

Example

helm history web -n prod

helm rollback

指定 revision へ戻す。

Example

helm rollback web 3 -n prod

helm get values

適用済み values を確認する。

Example

helm get values web -n prod -a

helm get manifest

レンダリング済み manifest を取得する。

Example

helm get manifest web -n prod

helm get hooks

hook manifest を確認する。

Example

helm get hooks web -n prod

helm get notes

NOTES を表示する。

Example

helm get notes web -n prod

--dry-run --debug

適用せずレンダリングと値を確認する。

Example

helm upgrade --install web ./charts/web -n prod --dry-run --debug

helm template

ローカルで manifest を出力する。

Example

helm template web ./charts/web -n prod -f values-prod.yaml > rendered.yaml

helm lint

Chart を検査する。

Example

helm lint ./charts/web

helm create

Chart 雛形を作成する。

Example

helm create charts/web

Chart.yaml

Chart メタデータを定義する。

Example

apiVersion: v2
name: web
type: application
version: 0.1.0
appVersion: "1.2.3"

values.yaml

既定値を定義する。

Example

replicaCount: 2
image:
  repository: ghcr.io/example/web
  tag: "1.2.3"

templates/_helpers.tpl

名前生成 helper を置く。

Example

{{- define "web.fullname" -}}
{{ printf "%s-%s" .Release.Name .Chart.Name | trunc 63 | trimSuffix "-" }}
{{- end }}

.Values

values を参照する。

Example

image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"

default

未指定時の既定値を使う。

Example

replicas: {{ default 2 .Values.replicaCount }}

include

helper テンプレートを呼ぶ。

Example

name: {{ include "web.fullname" . }}

required

必須 value を検証する。

Example

host: {{ required "ingress.host is required" .Values.ingress.host }}

toYaml nindent

YAML オブジェクトをインデントする。

Example

resources:
{{- toYaml .Values.resources | nindent 2 }}

tpl

values 内テンプレートを評価する。

Example

annotations:
  checksum/config: {{ tpl .Values.configTemplate . | sha256sum }}

range

リストを繰り返す。

Example

{{- range .Values.extraEnv }}
- name: {{ .name }}
  value: {{ .value | quote }}
{{- end }}

if with

条件付きでブロックを出す。

Example

{{- if .Values.ingress.enabled }}
apiVersion: networking.k8s.io/v1
kind: Ingress
{{- end }}

dependencies

Chart 依存を定義する。

Example

dependencies:
- name: redis
  version: 20.6.1
  repository: https://charts.bitnami.com/bitnami

helm dependency update

依存 Chart を取得する。

Example

helm dependency update ./charts/web

helm repo add

Chart repository を追加する。

Example

helm repo add bitnami https://charts.bitnami.com/bitnami

helm repo update

repository index を更新する。

Example

helm repo update

helm search repo

repository 内 Chart を検索する。

Example

helm search repo bitnami/redis --versions | head

OCI login

OCI registry へ login する。

Example

helm registry login ghcr.io -u USER -p TOKEN

OCI install

OCI Chart を install する。

Example

helm install web oci://ghcr.io/example/charts/web --version 1.2.3

helm package

Chart を tgz に固める。

Example

helm package ./charts/web --destination dist

helm push

OCI registry へ Chart を push する。

Example

helm push dist/web-0.1.0.tgz oci://ghcr.io/example/charts

pre-install hook

install 前 Job を hook にする。

Example

metadata:
  annotations:
    helm.sh/hook: pre-install
    helm.sh/hook-delete-policy: before-hook-creation,hook-succeeded

post-install hook

install 後処理を hook にする。

Example

metadata:
  annotations:
    helm.sh/hook: post-install

pre-upgrade hook

upgrade 前 migration を実行する。

Example

metadata:
  annotations:
    helm.sh/hook: pre-upgrade
    helm.sh/hook-weight: "-5"

atomic timeout

失敗時に自動 rollback する。

Example

helm upgrade --install web ./charts/web -n prod --atomic --timeout 10m

reuse-values

既存 values を再利用して一部だけ上書きする。

Example

helm upgrade web ./charts/web -n prod --reuse-values --set image.tag=1.2.4

Command	Description	Example
`helm install`	Chart をインストールする。	`helm install web ./charts/web -n prod --create-namespace`
`helm upgrade --install`	存在すれば更新、なければ作成する。	`helm upgrade --install web ./charts/web -n prod -f values-prod.yaml`
`helm uninstall`	release を削除する。	`helm uninstall web -n prod`
`helm list`	release 一覧を表示する。	`helm list -A`
`helm status`	release 状態を確認する。	`helm status web -n prod`
`helm history`	release 履歴を確認する。	`helm history web -n prod`
`helm rollback`	指定 revision へ戻す。	`helm rollback web 3 -n prod`
`helm get values`	適用済み values を確認する。	`helm get values web -n prod -a`
`helm get manifest`	レンダリング済み manifest を取得する。	`helm get manifest web -n prod`
`helm get hooks`	hook manifest を確認する。	`helm get hooks web -n prod`
`helm get notes`	NOTES を表示する。	`helm get notes web -n prod`
`--dry-run --debug`	適用せずレンダリングと値を確認する。	`helm upgrade --install web ./charts/web -n prod --dry-run --debug`
`helm template`	ローカルで manifest を出力する。	`helm template web ./charts/web -n prod -f values-prod.yaml > rendered.yaml`
`helm lint`	Chart を検査する。	`helm lint ./charts/web`
`helm create`	Chart 雛形を作成する。	`helm create charts/web`
`Chart.yaml`	Chart メタデータを定義する。	`apiVersion: v2 name: web type: application version: 0.1.0 appVersion: "1.2.3"`
`values.yaml`	既定値を定義する。	`replicaCount: 2 image: repository: ghcr.io/example/web tag: "1.2.3"`
`templates/_helpers.tpl`	名前生成 helper を置く。	`{{- define "web.fullname" -}} {{ printf "%s-%s" .Release.Name .Chart.Name \| trunc 63 \| trimSuffix "-" }} {{- end }}`
`.Values`	values を参照する。	`image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"`
`default`	未指定時の既定値を使う。	`replicas: {{ default 2 .Values.replicaCount }}`
`include`	helper テンプレートを呼ぶ。	`name: {{ include "web.fullname" . }}`
`required`	必須 value を検証する。	`host: {{ required "ingress.host is required" .Values.ingress.host }}`
`toYaml nindent`	YAML オブジェクトをインデントする。	`resources: {{- toYaml .Values.resources \| nindent 2 }}`
`tpl`	values 内テンプレートを評価する。	`annotations: checksum/config: {{ tpl .Values.configTemplate . \| sha256sum }}`
`range`	リストを繰り返す。	`{{- range .Values.extraEnv }} - name: {{ .name }} value: {{ .value \| quote }} {{- end }}`
`if with`	条件付きでブロックを出す。	`{{- if .Values.ingress.enabled }} apiVersion: networking.k8s.io/v1 kind: Ingress {{- end }}`
`dependencies`	Chart 依存を定義する。	`dependencies: - name: redis version: 20.6.1 repository: https://charts.bitnami.com/bitnami`
`helm dependency update`	依存 Chart を取得する。	`helm dependency update ./charts/web`
`helm repo add`	Chart repository を追加する。	`helm repo add bitnami https://charts.bitnami.com/bitnami`
`helm repo update`	repository index を更新する。	`helm repo update`
`helm search repo`	repository 内 Chart を検索する。	`helm search repo bitnami/redis --versions \| head`
`OCI login`	OCI registry へ login する。	`helm registry login ghcr.io -u USER -p TOKEN`
`OCI install`	OCI Chart を install する。	`helm install web oci://ghcr.io/example/charts/web --version 1.2.3`
`helm package`	Chart を tgz に固める。	`helm package ./charts/web --destination dist`
`helm push`	OCI registry へ Chart を push する。	`helm push dist/web-0.1.0.tgz oci://ghcr.io/example/charts`
`pre-install hook`	install 前 Job を hook にする。	`metadata: annotations: helm.sh/hook: pre-install helm.sh/hook-delete-policy: before-hook-creation,hook-succeeded`
`post-install hook`	install 後処理を hook にする。	`metadata: annotations: helm.sh/hook: post-install`
`pre-upgrade hook`	upgrade 前 migration を実行する。	`metadata: annotations: helm.sh/hook: pre-upgrade helm.sh/hook-weight: "-5"`
`atomic timeout`	失敗時に自動 rollback する。	`helm upgrade --install web ./charts/web -n prod --atomic --timeout 10m`
`reuse-values`	既存 values を再利用して一部だけ上書きする。	`helm upgrade web ./charts/web -n prod --reuse-values --set image.tag=1.2.4`