クラスター・アドオンのデバッグ

仮想プライベートクラウド クラシック・インフラストラクチャー

IBM Cloud® Kubernetes Service を使用するときは、マネージド・アドオン (Istio など) をトラブルシューティングするための以下の手法を検討してください。

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

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 を実行できません。