HELM40 cmd
Helm チート集
Helm の install/upgrade/rollback、Chart 構造、values、テンプレート関数、dependencies、repository、OCI、hooks、release 確認をまとめたチート集。
- 更新日
- 2026-05-14
- 参照範囲
- 公式ドキュメント / man page / 主要ベンダーCLI
- 対象実装
- 主要 Linux / BSD / ネットワーク機器 CLI の一般的な実装
- 免責
- OS とバージョン差分は実環境で確認してください。
40 / 40
| Command | Description | Example | Copy |
|---|---|---|---|
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 |