Azure Kubernetes Fleet Manager のクラスター リソース配置における退避と中断の制御

適用対象: ✔️ ハブ クラスターを含む Fleet Manager

Fleet Manager のクラスター リソース配置 (CRP) を使用する管理者は、以前にメンバー クラスターに配置したリソースを削除する必要がある場合があります。 また、重要なリソースの配置を妨げないようにする必要もあります。

この記事では、Fleet Manager の ClusterResourcePlacementEviction オブジェクトと ClusterResourcePlacementDisruptionBudget オブジェクトを使用してこれらの目標を達成する方法について説明します。

Note

Fleet Manager のクラスター リソース配置 (CRP) にまだ慣れていない場合は、この記事を読む前にリソース配置の概念の概要をお読みください。

配置済みリソースを退避する

ClusterResourcePlacementEviction オブジェクトは、Fleet Manager ハブ クラスターからリソースが伝達されると、メンバー クラスターからリソースを削除するために使用されます。

クラスターからリソースを正常に削除するには、次を指定する必要があります。

  • ターゲット クラスターにリソースを伝達した ClusterResourcePlacement オブジェクトの名前。
  • リソースを削除する必要があるターゲット クラスターの名前。

削除は、クラスター リソース配置の PickAll ポリシーと PickN ポリシーで使用できます。 PickedFixed は、ターゲット クラスターを編集して CRP を再適用できるため、サポートされていません。

Note

削除では、Fleet スケジューラによってリソースがメンバー クラスターに再び反映されないという保証はありません。 テイントを適用し、フリート スケジューラが特定のクラスターを再度選択するのを防ぐ必要があります。

次のサンプル CRP について考えてみましょう。

apiVersion: placement.kubernetes-fleet.io/v1
kind: ClusterResourcePlacement
metadata:
  name: crp-app-sample
spec:
  resourceSelectors:
    - group: ""
      kind: Namespace
      name: test-namespace
      version: v1
  policy:
    placementType: PickN
    numberOfClusters: 2
    affinity:
      clusterAffinity:
        requiredDuringSchedulingIgnoredDuringExecution:
          clusterSelectorTerms:
            - labelSelector:
                matchLabels:
                  fleet.azure.com/location: westus

この CRP を適用した後、 配置の状態を調べて 、リソースがデプロイされているクラスターを特定できます。

たとえば、配置で member-cluster-01 と member-cluster-02 という名前の 2 つのクラスターが選択され、リソースを member-cluster-02 にデプロイして削除したくないと判断したとします。

  1. メンバー クラスターの配置要求をブロックする NoSchedule テイントを作成します。 テイントの使用について詳しくは、テイント説明書をご覧ください。

    apiVersion: placement.kubernetes-fleet.io/v1
    kind: MemberCluster
    metadata:
      name: member-cluster-02
    spec:
      identity:
        name: fleet-member-agent-cluster-2
        kind: ServiceAccount
        namespace: fleet-system
        apiGroup: ""
      taints:                   
        - key: any-key
          value: any-value
          effect: NoSchedule
    
  2. 次に、 ClusterResourcePlacementEvictionを作成して適用します。

    apiVersion: placement.kubernetes-fleet.io/v1
    kind: ClusterResourcePlacementEviction
    metadata:
      name: eviction-sample
    spec:
      placementName: crp-app-sample
      clusterName: member-cluster-02
    
  3. 指定したリソースが member-cluster-02 クラスターから削除されていることを確認します。

    kubectl get crpe eviction-sample
    

    結果として次の出力が表示され、 EXECUTED に Trueが表示されます。

    NAME            VALID   EXECUTED
    test-eviction   True    True 
    

クラスターから配置されたリソースを強制的に削除する方法を理解したので、キー リソースを削除から保護する方法を見てみましょう。

退避から保護する

ClusterResourcePlacementDisruptionBudget オブジェクトは、配置されたリソースに ClusterResourcePlacementEviction オブジェクトを適用したときに発生する自発的な中断から保護します。 これは、不可抗力による中断を防ぐものではありません。

この記事で前に示したクラスター リソースの配置の例では、次のように配置中断予算オブジェクトを定義できます。

中断予算の名前は CRP と一致する必要があります。

apiVersion: placement.kubernetes-fleet.io/v1
kind: ClusterResourcePlacementDisruptionBudget
metadata:
  name: crp-app-sample
spec:
  minAvailable: 1

仕様で、次の 2 つの相互排他的フィールドのいずれかを指定します。

  • maxUnavailable: 任意の形式の中断が原因で配置を使用できないクラスターの最大数。
  • minAvailable: どのフォームの中断でも配置できるクラスターの最小数。

どちらのフィールドも、整数としてのクラスターの絶対数、またはフリート内のクラスターの合計数に対する割合のいずれかになります。

特定の ClusterResourcePlacement ポリシーの中断予算を指定する場合は、次のサポート マトリックスを参照してください。

CRP ポリシー minAvailable (整数) minAvailable (%) maxUnavailable (整数) MaxUnavailable (%)
PickFixed ❌ ❌ ❌ ❌
PickAll ✅ ❌ ❌ ❌
PickN ✅ ✅ ✅ ✅

Note

配置に対して無効な中断予算オブジェクトを作成した場合は、どのような削除も試行できません。

排除がブロックされていることを検証する

構成された中断予算によって退避がブロックされたことを確認します。

kubectl get crpe eviction-sample

EXECUTED フィールドにFalseが表示されます。これは、エビクションが適用されなかったことを意味します。

NAME            VALID   EXECUTED
test-eviction   True    False

中断予算によって退避がブロックされたことを確認するには、同じ kubectl コマンドを実行し、-o yaml を追加します。 message値は、中断予算が立ち退きをブロックしたことを示しています。

status:
  conditions:
  - lastTransitionTime: "2025-01-21T15:52:29Z"
    message: Eviction is valid
    observedGeneration: 1
    reason: ClusterResourcePlacementEvictionValid
    status: "True"
    type: Valid
  - lastTransitionTime: "2025-01-21T15:52:29Z"
    message: 'Eviction is blocked by specified ClusterResourcePlacementDisruptionBudget,
      availablePlacements: 1, totalPlacements: 1'
    observedGeneration: 1
    reason: ClusterResourcePlacementEvictionNotExecuted
    status: "False"
    type: Executed

不本意な中断

配置中断予算は、不可抗力による中断を防ぐものではありません。 不本意な中断の例を次に示します。

  • Fleet Manager スケジューラは、スケジューリング ポリシーの変更により、メンバー クラスターからリソースを削除します。
  • メンバー クラスターで実行されているワークロード リソースを手動で削除します(エビクションまたは CRP の更新によるものではありません)。
  • メンバー クラスター上のリソースの配置を表す内部リソースである ClusterResourceBinding オブジェクトを手動で削除します。
  • 構成ミスまたはクラスター関連の問題により、メンバー クラスターでワークロードが正しく実行されない。

次のステップ