適用対象: ✔️ ハブ クラスターを含む 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 にデプロイして削除したくないと判断したとします。
メンバー クラスターの配置要求をブロックする
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次に、
ClusterResourcePlacementEvictionを作成して適用します。apiVersion: placement.kubernetes-fleet.io/v1 kind: ClusterResourcePlacementEviction metadata: name: eviction-sample spec: placementName: crp-app-sample clusterName: member-cluster-02指定したリソースが
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オブジェクトを手動で削除します。 - 構成ミスまたはクラスター関連の問題により、メンバー クラスターでワークロードが正しく実行されない。