VPC環境で利用できます。
Add-onのインストールと管理
Add-onをインストールして、設定とバージョンを変更し、削除する方法を説明します。
クラスタ作成時に一緒にインストール
クラスタを作成する時、 [Add-on] タブメニューでインストールする Add-onを一緒に指定します。指定した Add-onは、クラスタが作成される間にインストールされます。クラスタ作成の全手順は、Ncloud Kubernetes Service を開始するをご参照ください。
指定する項目は次の通りです。
- Add-on選択: 複数の Add-onを一度に指定して一緒にインストールします。
- バージョン選択: Add-on別にインストールするバージョンを指定します。
- 設定値の入力: Add-on別に定義された設定値を入力します。入力しないとデフォルト値でインストールされます。
運用中 Add-onのインストール
運用中のクラスタにインストールされていない Add-onを追加します。既にインストールされた Add-onはインストール対象から除外されます。
運用中のクラスタに Add-onをインストールする方法は、次の通りです。
- クラスタ詳細の [Add-on] タブメニューをクリックします。
- [Add-onのインポート] ボタンをクリックします。
- インストールする Add-onをクリックして選択します。
- インストールするバージョンをクリックして選択します。
- 設定値を入力します。設定値を入力しないとデフォルト値でインストールされます。
- 競合管理方式をクリックして選択します。詳細は競合管理をご参照ください。
- [確認] ボタンをクリックします。インストールが開始されます。
競合管理
Add-onはデフォルト設定値にユーザーが入力した設定値を反映して最終構成を作成し、これをクラスタに適用します。入力しなかった項目はデフォルト設定値を使用します。設定値を入力して構成を変えることは競合ではなく、競合は
ユーザーがクラスタで直接(例: kubectl edit)変更したフィールドにのみ発生します。直接変更したフィールドがない場合、どの方式を選択しても結果は同じです。
| 方式 | 説明 |
|---|---|
| 上書き(デフォルト) | ユーザーが直接変更したフィールドがあっても、最終構成値に上書きされます。競合でタスクが失敗しません。 |
| 保存 | ユーザーが直接変更したフィールドはそのままにし、その他を最終構成値に更新します。直接変更した値がこの値と競合する場合、タスクが失敗することがあります。 |
設定変更とバージョンアップグレード
インストールされた Add-onのバージョンと設定値を変更します。編集画面は現在の設定値が入力されたステータスで表示されます。
インストールされた Add-onを編集する方法は、次の通りです。
- クラスタ詳細の [Add-on] タブメニューをクリックします。
- 編集する Add-onで [編集] ボタンをクリックします。
- 必要な場合、バージョンを変更します。バージョンはクラスタと互換性のある範囲内でクリックして選択できます。
- 必要な場合、設定値を変更します。
- 競合管理方式をクリックして選択します。判定基準と動作は競合管理と同じです。
- [確認] ボタンをクリックします。変更が適用されます。
変更事項が拒否されたり検証に失敗する場合、直前の正常ステータス(バージョンと設定値)に自動復元を試行します。ただし、適用は完了しても、以後のランタイムが正常でない場合(例: コンテナの再起動繰り返し)は、自動復元対象ではありません。
Add-onのアンインストール
インストールされた Add-onをクラスタから削除します。
インストールされた Add-onをアンインストールする方法は、次の通りです。
- クラスタ詳細の [Add-on] タブメニューをクリックします。
- アンインストールする Add-onで [アンインストール] ボタンをクリックします。
- 確認画面の内容を確認した後、アンインストールを行います。アンインストールを開始します。
アンインストールすると、Add-onを通じてインストールされたリソースが削除されます。アンインストール前に Add-onリソースに依存するワークロードがクラスタに残ってないか確認します。ただし、ユーザーデータが残っているリソース(例: 使用中のボリュームスナップショット)は保護のために保存されることがあります。また、保存されたリソースは必要な場合に直接クリーンアップします。
タスク失敗時に確認
タスクに失敗したら Add-onのステータスが失敗と表示され、タスク結果メッセージに原因が表示されます。メッセージを確認して設定値、バージョン、競合管理方式を調整してから、再試行してください。