Azure Kubernetes Fleet Manager での ClusterResourcePlacement API のトラブルシューティング

概要

このトラブルシューティング ガイドは、Azure Kubernetes Fleet Manager を使用 ClusterResourcePlacement API オブジェクト関連の問題を解決するのに役立ちます。 ハブ クラスターでこれらのエラーをトラブルシューティングするには、次のオブジェクトに関する知識が必要です。

  • ClusterResourceSnapshot
  • ClusterSchedulingPolicySnapshot
  • ClusterResourceBinding
  • Work

各オブジェクトの詳細については、 KubeFleet API リファレンスを参照してください。

ClusterResourcePlacement デプロイメントの完了状況の進行

ClusterResourcePlacementカスタム リソースの進行状況と状態を理解することは、障害の診断と識別に不可欠です。 次のコマンドを使用して、 ClusterResourcePlacement カスタム リソースの状態を表示できます。

kubectl describe clusterresourceplacement <name>

詳細については、「 ClusterResourcePlacement API を使用してリソースをメンバー クラスターに伝達する」を参照してください。

ClusterResourcePlacementの完全な進行は次のとおりです。

  1. ClusterResourcePlacementScheduled: リソースが配置用にスケジュールされていることを示します。

    false の場合は、「 ClusterResourcePlacementScheduled 条件の状態が false の場合のトラブルシューティング方法」を参照してください。

  2. ClusterResourcePlacementRolloutStarted: ロールアウト プロセスが開始されたことを示します。

    false の場合は、「 ClusterResourcePlacementRolloutStarted 条件の状態が false の場合のトラブルシューティング方法」を参照してください。

  3. ClusterResourcePlacementOverridden: リソースがオーバーライドされたことを示します。

    false の場合は、「 ClusterResourcePlacementOverridden 条件の状態が false の場合のトラブルシューティング方法」を参照してください。

  4. ClusterResourcePlacementWorkSynchronized: 作業オブジェクトが同期されたことを示します。

    false の場合は、「 ClusterResourcePlacementWorkSynchronized 条件の状態が false の場合のトラブルシューティング方法」を参照してください。

  5. ClusterResourcePlacementApplied: リソースが適用されたことを示します。

    false の場合は、「 ClusterResourcePlacementApplied 条件の状態が false の場合のトラブルシューティング方法」を参照してください。

  6. ClusterResourcePlacementAvailable: リソースが使用可能であることを示します。

    false の場合は、「 ClusterResourcePlacementAvailable 条件の状態が false の場合のトラブルシューティング方法」を参照してください。

FAQ

一部のクラスターが期待どおりに選択されていない場合にデバッグするにはどうすればよいですか?

ClusterSchedulingPolicySnapshotの状態を確認して、選択されたクラスターとその選択理由を確認します。

選択したクラスターに予想されるリソースがない場合、または ClusterResourcePlacement が最新の変更を取得しない場合、デバッグするにはどうすればよいですか?

  1. ClusterResourcePlacementRolloutStarted状態のClusterResourcePlacement条件が true または false に設定されているかどうかを確認します。
  2. ClusterResourcePlacementApplied条件が unknown、false、または true に設定されているかどうかを確認します。
  3. 特定のクラスターの状態におけるplacementStatusesのClusterResourcePlacementセクションを確認します。 FailedPlacementsセクションでは、リソース アプリケーションのエラーの理由を示す必要があります。

ClusterResourcePlacement デプロイの最新の ClusterSchedulingPolicySnapshot を見つけて確認するにはどうすればよいですか?

ClusterSchedulingPolicySnapshot API デプロイの最新のClusterResourcePlacementを見つけるには、次のコマンドを実行します。

kubectl get clusterschedulingpolicysnapshot -l kubernetes-fleet.io/is-latest-snapshot=true,kubernetes-fleet.io/parent-CRP={CRPName}

注

このコマンドでは、 {CRPName} を実際の ClusterResourcePlacement 名に置き換えます。

次に、 ClusterSchedulingPolicySnapshot を ClusterResourcePlacement ポリシーと比較して、'ClusterResourcePlacement' 仕様の numberOfClusters フィールドを除外して、それらが一致することを確認します。

配置の種類が PickNされている場合は、 ClusterResourcePlacement ポリシーで要求されたクラスターの数が、 number-of-clusters ラベルの値と一致するかどうかを確認します。

最新の ClusterResourceBinding リソースを見つけるにはどうすればよいですか?

次のコマンドは、ClusterResourceBindingsに関連付けられているすべてのClusterResourcePlacement インスタンスを一覧表示します。

Kubectl get clusterresourcebinding -l kubernetes-fleet.io/parent-CRP={CRPName}

注

このコマンドでは、 {CRPName} を実際の ClusterResourcePlacement 名に置き換えます。

例

  1. 次のコマンドを実行して、 ClusterResourcePlacement デプロイの状態を表示します。 この場合、 ClusterResourcePlacement 名は test-crp。

    kubectl describe clusterresourceplacement test-crp

  2. 出力例を次に示します。 placementStatuses状態の test-crp セクションから、リソースが 2 つのメンバー クラスターに分散されているため、2 つのClusterResourceBindings インスタンスがあることに注意してください。

    status:
  conditions:
  - lastTransitionTime: "2023-11-23T00:49:29Z"
    ...
  placementStatuses:
  - clusterName: kind-cluster-1
    conditions:
      ...
      type: ResourceApplied
  - clusterName: kind-cluster-2
    conditions:
      ...
      reason: ApplySucceeded
      status: "True"
      type: ResourceApplied

  3. ClusterResourceBindings値を取得するには、次のコマンドを実行します。

    kubectl get clusterresourcebinding -l kubernetes-fleet.io/parent-CRP=test-crp 

    NAME                               WORKCREATED   RESOURCESAPPLIED   AGE
test-crp-kind-cluster-1-be990c3e   True          True               33s
test-crp-kind-cluster-2-ec4d953c   True          True               33s

    出力には、ClusterResourceBindingsに関連付けられているすべてのtest-crp インスタンスが一覧表示されます。 ClusterResourceBinding リソース名は、次の形式を使用します。

    {CRPName}-{clusterName}-{suffix}

最新の ClusterResourceSnapshot リソースを見つけるにはどうすればよいですか?

最新の ClusterResourceSnapshot リソースを見つけるには、次のコマンドを実行します。

kubectl get clusterresourcesnapshot -l kubernetes-fleet.io/is-latest-snapshot=true,kubernetes-fleet.io/parent-CRP={CRPName}

注

このコマンドでは、 {CRPName} を実際の ClusterResourcePlacement 名に置き換えます。

ClusterResourcePlacement に関連付けられている正しい作業リソースを見つけるにはどうすればよいですか?

正しい作業リソースを見つけるには、次の手順に従います。

  1. メンバー クラスターの名前空間と ClusterResourcePlacement 名を識別します。 名前空間の形式は fleet-member-{clusterName}。

  2. 作業リソースを取得するには、次のコマンドを実行します。

    kubectl get work -n fleet-member-{clusterName} -l kubernetes-fleet.io/parent-CRP={CRPName}

    注

    このコマンドでは、 {clusterName} と {CRPName} を、最初の手順で識別した名前に置き換えます。

  • Last updated on