メインコンテンツまでスキップ

Helm

HelmはKubernetesのためのパッケージ管理ツールです。HelmチャートはKubernetes YAMLマニフェストドキュメントのためのテンプレート構文を提供します。Helmを使用すると、開発者やクラスター管理者は静的なマニフェストを使用する代わりに、チャートとして知られる設定可能なテンプレートを作成できます。独自のチャートカタログを作成する方法については、https://helm.sh/docs/intro/quickstart/のドキュメントを参照してください。

K3sはHelmをサポートするために特別な設定を必要としません。クラスターアクセスのドキュメントに従って、kubeconfigパスを正しく設定していることを確認してください。

K3sには、HelmChartカスタムリソース定義（CRD）を使用してHelmチャートのインストール、アップグレード/再構成、およびアンインストールを管理するHelmコントローラーが含まれています。自動デプロイAddOnマニフェストと組み合わせることで、ディスク上に1つのファイルを作成するだけでクラスターにHelmチャートを自動的にインストールできます。

Helmコントローラーの使用​

HelmChartカスタムリソースは、通常helmコマンドラインツールに渡すほとんどのオプションをキャプチャします。以下は、BitnamiチャートリポジトリからApacheをデプロイし、いくつかのデフォルトチャート値を上書きする例です。HelmChartリソース自体はkube-systemネームスペースにありますが、チャートのリソースは同じマニフェストで作成されるwebネームスペースにデプロイされます。これは、HelmChartリソースをデプロイするリソースから分離して保持したい場合に便利です。

apiVersion: v1
kind: Namespace
metadata:
  name: web
---
apiVersion: helm.cattle.io/v1
kind: HelmChart
metadata:
  name: apache
  namespace: kube-system
spec:
  repo: https://charts.bitnami.com/bitnami
  chart: apache
  targetNamespace: web
  valuesContent: |-
    service:
      type: ClusterIP
    ingress:
      enabled: true
      hostname: www.example.com
    metrics:
      enabled: true

認証付きのプライベートリポジトリからHelmチャートをデプロイする例：

apiVersion: helm.cattle.io/v1
kind: HelmChart
metadata:
  namespace: kube-system
  name: example-app
spec:
  targetNamespace: example-space
  createNamespace: true
  version: v1.2.3
  chart: example-app
  repo: https://secure-repo.example.com
  authSecret:
    name: example-repo-auth
  repoCAConfigMap:
    name: example-repo-ca
  valuesContent: |-
    image:
      tag: v1.2.2
---
apiVersion: v1
kind: Secret
metadata:
  namespace: kube-system
  name: example-repo-auth
type: kubernetes.io/basic-auth
stringData:
  username: user
  password: pass
---
apiVersion: v1
kind: ConfigMap
metadata:
  namespace: kube-system
  name: example-repo-ca
data:
  ca.crt: |-
    -----BEGIN CERTIFICATE-----
    <YOUR CERTIFICATE>
    -----END CERTIFICATE-----

HelmChartフィールド定義​

フィールドデフォルト説明Helm引数/フラグの同等
metadata.nameHelmチャート名NAME
spec.chartリポジトリ内のHelmチャート名、またはチャートアーカイブ（.tgz）への完全なHTTPS URLCHART
spec.targetNamespacedefaultHelmチャートのターゲットネームスペース--namespace
spec.createNamespacefalseターゲットネームスペースが存在しない場合に作成--create-namespace
spec.versionリポジトリからインストールする場合のHelmチャートバージョン--version
spec.repoHelmチャートリポジトリURL--repo
spec.repoCAHTTPS対応サーバーの証明書をこのCAバンドルを使用して検証します。1つ以上のPEMエンコードされたCA証明書を含む文字列である必要があります。--ca-file
spec.repoCAConfigMapHelmが信頼するCA証明書を含むConfigMapへの参照。repoCAと一緒に、または代わりに使用できます。--ca-file
spec.helmVersionv3使用するHelmバージョン（v2またはv3）
spec.bootstrapFalseこのチャートがクラスターをブートストラップするために必要な場合（クラウドコントローラーマネージャーなど）にTrueに設定
spec.setシンプルなデフォルトチャート値を上書きします。これらはvaluesContent経由で設定されたオプションよりも優先されます。--set / --set-string
spec.jobImageHelmチャートをインストールする際に使用するイメージを指定します。例：rancher/klipper-helm:v0.3.0。
spec.backOffLimit1000ジョブが失敗と見なされる前に再試行する回数を指定します。
spec.timeout300sHelm操作のタイムアウト、duration string（300s、10m、1hなど）として指定--timeout
spec.failurePolicyreinstallHelm操作が中止され、オペレーターによる手動介入が必要な場合にabortに設定
spec.authSecretチャートリポジトリの基本認証資格情報を保持するkubernetes.io/basic-authタイプのSecretへの参照。
spec.authPassCredentialsfalseすべてのドメインに基本認証資格情報を渡します。--pass-credentials
spec.dockerRegistrySecretチャートリポジトリとして機能するOCIベースのレジストリのDocker認証資格情報を保持するkubernetes.io/dockerconfigjsonタイプのSecretへの参照。
spec.valuesContentYAMLファイルの内容を介して複雑なデフォルトチャート値を上書き--values
spec.chartContentBase64エンコードされたチャートアーカイブ.tgz - spec.chartを上書きCHART

/var/lib/rancher/k3s/server/static/に配置されたコンテンツは、クラスター内からKubernetes APIServerを介して匿名でアクセスできます。このURLは、spec.chartフィールドで特別な変数%{KUBERNETES_API}%を使用してテンプレート化できます。例えば、パッケージ化されたTraefikコンポーネントは、https://%{KUBERNETES_API}%/static/charts/traefik-12.0.000.tgzからチャートをロードします。

注記

nameフィールドはHelmチャートの命名規則に従う必要があります。詳細については、Helmベストプラクティスドキュメントを参照してください。

HelmChartConfigでパッケージ化されたコンポーネントをカスタマイズする​

HelmChartsとしてデプロイされるパッケージ化されたコンポーネント（例えばTraefik）の値を上書きするために、K3sはHelmChartConfigリソースを介してデプロイのカスタマイズをサポートします。HelmChartConfigリソースは対応するHelmChartの名前とネームスペースに一致する必要があり、追加のvaluesContentを提供することができ、これは追加の値ファイルとしてhelmコマンドに渡されます。

注記

HelmChartのspec.set値は、HelmChartおよびHelmChartConfigのspec.valuesContent設定を上書きします。

例えば、パッケージ化されたTraefikのインバウンド設定をカスタマイズするには、/var/lib/rancher/k3s/server/manifests/traefik-config.yamlという名前のファイルを作成し、以下の内容を入力します：

apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
  name: traefik
  namespace: kube-system
spec:
  valuesContent: |-
    image:
      name: traefik
      tag: 2.9.10
    ports:
      web:
        forwardedHeaders:
          trustedIPs:
            - 10.0.0.0/8

Helm v2からの移行​

K3sはHelm v2またはHelm v3のいずれかを処理できます。Helm v3に移行したい場合は、Helmのこのブログ投稿でプラグインを使用して成功裏に移行する方法を説明しています。詳細については、公式のHelm 3ドキュメントこちらを参照してください。クラスターアクセスのセクションに従ってkubeconfigを正しく設定していることを確認してください。

注記

Helm 3はもはやTillerとhelm initコマンドを必要としません。詳細については公式ドキュメントを参照してください。