はじめに
Helmは、ヘルムチャート(事前構成されたKubernetesアプリケーションリソースのコレクション)をデプロイするためのKubernetesパッケージマネージャーです。 Kubernetesクラスター内のアプリをより簡単に管理するために必要なすべてのコマンドを備えています。
このチュートリアルでは、すべての重要なHelm操作について説明し、その構文と機能を理解するのに役立つ例を示します。
前提条件
- Kubernetesクラスター(minikubeで作成できます)
- ヘルムパッケージマネージャーがインストールされています
ヘルムの基本概念
Helmコマンドは、いくつかのHelm関連の概念で機能します。それらを理解すると、構文を理解しやすくなります。
- 最も重要なヘルムの概念はチャートです 。グラフは、Kubernetes
yaml
のセットです。 マニフェストは、簡単に操作できるように一緒にパッケージ化されています。ヘルムチャートを使用すると、単一のコマンドを使用してコンテナ化されたアプリケーションをデプロイできます。 - グラフは、リポジトリと呼ばれるオンラインコレクションにグループ化されています 。各リポジトリには名前とURLがあり、チャートの検索、ダウンロード、インストールが簡単にできます。
- ヘルムハブ は、インターネット上で利用可能な分散リポジトリのオンラインコレクションです。アプリとそのリポジトリアドレスを見つけることができる情報センターとして機能します。現在、HelmHubから直接アプリをインストールすることはできません。
- リリース は、Kubernetesクラスタにデプロイされたチャートの単一インスタンスです。
ヘルムコマンドのリスト
Kubernetes内でHelmを操作する際のクイックリファレンスとして、以下にリストされているコマンドを使用してください。
アプリのインストールとアンインストール
Helmの主な機能は、Kubernetesアプリの管理です。アプリのインストールとアンインストールの基本的な操作に加えて、Helmを使用すると、テストインストールを実行し、インストールプロセスをカスタマイズできます。
アプリをインストールする:
helm install [app-name] [chart]
特定の名前空間にアプリをインストールします:
helm install [app-name] [chart] --namespace [namespace]
デフォルト値を、選択したファイルで指定された値で上書きします:
helm install [app-name] [chart] --values [yaml-file/url]
テストインストールを実行して、チャートを検証および検証します。
helm install [app-name] --dry-run --debug
リリースをアンインストールします:
helm uninstall [release]
アプリのアップグレードとロールバックを実行する
Helmは、自動ロールバックや特定のバージョンへのアップグレードなど、アプリのアップグレードのための複数のオプションをユーザーに提供します。ロールバックは、単独で実行することもできます。ロールバックを実行する方法の詳細については、Helmを使用して変更をロールバックする方法を確認してください。
アプリをアップグレードする:
helm upgrade [release] [chart]
アップグレードが失敗した場合に変更をロールバックするようにHelmに指示します。
helm upgrade [release] [chart] --atomic
リリースをアップグレードします。システムに存在しない場合は、インストールしてください:
helm upgrade [release] [chart] --install
指定されたバージョンにアップグレードします:
helm upgrade [release] [chart] --version [version-number]
リリースをロールバックする:
helm rollback [release] [revision]
リリース情報のダウンロード
helm get
コマンドを使用すると、リリースに関する情報をダウンロードできます。
すべてのリリース情報をダウンロードします:
helm get all [release]
すべてのフックをダウンロードする:
helm get hooks [release]
マニフェストをダウンロードする:
helm get manifest [release]
メモをダウンロードする:
helm get notes [release]
値ファイルをダウンロードします:
helm get values [release]
リリース履歴の取得:
helm history [release]
リポジトリの追加、削除、更新
コマンドhelmリポジトリは、チャートリポジトリの操作に役立ちます。
インターネットからリポジトリを追加します:
helm repo add [repository-name] [url]
システムからリポジトリを削除します:
helm repo remove [repository-name]
リポジトリの更新:
helm repo update
リポジトリの一覧表示と検索
helm repo
を使用する およびhelm search
Helmリポジトリを一覧表示および検索するコマンド。 helm search
また、HelmHubでアプリやリポジトリを見つけることもできます。
チャートリポジトリのリスト:
helm repo list
現在のディレクトリにあるチャートを含むインデックスファイルを生成します:
helm repo index
キーワードのチャートを検索する:
helm search [keyword]
キーワードのリポジトリを検索します:
helm search repo [keyword]
ヘルムハブの検索:
helm search hub [keyword]
リリースモニタリング
helm list
コマンドを使用すると、通常の(Pearl互換)式を使用して結果をフィルタリングするなど、いくつかの基準に従ってKubernetesクラスター内のリリースを一覧表示できます。 helm status
などのコマンド およびhelm history
リリースに関する詳細を提供します。
現在の名前空間で利用可能なすべてのリリースを一覧表示します:
helm list
すべての名前空間で利用可能なすべてのリリースを一覧表示します:
helm list --all-namespaces
特定の名前空間内のすべてのリリースを一覧表示します:
helm list --namespace [namespace]
すべてのリリースを特定の出力形式で一覧表示します:
helm list --output [format]
正規表現を使用してリリースのリストにフィルターを適用します:
helm list --filter '[expression]'
特定のリリースのステータスを確認します:
helm status [release]
リリース履歴を表示する:
helm history [release]
Helmクライアント環境に関する情報を参照してください:
helm env
プラグイン管理
helm plugin
を使用して、Helmプラグインをインストール、管理、および削除します。 コマンド。
プラグインをインストールする:
helm plugin install [path/url1] [path/url2] ...
インストールされているすべてのプラグインのリストを表示します:
helm plugin list
プラグインの更新:
helm plugin update [plugin1] [plugin2] ...
プラグインをアンインストールします:
helm plugin uninstall [plugin]
チャート管理
ヘルムチャートは、Kubernetesリソースを使用してアプリケーションを定義します。それらの構造と作成の要件の詳細については、ヘルムチャートを作成する方法を参照してください。
共通のチャートファイルとディレクトリを含むディレクトリを作成します( c hart.yaml
、 values.yaml
、charts/
およびtemplates/
):
helm create [name]
チャートをチャートアーカイブにパッケージ化します:
helm package [chart-path]
テストを実行してグラフを調べ、考えられる問題を特定します。
helm lint [chart]
チャートを調べて、その内容をリストします:
helm show all [chart]
グラフの定義を表示します:
helm show chart [chart]
グラフの値を表示します:
helm show values [chart]
グラフをダウンロードする:
helm pull [chart]
グラフをダウンロードして、アーカイブの内容をディレクトリに抽出します:
helm pull [chart] --untar --untardir [directory]
グラフの依存関係のリストを表示します:
helm dependency list [chart]
ヘルプとバージョン情報を入手
Helmの一般的なヘルプ出力を表示します:
helm --help
特定のヘルムコマンドのヘルプを表示する:
helm [command] --help
インストールされているHelmのバージョンを確認してください:
helm version
ヘルムチートシートPDF
以下に、上記のすべてのHelmコマンドを含む1ページのリファレンスシートを示します。ヘルムチートシートのPDFをダウンロードして、後で参照できるように保存してください。
チートシートをダウンロード