マネージド・アドオンを使用したサービスの追加

マネージド IBM Cloud Kubernetes Service アドオンは、追加機能でクラスターを強化する簡単な方法です。 クラスターに追加するドライバー、プラグイン、またはオープン・ソース・ツールのバージョンは IBM によるテストを受け、IBM Cloud Kubernetes Service で使用することを承認されています。

クラスターにインストールできるマネージド・アドオンは、クラスターのタイプ、コンテナー・プラットフォーム、インフラストラクチャー・プロバイダーの選択によって異なります。

サポート

マネージド・アドオンは、IBM Cloud のサポート組織に完全に統合されています。 マネージド・アドオンの使用に関する質問や問題がある場合は、いずれかの IBM Cloud Kubernetes Service サポート・チャネルを使用できます。 詳しくは、ヘルプとサポートの取得を参照してください。

課金

クラスターに追加するツールについて費用が生じる場合は、これらの費用は自動的に統合されて、IBM Cloud Kubernetes Service に関する課金の一部としてリストされます。 課金サイクルは、クラスター内でそのアドオンを有効にしたタイミングに応じて IBM Cloud 側で決定されます。

一般に、ポートや IP アドレスを開くなど、追加のセットアップは必要ありません。 ただし、各管理対象アドオンの資料を参照して、管理対象アドオンのインストール前にクラスターが満たさなければならない前提条件を満たしてください。

マネージド・アドオンの追加

CLI からクラスターのマネージド・アドオンを有効にするには、ibmcloud ks cluster addon enable コマンドを使用します。 コンソールでクラスター内の管理対象アドオンを有効にするには、クラスターの詳細ページの「 アドオン 」ペインを使用します。 マネージドアドオンを有効にすると、 Kubernetes のリソースをすべて含む、サポート対象のツールバージョンがクラスターに自動的にインストールされます。

各アドオンの前提条件について詳しくは、以下を参照してください。

マネージド・アドオンの更新

各マネージド・アドオンのバージョンは、IBM Cloud によってテストされており、IBM Cloud Kubernetes Service で使用することが承認されています。 IBM Cloud Kubernetes Service でサポートされている最新バージョンにアドオンのコンポーネントを更新するには、以下のリンクをご利用ください。

各アドオンの具体的な更新手順については、以下のリンクを参照してください。

アドオンの状態と状況の確認

以下のコマンドを実行して、クラスター・アドオンの正常性の状態と状況を確認できます。

ibmcloud ks cluster addon ls -c CLUSTER_NAME_OR_ID

出力例

Name            Version   Health State   Health Status
debug-tool      2.0.0     normal         Addon Ready
istio           1.4       -              Enabling

**「Health State」**には、アドオンの各コンポーネントのライフサイクルが表されます。 次の表では、各状態について説明しています。

アドオンの正常性の状態
アドオンの正常性の状態 説明
critical

以下のいずれかの理由により、アドオンは使用可能な状態ではありません。

  • アドオンのコンポーネントの一部またはすべてが正常に動作していません。
  • アドオンのデプロイに失敗しました。
  • アドオンがサポート対象外のバージョンである可能性があります。
  • 詳細については、「 正常性ステータス 」フィールドを確認してください。
normal アドオンは正常にデプロイされています。 状況を参照して、アドオンがReadyになっているか、または更新が利用可能かどうか確認してください。
pending アドオンの一部またはすべてのコンポーネントが現在デプロイ中です。 状態がnormalになるまで、アドオンを操作しないでください。
updating アドオンは更新中で、使用できる状態ではありません。 **「Health Status」**フィールドで、アドオンの更新後のバージョンを確認してください。
warning クラスターの制限が原因で、アドオンが正常に機能しない可能性があります。 **「Health Status」**フィールドで詳細を確認してください。

**「Health Status」**には、進行中のアドオンの処理についての詳細が示されます。 各状況について、以下の表で説明します。

アドオンの正常性の状況
状況コード アドオンの正常性の状況 説明
H1500 Addon Ready アドオンは正常にデプロイされ、正常です。
H1501, H1502, H1503 Addon Not Ready

一部またはすべてのアドオン・コンポーネントが正常ではありません。 すべてのアドオン・コンポーネント・ポッドが実行されているかどうかを確認します。

  • たとえば、 Istio アドオンの場合、 kubectl get pods -n NAMESPACE コマンドを実行して、 istio-system および ibm-operators 名前空間のポッドが Running の状態になっているかどうかを確認します。
H1504, H1505, H1506, H1507, H1508 Failure determining health status. アドオンの正常性を判別できません。 サポートケースを開いて ください。 説明に、正常性の状況からのエラー・コードを含めます。
H1509 Addon Unsupported アドオンがサポート対象外のバージョンを実行しているか、アドオンのバージョンがクラスターのバージョンではサポートされないバージョンです。 アドオンを最新バージョンに更新するか、Istio の具体的な更新手順を参照してください。
H1510 Cluster resources low, not enough workers in Ready state.

以下のいずれかの理由で、アドオンを使用する準備ができていません。
Enabling アドオンは現在クラスターにデプロイ中です。 アドオンのインストールに最大で 15 分かかる場合があることに注意してください。
H1512 Addon daemonset might not be available on all Ready nodes.

静的ルート・アドオンの場合: 静的ルート・オペレーター DaemonSet は、どのワーカー・ノードでも使用できません。そのため、静的ルート・リソースを適用できません。 以下の理由により、ワーカー・ノードは静的経路オペレーター DaemonSet を実行できません。

まだ Istio アドオンの問題が解決されませんか? こちらのトラブルシューティング・トピックを参照して、Istio デプロイメントをデバッグしてください。