Pod Disruption Budget の設定

EMQX Operator 3.0 は EMQX クラスターに対して Kubernetes の PodDisruptionBudget（PDB）を作成しません。このページでは、ノードのドレイン、クラスターオートスケーラーのスケールダウン、デスケジューラーによる追い出しなどの操作による任意の中断を制限するために、Core Pod と Replicant Pod に対して個別に PDB を作成する方法を説明します。

PDB は Kubernetes Eviction API を通じて要求される追い出しを制限します。強制的な障害、直接的な Pod 削除、または EMQX Operator がローリングアップデート中に管理する Pod の置き換えは防止しません。

はじめに

この例では、現在の kubectl のネームスペースに emqx という名前の EMQX リソースが存在すると仮定しています。リソース名が異なる場合は、apps.emqx.io/instance セレクターや EMQX リソースコマンド内の emqx を metadata.name に置き換えてください。各 PDB は対応する EMQX リソースと同じネームスペースに作成してください。PDB リソース名の emqx-core と emqx-replicant は例です。変更した場合は、PDB の確認コマンドでも新しい名前を使用してください。

EMQX Operator は EMQX のステータスに現在の Pod セレクターを公開しています：

• status.coreSelector
• status.replicantSelector

emqx という名前の EMQX クラスターの場合、これらのセレクターは以下の安定したラベルを使用します：

apps.emqx.io/instance: emqx # 対応する EMQX CR の metadata.name を使用してください。
apps.emqx.io/managed-by: emqx-operator
apps.emqx.io/db-role: core # Replicant Pod には replicant を使用します。

各ロールの Pod 数と可用性要件に基づいて、minAvailable または maxUnavailable を選択してください。例えば、Pod が 1 つだけのロールに対して maxUnavailable: 1 を設定すると可用性は維持されません。任意の中断でその Pod を削除してはならない場合は minAvailable: 1 を使用してください。

PodDisruptionBudget の作成

1. 以下のリソースを emqx-pdb.yaml として保存します。

   この例では、Core Pod と Replicant Pod を別々の可用性プールとして保護するために 2 つの PDB を定義しています。1 つの PDB が両方のロールにマッチすると、片方のロールでの追い出しがもう片方のロールの中断容量を消費してしまいます。クラスターで Replicant Pod を使用していない場合は、emqx-replicant PDB を省略してください。

   apiVersion: policy/v1
   kind: PodDisruptionBudget
   metadata:
     name: emqx-core
   spec:
     maxUnavailable: 1
     selector:
       matchLabels:
         apps.emqx.io/instance: emqx
         apps.emqx.io/managed-by: emqx-operator
         apps.emqx.io/db-role: core
   ---
   apiVersion: policy/v1
   kind: PodDisruptionBudget
   metadata:
     name: emqx-replicant
   spec:
     maxUnavailable: 1
     selector:
       matchLabels:
         apps.emqx.io/instance: emqx
         apps.emqx.io/managed-by: emqx-operator
         apps.emqx.io/db-role: replicant

2. PDB を適用します：

   kubectl apply -f emqx-pdb.yaml

PodDisruptionBudget の確認

1. EMQX Operator が報告するセレクターを確認します：

   kubectl get emqx emqx -o jsonpath='{.status.coreSelector}{"\n"}{.status.replicantSelector}{"\n"}'

2. 各セレクターが期待する Pod にマッチしているか確認します。クラスターで Replicant Pod を使用していない場合は、2 番目のコマンドは省略してください。

   kubectl get pods -l 'apps.emqx.io/instance=emqx,apps.emqx.io/managed-by=emqx-operator,apps.emqx.io/db-role=core'
   kubectl get pods -l 'apps.emqx.io/instance=emqx,apps.emqx.io/managed-by=emqx-operator,apps.emqx.io/db-role=replicant'

3. 各 PDB を確認し、許可されている中断数をレビューします。クラスターで Replicant Pod を使用していない場合は、emqx-replicant とその describe コマンドは省略してください。

   kubectl get pdb emqx-core emqx-replicant
   kubectl describe pdb emqx-core
   kubectl describe pdb emqx-replicant

   制限の厳しい PDB はノードのドレインを無期限にブロックする可能性があります。各 PDB の status.disruptionsAllowed の値を確認し、メンテナンスを開始する前に十分な数のマッチする Pod が準備完了していることを確認してください。