Helm の動作を試すだけなら、大きなアプリケーションや外部公開の仕組みを用意する必要はありません。Nginx を起動する Deployment と ClusterIP Service を一つずつ定義すれば、Chart の作成、values の反映、インストール、更新、削除までを確認できます。この記事では、4 ファイルだけのテスト用 Chart を作成します。
接続確認には kubectl port-forward を使います。Ingress、LoadBalancer、永続ボリューム、独自のヘルパーテンプレートは使わず、Helm が値を Kubernetes リソースへ展開する関係を追える構成にします。
前提と確認する範囲
操作端末に Helm と kubectl があり、接続先クラスタで Namespace、Deployment、Service を作成できることが前提です。ノードから Docker Hub の Nginx イメージを取得できる必要もあります。最初に context を確認し、テスト対象のクラスタを選択します。
helm version --short
kubectl config current-context
kubectl get nodes以下は Bash または Zsh で実行する例です。専用 Namespace は helm-test、Release 名は test-web とします。Chart の構文とテンプレート出力は Helm 3.19.0 で確認しています。クラスタ上の動作は、後述する手順で利用環境ごとに確認します。
Chart の構成
| ファイル | 役割 |
|---|---|
| Chart.yaml | Chart 自体の名前、種類、バージョンを定義します。 |
| values.yaml | レプリカ数、イメージ、Service のポートの初期値を定義します。 |
| templates/deployment.yaml | Nginx の Pod を管理する Deployment を定義します。 |
| templates/service.yaml | Pod を選択する ClusterIP Service を定義します。 |
helm create の雛形は便利ですが、ここでは内容を把握しやすいように必要なファイルを直接作ります。作業ディレクトリ内に同名のファイルがない場所で、次のコマンドを実行します。
mkdir -p test-web/templatesChart.yaml を作成する
version は Chart 自体のバージョンです。appVersion はアプリケーションのバージョンを示す情報であり、これを書くだけでコンテナイメージが切り替わるわけではありません。実際のイメージは values と Deployment テンプレートで指定します。
cat > test-web/Chart.yaml <<'EOF'
apiVersion: v2
name: test-web
description: Minimal web application for Helm testing
type: application
version: 0.1.0
appVersion: "1.28"
EOFvalues.yaml を作成する
初期状態は 1 Pod です。イメージタグは latest にせず明示していますが、このタグでも配布元の更新によって実体が変わる可能性があります。完全な再現性が必要な検証では digest 固定へ拡張します。service.port は Service 側の待ち受けポートであり、Nginx 自身のポートは 80 のままです。
cat > test-web/values.yaml <<'EOF'
replicaCount: 1
image:
repository: nginx
tag: "1.28-alpine"
service:
port: 80
EOFtemplates/deployment.yaml を作成する
Release 名を Deployment 名と Pod の識別ラベルに使います。Deployment の selector と Pod のラベルを一致させることで、管理対象を明確にしています。readinessProbe は HTTP 応答を確認し、起動していても応答できない Pod を Service の通常の転送対象から外すために置いています。
cat > test-web/templates/deployment.yaml <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata:
name: {{ .Release.Name }}
spec:
replicas: {{ .Values.replicaCount }}
selector:
matchLabels:
app.kubernetes.io/instance: {{ .Release.Name }}
template:
metadata:
labels:
app.kubernetes.io/instance: {{ .Release.Name }}
spec:
containers:
- name: nginx
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
ports:
- name: http
containerPort: 80
readinessProbe:
httpGet:
path: /
port: http
initialDelaySeconds: 2
periodSeconds: 5
EOFtemplates/service.yaml を作成する
Service は Release 名のラベルで Pod を選び、名前付きポート http へ転送します。Deployment と Service の selector が一致しなければ、Pod が Running でも接続先ができません。Namespace はテンプレートへ固定せず、インストール時に指定します。
cat > test-web/templates/service.yaml <<'EOF'
apiVersion: v1
kind: Service
metadata:
name: {{ .Release.Name }}
spec:
type: ClusterIP
selector:
app.kubernetes.io/instance: {{ .Release.Name }}
ports:
- name: http
port: {{ .Values.service.port }}
targetPort: http
EOF構文と生成される Manifest を確認する
helm lint ./test-web
helm template test-web ./test-web --namespace helm-testhelm lint で Chart の基本的な問題を確認し、helm template で値を展開した Manifest を確認します。出力されるリソースは Deployment と Service の 2 件です。どちらも名前が test-web となり、Deployment のレプリカ数が 1、コンテナイメージが nginx:1.28-alpine になっていることを確認します。
この段階ではクラスタへリソースを作成しません。ただし、テンプレート生成に成功しても、クラスタの admission policy、イメージ取得、スケジューリング、ネットワークの正常性までは保証されません。
インストールと起動確認
helm install test-web ./test-web \
--namespace helm-test \
--create-namespace \
--wait --timeout 120s
helm status test-web --namespace helm-test
kubectl -n helm-test get deployment,pod,service
kubectl -n helm-test rollout status deployment/test-web --timeout=120s--wait を付け、対象リソースが準備できるまで待ちます。Deployment は 1/1、Pod は Ready、Service は ClusterIP となる想定です。タイムアウトした場合は、Pod の状態とイベントを確認します。イメージ取得失敗、配置先の不足、readinessProbe の失敗などは原因が異なります。
kubectl -n helm-test get pods
kubectl -n helm-test describe deployment test-web
kubectl -n helm-test get events --sort-by=.metadata.creationTimestamp
kubectl -n helm-test logs deployment/test-webport-forward で HTTP 応答を確認する
kubectl -n helm-test port-forward service/test-web 8080:80このコマンドを動かしたまま、別のターミナルからアクセスします。操作端末の 8080 番ポートを使うため、同じポートが使用中であれば左側の番号を変更します。
curl -i http://127.0.0.1:8080/HTTP 200 と Nginx の初期ページが返れば、API サーバー経由で選択された Pod の HTTP 応答を確認できています。port-forward service/... は Service に対応する Pod へ転送する仕組みであり、ClusterIP のデータパスを通る通信試験ではありません。
必要に応じて ClusterIP 経由でも確認する
Service の名前解決とクラスタ内の通信経路も確認する場合は、一時的な確認用 Pod から接続します。次の例では同じ Nginx イメージに含まれる wget を利用します。この確認には Pod 間通信とクラスタ DNS が利用できる必要があります。
kubectl -n helm-test run http-check \
--image=nginx:1.28-alpine \
--restart=Never --rm -i \
--command -- wget -qO- http://test-web/こちらで初期ページが返れば、Service 名の名前解決と ClusterIP を介した HTTP 接続が確認できます。確認用 Pod はコマンド終了後に削除されます。途中で中断した場合は、kubectl -n helm-test get pod http-check で残存を確認します。
values を変更してアップグレードする
レプリカ数だけを変え、同じ Release を更新します。2 Pod を配置できるだけのクラスタ容量が必要です。Deployment と Service の識別ラベルは変えないため、Service は増えた Pod も対象にします。
helm upgrade test-web ./test-web \
--namespace helm-test \
--set replicaCount=2 \
--wait --timeout 120s
kubectl -n helm-test get deployment,pod,service
helm get values test-web --namespace helm-testDeployment が 2/2 となり、values に replicaCount: 2 が記録されていることを確認します。継続的に使う設定はコマンドラインだけに残さず、values-test.yaml などのファイルへ保存し、-f で渡すと差分を管理できます。
アンインストールと後片付け
port-forward のターミナルで Ctrl+C を押して転送を止め、Release を削除します。Helm が作成した Deployment と Service が削除されたことを確認します。
helm uninstall test-web --namespace helm-test
kubectl -n helm-test get deployment,pod,service
helm list --namespace helm-test--create-namespace で作成した Namespace はアンインストール後も残ります。他の用途で使っていない専用のテスト Namespace であることを確認したうえで、不要なら削除します。
kubectl delete namespace helm-testこの Chart で確認できること
この構成では、values をテンプレートへ渡し、複数の Kubernetes リソースを一つの Release として導入・更新・削除する流れを確認できます。Release 名を変えれば別のリソース名と selector で導入できるため、同じ Namespace 内での並行テストにも使えます。
テストの見通しを優先し、永続化、resource requests / limits、認証、TLS、NetworkPolicy などは定義していません。本番用途や制約のある Namespace へ持ち込む場合は、その環境の資源制約とセキュリティー条件に合わせて追加します。まず小さな Chart で Helm の動作を確認し、試験したい条件だけを足していく使い方を想定しています。
Kubernetes完全ガイド 第2版
Kubernetes の仕組み、リソース、ネットワーク、運用観点を体系的に確認したい場合の参考書籍です。価格や在庫はリンク先で確認してください。
Amazon で見るこのリンクは Amazon アソシエイトリンクです。
