Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】Helm Chart Values for Staging vs Production Done Right

2026年10月15日に「Dev.to」が公開したITニュース「Helm Chart Values for Staging vs Production Done Right」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

HelmでのStagingとProduction間の設定ずれは、Valuesの結合ルール誤解が原因。`values.yaml`をデフォルトとし、環境固有設定は差分のみを記述。テンプレート内で環境分岐させず、正しいValues管理でデプロイを安定させよう。

ITニュース解説

システム開発では、Staging(検証環境)とProduction(本番環境)といった複数の環境でアプリケーションを動かすことが一般的である。これらの環境では、アプリケーションの設定が少しずつ異なる場合が多い。例えば、Stagingでは少数のサーバーでテストを行うためリソースを抑え、デバッグログを多く出力するが、Productionでは安定稼働のために多くのリソースを割り当て、通常のログレベルに設定する、といった具合である。このような環境ごとの設定の違いを、Kubernetes上でアプリケーションを管理するためのツールであるHelmでどのように扱うか、その正しい方法について説明する。

まず、Helmにおける「Values(バリュー)」とは、Helm Chartというアプリケーションの設計図に対して与える設定値のことである。Helm ChartはGoテンプレートという仕組みを使って、これらのValuesを元にKubernetesのマニフェスト(設定ファイル)を生成する。このValuesが正しく管理されていないと、Stagingでは問題なく動作したのにProductionでは予期せぬ挙動をする、といった「環境差異」の問題が発生しがちである。

HelmがValuesをどのように処理するかを理解することが重要だ。Helmは複数のValuesのソースから設定値を集め、一つにまとめてからテンプレートに適用する。設定値の優先順位は決まっており、チャート自体が持つvalues.yamlが最も優先度が低く、親チャートからの値、コマンドラインで-fオプションを使って指定するファイル、そして最後に--setオプションで直接指定する値が最も優先度が高い。ここで特に注意すべきは、マップ形式の設定値(例: resources: { cpu: 100m })はキーごとにマージされるのに対し、リスト形式の設定値(例: tolerations: [...])は完全に置き換えられてしまう点である。このため、リストをオーバーライドすると、意図せずデフォルトの設定がすべて消えてしまうことがある。helm get valuesコマンドを使うと、自分が設定したValuesを確認でき、helm get values --allとすると、マージされて最終的に適用されるValues全体を見ることができるので、環境差異に直面したらまずこれらのコマンドで確認することが推奨される。

しかし、多くの人がValuesを誤った方法で使ってしまい、問題を引き起こしている。最もよく見られる間違いの一つは、values.yamlファイルを環境ごとにコピーしてvalues-staging.yamlやvalues-production.yamlを作成することである。最初は同じ内容でも、リリースを重ねるうちに特定の環境の設定だけが更新され、他の環境の設定と乖離していく。これはもはや「オーバーライド」(上書き)ではなく、それぞれが異なる独立した設定ファイルとなり、管理が非常に困難になる。

二つ目の間違いは、Helmテンプレートの内部で{{ if eq .Values.env "production" }}のように環境名を直接判定するロジックを埋め込むことである。これは一見便利そうに見えるが、チャート自体が特定の環境の知識を持つことになり、Staging環境がProduction環境と同じコードパスを実行できなくなる。また、新しい環境を追加するたびにテンプレートを変更する必要が生じ、柔軟性が失われる。

三つ目は、CI/CDパイプライン上で多数の--setフラグを使って設定値を渡す方法である。これは、設定がバージョン管理システムの外に存在するため、コードレビューの対象にならず、誰がいつどのような変更を加えたのかが追跡しにくくなる。さらに、--setフラグでは型変換の罠がある。例えば--set image.tag=20240101とすると、数字として解釈され、文字列として扱いたい場合に問題が生じることがある。このような場合は--set-stringを使う必要がある。YAMLファイルでも、クォートされていないバージョン番号(例: version: 1.10)が浮動小数点数として解釈されることがあるため、文字列として扱いたい場合は必ずクォートで囲むべきである。

これらの問題を避けるための正しいアプローチは、values.yamlを「安全な、本番環境向けのデフォルト設定」として位置づけ、各環境ファイルには、そのデフォルトからの「小さな差分」のみを記述することである。Staging環境は、規模や接続先のエンドポイントはProductionと異なるかもしれないが、設定の構造自体は同じであるべきだ。これにより、テンプレートはすべての環境で共通のものを使い続けることができる。

具体的なファイルの例を見てみよう。values.yamlには、レプリカ数、イメージのリポジトリ、リソースの要求・制限、Ingressのホスト名、ログレベルといった基本的な設定をProduction環境に合わせたデフォルト値として定義する。一方、values-staging.yamlには、Staging環境でProduction環境から変更したい部分だけを記述する。例えば、replicaCount: 1、resourcesの要求値を小さく、IngressのhostをStaging向けのアドレスに、logLevelをdebugにする、といった具合だ。デプロイ時には、まずhelm templateコマンドでテンプレートが正しくレンダリングされるか、スキーマエラーがないかを事前に検証する。その後、helm upgrade --installコマンドで、values.yamlが自動的に適用され、その上に-f values-staging.yamlで指定したStaging固有の差分設定が上書きされるようにデプロイを行う。また、--set-string image.tag="$IMAGE_TAG"のように、イメージタグなどの変動する値は、パイプラインから適切に渡す。--atomic --wait(またはHelm 4以降では--rollback-on-failure)オプションを使用することで、デプロイが失敗した場合に自動的に以前の状態にロールバックさせることができる。さらに、チャートにvalues.schema.jsonファイルを追加することで、Valuesがスキーマに準拠しているかをインストールやアップグレード前に検証できるようになり、誤った型やスペルミスによるエラーを早期に発見できる。

より高度な使い方としては、環境ファイルをさらに細かく「次元ごと」に分割する方法がある。例えば、values-common.yaml、values-prod.yaml、values-eu-west.yamlのように、共通設定、本番固有設定、地域固有設定といった関心事ごとにファイルを分け、これらを特定の順序で適用することで、設定の重複を減らし、複数クラスターやリージョンへの拡張が容易になる。また、リスト形式の設定は完全に置き換えられるため、もし自分でチャートをコントロールできるのであれば、リストをマップ形式に変換することを検討すると良い。これにより、個々のキーだけをオーバーライドすることが可能になる。シークレット情報については、平文のValuesファイルに含めるべきではない。KubernetesのSecretリソースを参照したり、外部のシークレット管理ツール(SOPSなど)と連携したりする方法が安全である。

最新の開発手法であるGitOpsツール(Argo CDやFluxなど)を使用すると、Valuesファイルを含むすべての設定をGitリポジトリで管理し、コードとしてレビュー・承認できるようになる。これにより、設定変更の透明性と信頼性が向上する。デプロイ前には、helm diff upgradeといったプラグインを使って、実際に適用されるKubernetesマニフェストがどのように変わるのかを確認することが非常に有効である。これにより、Valuesの一行変更が、実はKubernetesリソースの大きな変更につながることを事前に把握できる。

最後に、運用面での注意点もいくつかある。Helmのテンプレートレンダリング自体は通常高速でボトルネックになることは少ないが、リリースサイズは考慮すべきである。Helmは各リリース履歴をKubernetesのSecretとして保存するが、Secret一つあたりのサイズには1MiBの制限がある。Valuesやテンプレートに大きなファイルを埋め込むとこの制限に達する可能性があるため、--history-maxオプションで履歴数を制限することも検討する。デプロイ時の--waitオプションは、リソースが準備完了になるまで待機するため、--timeoutの値はアプリケーションの起動時間やイメージのダウンロード時間を考慮して適切に設定する必要がある。また、Staging環境でリソース要求を極端に低く設定すると、本番環境で実際に発生するCPUスロットリングなどの問題を見逃す可能性がある。同様に、Staging環境でアプリケーションのレプリカ(インスタンス)が一つだけだと、ローリングアップデート時の挙動や、PodDisruptionBudget(Kubernetesでアプリケーションの可用性を高める設定)に関する問題を発見できないことがあるため、本番環境で重要な機能であればStagingでも複数のレプリカを動かしてみるべきだ。

要するに、環境間の設定差異は最小限に抑え、その差異は明示的かつレビュー可能な形で管理することが、安定したシステム運用への鍵となる。これにより、システムエンジニアはStaging環境で十分にテストされた設定を安心してProduction環境にデプロイできるようになるだろう。

関連コンテンツ

関連IT用語