Container Service for Kubernetes:コンポーネントのトラブルシューティング

コンポーネントに必要な特定のリソースがクラスターに既に存在するため、コンポーネントを直接インストールできません。 このエラーコードは、以下のシナリオで返される可能性があります。

• 他の方法を使用して、オープンソースバージョンなど、別のバージョンのコンポーネントをクラスターにインストールしました。

• Helm V2 を使用してコンポーネントをインストールしましたが、Helm を V3 に更新する前にコンポーネントが移行またはアンインストールされていません。

• クラスター内で、コンポーネントに必要なリソースと同じ名前のリソースを作成しました。

問題の原因となっている既存のリソースを削除します。 問題の原因となっている既存のリソースは、エラーメッセージで確認できます。 例：

Addon status not match, failed upgrade helm addon arms-cmonitor for cluster c3cf94b952cd34b54b71b10b7********, err: rendered manifests contain a resource that already exists. Unable to continue with update: ConfigMap "otel-collector-config" in namespace "arms-prom" exists and cannot be imported into the current release

次の例は、特定のコンポーネントについてこの問題を修正する方法を示しています。

• arms-prometheus

  arms-prometheus の場合は、arms-prometheus がインストールされている名前空間を削除します。 ほとんどの場合、arms-prometheus は arms-prom 名前空間にインストールされています。 次のコマンドを実行して、以下のリソースを削除します。 その後、arms-prometheus を再度インストールまたは更新します。

  kubectl delete ClusterRole arms-kube-state-metrics
  kubectl delete ClusterRole arms-node-exporter
  kubectl delete ClusterRole arms-prom-ack-arms-prometheus-role
  kubectl delete ClusterRole arms-prometheus-oper3
  kubectl delete ClusterRole arms-prometheus-ack-arms-prometheus-role
  kubectl delete ClusterRole arms-pilot-prom-k8s
  kubectl delete ClusterRoleBinding arms-node-exporter
  kubectl delete ClusterRoleBinding arms-prom-ack-arms-prometheus-role-binding
  kubectl delete ClusterRoleBinding arms-prometheus-oper-bind2
  kubectl delete ClusterRoleBinding kube-state-metrics
  kubectl delete ClusterRoleBinding arms-pilot-prom-k8s
  kubectl delete ClusterRoleBinding arms-prometheus-ack-arms-prometheus-role-binding
  kubectl delete Role arms-pilot-prom-spec-ns-k8s
  kubectl delete Role arms-pilot-prom-spec-ns-k8s -n kube-system
  kubectl delete RoleBinding arms-pilot-prom-spec-ns-k8s
  kubectl delete RoleBinding arms-pilot-prom-spec-ns-k8s -n kube-system

• ack-node-local-dns

  ack-node-local-dns の場合は、次のコマンドを実行して以下のリソースを削除し、ack-node-local-dns を再度更新します。

  重要

  これらのリソースが削除された後、ビジネスへの影響はありません。 ただし、これらのリソースが削除された後、コンポーネントが再度更新されるまでの間は、ポッドを追加しないことをお勧めします。 この期間中に新しいポッドを追加する場合は、コンポーネントが更新された後にこれらのポッドを削除して再作成し、DNS キャッシュをポッドに再度挿入することをお勧めします。

  kubectl delete MutatingWebhookConfiguration ack-node-local-dns-admission-controller

• arms-cmonitor

  arms-cmonitor の場合は、次のコマンドを実行して以下のリソースを削除し、arms-cmonitor を再度インストールまたは更新します。

  kubectl delete ConfigMap otel-collector-config -n arms-prom
  kubectl delete ClusterRoleBinding arms-prom-cmonitor-role-binding
  kubectl delete ClusterRoleBinding arms-prom-cmonitor-install-init-role-binding
  kubectl delete ClusterRole arms-prom-cmonitor-role
  kubectl delete ClusterRole arms-prom-cmonitor-install-init-role
  kubectl delete ServiceAccount cmonitor-sa-install-init -n kube-system

コンポーネントと同じ名前の Helm リリースがクラスターに既に存在します。 そのため、Helm を使用してコンポーネントを直接インストールまたは更新することはできません。 このエラーコードは、以下のシナリオで返される可能性があります。

• 他の方法を使用して、オープンソースバージョンなど、別のバージョンのコンポーネントをクラスターにインストールしました。

• コンポーネントと同じ名前の残留 Helm リリースが存在します。

クラスター内の既存の Helm リリースを削除するには、次の手順を実行します。

1. ACK コンソール にログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、目的のクラスターを見つけて名前をクリックします。 左側のペインで、[アプリケーション] > [Helm] を選択します。

3. Helm ページで、コンポーネントと同じ名前の残留 Helm リリースを見つけます。 [アクション] 列の [削除] をクリックします。 削除ダイアログボックスで、[リリースレコードをクリア] を選択し、[OK] をクリックします。

4. Helm リリースが削除されたら、コンポーネントをインストールまたは更新します。

コンポーネントポッドが Ready 状態に到達できない問題をトラブルシューティングするには、次の手順を実行します。

1. ACK コンソール にログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、目的のクラスターを見つけて名前をクリックします。 左側のペインで、[操作] > [イベントセンター] を選択します。

3. [イベント (クラスターリソースイベント)] タブで、[レベル] ドロップダウンリストから [警告] を選択し、コンポーネントがデプロイされている名前空間を選択し、[タイプ] ドロップダウンリストから [Pod] を選択すると、コンポーネントに関連するイベントを表示できます。

   イベントの詳細を分析して原因を特定できます。 次の 一般的な原因と解決策 セクションでは、この問題の一般的な原因と解決策について説明します。

イベントの説明: クラスター内のノードが、次の理由により、コンポーネントポッドをホストするための要件を満たしていません。 イベントの詳細に基づいて原因を特定できます。

• ノード上の使用可能な CPU とメモリリソースが、コンポーネントポッドをホストするには不十分です。 この場合、イベントの詳細には [メモリ不足] または [CPU 不足] が含まれます。

• ノードに、コンポーネントポッドが許容しない taint があります。 この場合、イベントの詳細には [ポッドが許容しなかった] が含まれます。

• ノードが、コンポーネントポッドのアンチアフィニティルールを満たすのに不十分です。 この場合、イベントの詳細には [ポッドのアンチアフィニティルールと一致しなかった] が含まれます。

解決策: コンポーネントポッドのスケジューリングの要件を満たすために、次の操作を実行します。 その後、コンポーネントを再度更新します。

• ノードに不要な taint を削除するには、taint の管理 を参照してください。

• 不要になったポッドを削除するには、ポッドの管理 を参照してください。

• クラスターにノードを追加するには、ノードプールの作成 を参照してください。

• クラスター内のノードをアップグレードするには、ワーカーノードの構成のアップグレード を参照してください。

解決策:

• イベント詳細に [vSwitch の IP が不足している] と記載されている場合は、Terway モードで新しいポッド vSwitch を追加 します。

• イベント詳細に [transport: ダイヤリング中にエラーが発生しました] と記載されている場合は、ポッドのトラブルシューティング を実行して、クラスターのネットワークプラグインが想定どおりに動作しているかどうかを確認します。

Tiller を再起動するには、次の手順を実行します。

1. ACK コンソール にログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、目的のクラスターを見つけて名前をクリックします。 左側のペインで、[ワークロード] > [ポッド] を選択します。

3. kube-system 名前空間を選択します。 [tiller] ポッドを見つけて削除します。 その後、システムがポッドを再作成するまで待ちます。

4. Tiller ポッドが Ready 状態になったら、操作を再実行します。

Webhook のトラブルシューティングを行い、問題を修正します。 その後、コンポーネントを再度更新します。 呼び出すことができない Webhook は、エラーメッセージで確認できます。 例：

failed to create: Internal error occurred: failed calling webhook "rancher.cattle.io": failed to call webhook: Post "https://rancher-webhook.cattle-system.svc:443/v1/webhook/mutation?timeout=10s": no endpoints available for service "rancher-webhook"

クラスターにインストールされているオープンソースバージョンをアンインストールするには、次の手順を実行します。

1. ACK コンソール にログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、目的のクラスターを見つけて名前をクリックします。 左側のペインで、[アプリケーション] > [Helm] を選択します。

3. Helm ページで、コンポーネントと同じ名前の残留 Helm リリースを見つけます。 [アクション] 列の [削除] をクリックします。 削除ダイアログボックスで、[リリースレコードをクリア] を選択し、[OK] をクリックします。

4. Helm リリースが削除されたら、コンポーネントをインストールまたは更新します。