Kubecost Helmチャート:2.xと3.xの違い、インストール手順、6つのベストプラクティス

Kubecost Helmチャートとは?

Kubecostは、cost-analyzerリポジトリで公開されている公式Helmチャートを使ってインストールできます。このチャートは、HelmでKubernetesクラスタにKubecostをデプロイするためのパッケージです。デプロイメント、サービス、設定、関連コンポーネントなど、Kubecostに必要なKubernetesリソースを定義します。Helmはこれらのリソースを1つのリリースとして扱うため、Kubecostのインストール、アップグレード、設定、削除が容易になります。

チャートに含まれるもの:

Kubecost Helmチャートには、Kubecostの実行に必要なKubernetesリソースと設定可能な依存関係がパッケージされています。設定値に応じて、Kubecostアプリケーションコンポーネント、Prometheus連携、Kubernetesメトリクスコンポーネント、永続ストレージ、ServiceとIngress、監視リソース、ネットワークコスト収集、ネットワークポリシー、クラウドプロバイダーの料金連携などを含めることができます。

設定のベストプラクティス:

• Kubecost Helmチャートのバージョンを固定する: チャートのバージョンを明示的に指定して、デプロイを予測可能に保ち、新しいリリースによる予期せぬ変更を防ぎます。
• Helmの設定値をバージョン管理する: 設定の上書き内容はバージョン管理されたvalues.yamlファイルに保存し、認証情報などのシークレットはリポジトリの外に置きます。
• 環境ごとに別々のvaluesファイルを使う: チャートのマニフェストを複製・改変するのではなく、開発・ステージング・本番それぞれの環境別設定を管理します。
• 適切なリソースのrequestsとlimitsを設定する: クラスタの規模に応じてKubecostコンポーネントのCPUとメモリを設定し、実際に観測されたリソース消費量をもとに調整します。
• 本番環境では永続ストレージを設定する: データ保持、増加量、バックアップ、リカバリの要件に基づき、適切な永続ボリューム容量と信頼性の高いStorageClassを選択します。
• Helmアップグレードを本番前にテストする: 新しいチャートバージョンと既存のカスタム設定値を非本番環境で検証し、テスト済みのロールバック手順を用意しておきます。

この記事の内容:

• 2つのKubecost Helmチャート:cost-analyzerとkubecost
• Helmチャートに含まれるもの
• HelmでKubecostをインストールする方法
• Kubecost HelmチャートとKubernetesマニフェストの比較
• Kubecost Helmチャートのベストプラクティス

2つのKubecost Helmチャート:cost-analyzerとkubecost

現在、Kubecostには管理者が目にする可能性のある2系統のHelmチャートがあります。Kubecost 2.xのデプロイで使われてきた旧来のcost-analyzerチャートと、Kubecost 3.x向けに導入された新しいkubecostチャートです。現行のKubecostリポジトリでは、バージョン2.8が2.x系最後の機能リリース、バージョン2.9が中間アップグレードステップ、バージョン3.0がKubecost 3.xの最初のリリースと位置づけられています。

cost-analyzerチャートは、Kubecost 2.x全体で使われてきたレガシーのデプロイ方法です。既存環境では引き続きkubecost/cost-analyzerなどのコマンドが参照されている場合があり、Kubecostも旧デプロイやアップグレードシナリオのために、このチャートに関連するリポジトリを維持しています。

Kubecost 3.xでは、主要チャートの名前はkubecostになりました。新規インストールでは、KubecostのHelmリポジトリからkubecost/kubecostチャートを使用します。Kubecost 3.xでは、ClickHouseベースのストレージや、2.xで使われていた従来のcost-modelエージェントに代わる新しいfinops-agentなど、アーキテクチャの大きな変更も導入されています。

そのため、既存のKubecost 2.xデプロイをアップグレードする場合は、単なるチャート名の変更以上のものとして扱う必要があります。Kubecostは、3.xへ移行する前にエージェントをバージョン2.9にアップグレードし、この中間バージョンをしばらく稼働させてから移行を完了することを推奨しています。コンポーネント名、ストレージアーキテクチャ、設定オプションが変更されているため、既存のcost-analyzerの設定値が新しいkubecostチャートにそのまま対応すると想定せず、必ず見直してください。

Helmチャートに含まれるもの

Kubecost Helmチャートには、Kubecostの実行に必要なKubernetesテンプレートと設定可能な依存関係が含まれています。実際にデプロイされるリソースはチャートのバージョンと有効化した設定値によって異なりますが、一般的に以下のコンポーネントをカバーしています。

• Kubecostアプリケーションコンポーネント: Kubecostを実行し、コスト監視機能を提供するために必要なDeployment、Service、ConfigMap、Secret、サービスアカウントなどのリソース。
• メトリクス収集(finops-agent): チャートはfinops-agentをデプロイします。これはKubecostがコスト配分に使用するクラスタメトリクスを収集する軽量エージェントで、別途Prometheusをデプロイする必要はありません。
• Kubernetesメトリクスコンポーネント: 設定に応じて、Kubernetesオブジェクトやノードレベルのメトリクスを提供するkube-state-metricsやNode Exporterなどの補助コンポーネントをデプロイできます。
• 永続ストレージ: Helmの設定値でKubecostとPrometheusのデータ用の永続ボリュームクレームを作成でき、ストレージサイズとストレージクラスを設定できます。
• IngressとServiceの設定: チャートには、Kubernetes Serviceを通じてKubecostを公開するための設定が用意されており、有効化すればホスト、パス、アノテーション、TLS設定を構成できるIngressも利用できます。
• 監視リソース: Prometheus Operatorを使用する環境向けに、ServiceMonitorやPrometheusRuleなどのオプションリソースを作成できます。
• オプション機能と連携: 生成されたKubernetesマニフェストを手動で変更することなく、Helmの設定値でネットワークコスト収集、ネットワークポリシー、クラウドプロバイダーの料金連携などの追加機能を有効化できます。

これらのコンポーネントはチャートのvalues.yamlで制御されるため、必要なリソースだけを有効化したり、クラスタに既に存在する監視・インフラコンポーネントとKubecostを統合したりできます。

関連コンテンツ:Kubernetesコスト最適化のガイドもぜひご覧ください

HelmでKubecostをインストールする方法

Kubecostは、公式のKubecostチャートリポジトリを追加し、専用のnamespaceにチャートをデプロイすることで、Helmでインストールできます。現行のKubecost Helmチャートリポジトリは、Kubecost 3.x向けにkubecost/kubecostチャートを提供しています。

まず、KubecostのHelmリポジトリを追加し、ローカルのチャートインデックスを更新します。

helm repo add kubecost https://kubecost.github.io/kubecost/
helm repo update

次に、kubecost namespaceにKubecostをインストールします。

helm install kubecost kubecost/kubecost \
  --namespace kubecost \
  --create-namespace

Kubecostは、リポジトリのURLから直接インストールすることもできます。公式の例では、クラスタを識別するためにglobal.clusterIdを設定しています。

helm install kubecost \
  --repo https://kubecost.github.io/kubecost kubecost \
  --namespace kubecost \
  --create-namespace \
  --set global.clusterId=my-cluster

本番環境にデプロイする前に、特定のチャートバージョンでサポートされている設定値を確認できます。

helm show values kubecost/kubecost --version <chart-version>

必要な設定をカスタムのvalues.yamlファイルにまとめ、次のコマンドでKubecostをインストールします。

helm install kubecost kubecost/kubecost \
  --namespace kubecost \
  --create-namespace \
  --values values.yaml

valuesファイルを使えば、ストレージ、リソース割り当て、監視、Kubecostコンポーネントなどの設定をバージョン管理し、再現しやすくなります。Kubecostの公式リポジトリでは、リリースを選ぶ際にチャートとKubernetesのバージョン互換性を確認することも推奨しています。たとえば、Kubecost 3.0のチャートは、Kubecost 2.x系の最終リリースよりも新しいKubernetesバージョンを対象としています。