6.6. ポイズンピルオペレーターによるノードの修復

手順

1. OpenShift Container Platform Web コンソールで、Operators OperatorHub ページに移動します。
2. 使用可能なオペレーターのリストからポイズンピルオペレーターを検索し、Installをクリックします。
3. Operator が openshift-operators namespace にインストールされるように、Installation mode と namespace のデフォルトの選択を維持します。
4. Install をクリックします。

1. Operators Installed Operators ページに移動します。
2. Operator が openshift-operators の namespace に設置されていることと、その状態が Succeeded になっていることを確認してください。

1. Operators Installed Operators ページに移動し、Status 列でエラーまたは失敗の有無を確認します。
2. Workloads Podsページに移動し、問題を報告している poison-pill-controller-manager プロジェクトの Pod のログを確認します。

手順

1. Poison Pill Operator の Namespace カスタムリソース (CR) を作成します。

   1. NamespaceCR を定義し、YAML ファイルを保存します (例: poison-pill-namespace.yaml)。

      apiVersion: v1
      kind: Namespace
      metadata:
        name: poison-pill

   2. NamespaceCR を作成するには、次のコマンドを実行します。

      $ oc create -f poison-pill-namespace.yaml

2. OperatorGroup を作成します。

   1. OperatorGroup CR を定義し、YAML ファイルを保存します (例: poison-pill-operator-group.yaml )。

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: poison-pill-manager
        namespace: poison-pill

   2. OperatorGroup CR を作成するには、次のコマンドを実行します。

      $ oc create -f poison-pill-operator-group.yaml

3. SubscriptionCR を作成します。

   1. SubscriptionCR を定義し、YAML ファイル (poison-pill-subscription.yaml など) を保存します。

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
          name: poison-pill-manager
          namespace: poison-pill 1
      spec:
          channel: stable
          installPlanApproval: Manual 2
          name: poison-pill-manager
          source: redhat-operators
          sourceNamespace: openshift-marketplace
          package: poison-pill-manager

      1

      Poison Pill Operator をインストールする Namespace を指定します。openshift-operators namespace に Poison Pill Operator をインストールするには、Subscription CR で openshift-operators を指定します。

      2

      指定したバージョンがカタログの新しいバージョンに置き換えられる場合に備えて、承認ストラテジーを Manual に設定します。これにより、新しいバージョンへの自動アップグレードが阻止され、最初の CSV のインストールが完了する前に手動での承認が必要となります。

   2. SubscriptionCR を作成するには、次のコマンドを実行します。

      $ oc create -f poison-pill-subscription.yaml

検証

1. CSV リソースを調べて、インストールが成功したことを確認します。

   $ oc get csv -n poison-pill

   出力例

   NAME                   DISPLAY                 VERSION   REPLACES    PHASE
   poison-pill.v.0.2.0     Poison Pill Operator    0.2.0                 Succeeded

2. Poison PillOperator が稼働していることを確認します。

   $ oc get deploy -n poison-pill

   出力例

   NAME                                 READY   UP-TO-DATE   AVAILABLE   AGE
   poison-pill-controller-manager       1/1     1            1           10d

3. Poison PillOperator が PoisonPillConfigCR を作成したことを確認します。

   $ oc get PoisonPillConfig -n poison-pill

   出力例

   NAME                 AGE
   poison-pill-config   10d

4. 各ポイズンピル Pod がスケジュールされ、各ワーカーノードで実行されていることを確認します。

   $ oc get daemonset -n poison-pill

   出力例

   NAME             DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   poison-pill-ds   2         2         2       2            2           <none>          10d

   注記

   このコマンドは、コントロールプレーンノードではサポートされていません。

手順

1. PoisonPillRemediationTemplate CR を作成します。

   1. PoisonPillRemediationTemplate を定義します。

      apiVersion: poison-pill.medik8s.io/v1alpha1
      kind: PoisonPillRemediationTemplate
      metadata:
        namespace: openshift-machine-api
        name: poisonpillremediationtemplate-sample
      spec:
        template:
          spec: {}

   2. PoisonPillRemediationTemplate CR を作成するには、次のコマンドを実行します。

      $ oc create -f <ppr-name>.yaml

2. PoisonPillRemediationTemplate CR を指すように MachineHealthCheckCR を作成または更新します。

   1. MachineHealthCheck を定義または更新します。

      apiVersion: machine.openshift.io/v1beta1
      kind: MachineHealthCheck
      metadata:
        name: machine-health-check
        namespace: openshift-machine-api
      spec:
        selector:
          matchLabels:
            machine.openshift.io/cluster-api-machine-role: "worker"
            machine.openshift.io/cluster-api-machine-type: "worker"
        unhealthyConditions:
        - type:    "Ready"
          timeout: "300s"
          status: "False"
        - type:    "Ready"
          timeout: "300s"
          status: "Unknown"
        maxUnhealthy: "40%"
        nodeStartupTimeout: "10m"
        remediationTemplate: 1
          kind: PoisonPillRemediationTemplate
          apiVersion: poison-pill.medik8s.io/v1alpha1
          name: poisonpillremediationtemplate-sample

      1

      修復テンプレートの詳細を指定します。

   2. MachineHealthCheck CR を作成するには、次のコマンドを実行します。

      $ oc create -f <file-name>.yaml

   3. MachineHealthCheck CR を更新するには、次のコマンドを実行します。

      $ oc apply -f <file-name>.yaml