手当たり次第に書くんだ

飽きっぽいのは本能

テスト用の最小 Helm Chart を作る – Nginx と ClusterIP Service で導入から削除まで確認する

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.yamlChart 自体の名前、種類、バージョンを定義します。
values.yamlレプリカ数、イメージ、Service のポートの初期値を定義します。
templates/deployment.yamlNginx の Pod を管理する Deployment を定義します。
templates/service.yamlPod を選択する ClusterIP Service を定義します。

helm create の雛形は便利ですが、ここでは内容を把握しやすいように必要なファイルを直接作ります。作業ディレクトリ内に同名のファイルがない場所で、次のコマンドを実行します。

mkdir -p test-web/templates

Chart.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"
EOF

values.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
EOF

templates/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
EOF

templates/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-test

helm 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-web

port-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-test

Deployment が 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 の動作を確認し、試験したい条件だけを足していく使い方を想定しています。

BOOK
参考書籍

Kubernetes完全ガイド 第2版

Kubernetes の仕組み、リソース、ネットワーク、運用観点を体系的に確認したい場合の参考書籍です。価格や在庫はリンク先で確認してください。

Amazon で見る

このリンクは Amazon アソシエイトリンクです。

参考資料

Helm Charts

helm install

Kubernetes: Port Forwarding

関連記事
テスト用の最小 Helm Chart を作る – Nginx と ClusterIP Service で導入から削除まで確認する

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

日本語が含まれない投稿は無視されますのでご注意ください。(スパム対策)

Scroll to top