ワーカー・ノードの再起動

特定の管理対象ノードまたは自己管理ノードを再起動するには

特定の管理対象ノードまたは自己管理ノードを再起動するには、oci ce cluster reboot-cluster-nodeコマンドと必要なパラメータを使用します:

oci ce cluster reboot-cluster-node --cluster-id <cluster-ocid> --node-id <instance-ocid> [OPTIONS]

例:

oci ce cluster reboot-cluster-node --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --node-id ocid1.instance.oc1.iad.anu__flq --node-eviction-settings "{\"evictionGraceDuration\": \"PT0M\",\"isForceActionAfterGraceDuration\": true}"

OCI APIを使用して特定の管理対象ノードを再起動するには:

RebootClusterNode操作を実行して、OCI APIを使用して特定の管理対象ノードを再起動します。

Kubernetes APIを使用して管理対象ノードまたは自己管理ノードを再起動するには:

ALLOW any-user to read instance-images in TENANCY where request.principal.type = 'cluster'

1. 次のように、NodeOperationRuleカスタム・リソースを定義するyamlファイルを作成します。

   apiVersion: oci.oraclecloud.com/v1beta1
   kind: NodeOperationRule
   metadata:
     name: <rule-name>
   spec:
     actions:
       - "reboot"
     nodeSelector:
       matchTriggerLabel:
         oke.oraclecloud.com/node_operation: "<value>"
       matchCustomLabels:
         <custom-key>: "<value>"
     maxParallelism: <n>
     nodeEvictionSettings:
       evictionGracePeriod: <number-of-minutes>
       isForceActionAfterGraceDuration: <true|false>
   

   ここでは:

   • name: <rule-name>は、NodeOperationRuleカスタム・リソースに選択した名前を指定します。たとえば、name: my-reboot-ruleです
   • oke.oraclecloud.com/node_operation: "<value>"は、 oke.oraclecloud.com/node_operationラベル・キーに選択した値を指定します。リブートするノードには、このラベルのキーと値のペアがアタッチされている必要があります。例:

         matchTriggerLabel:
           oke.oraclecloud.com/node_operation: "my-reboot-value"

     oke.oraclecloud.com/node_operationラベル・キーに指定する値は、Kubernetesドキュメントの「ラベルおよびセレクタ」トピックの要件に準拠している必要があります。Kubernetes等価性ベースの要件のみがサポートされています。

   • matchCustomLabelsでは、オプションで、選択したキーと値のペアを含むカスタム・ラベルを<custom-key>: "<value>"の形式で指定します。オプションで、カスタム・ラベルのキーと値のペアを指定して、独自のユースケースに対応できます。例:

         matchCustomLabels:
           deployment: "green"

     指定するカスタム・ラベルのキーと値のペアは、Kubernetesドキュメントの「ラベルとセレクタ」トピックの要件に準拠している必要があります。Kubernetes等価性ベースの要件のみがサポートされています。

     マニフェストでカスタム・ラベルのキーと値のペアを指定した場合、ノードは、このカスタム・ラベルとoke.oraclecloud.com/node_operation: "<value>"ラベルの両方がある場合にのみ再起動されます。

   • maxParallelism: <n>は、パラレルに再起動するワーカー・ノードの数(最大20)を指定します。
   • evictionGracePeriod: <number-of-minutes>は、ワーカー・ノードを再起動する前に、ワーカー・ノードをコード化およびドレインできる時間の長さを指定します。デフォルト(最大値である60分)を受け入れるか、代替を指定します。たとえば、ワーカー・ノードをコード化してワークロードから排出するために、30分を許可できます。ワーカー・ノードをコード化およびドレインせずにすぐに再起動するには、0分を指定します。
   • isForceActionAfterGraceDuration: <true|false>は、ワーカー・ノードが正常にコード化および排出されていない場合でも、削除猶予期間の終了時に再起動するかどうかを指定します。指定しない場合、falseにデフォルト設定されます。

   例:

   apiVersion: oci.oraclecloud.com/v1beta1
   kind: NodeOperationRule
   metadata:
     name: my-reboot-rule
   spec:
     actions:
       - "reboot"
     nodeSelector:
       matchTriggerLabel:
         oke.oraclecloud.com/node_operation: "my-reboot-value"
       matchCustomLabels:
         deployment: "green"
     maxParallelism: 2
     nodeEvictionSettings:
       evictionGracePeriod: 60
       isForceActionAfterGraceDuration: true
   

2. 次のように入力して、kubectlを使用してyamlファイルをクラスタに適用します。

   kubectl apply -f <filename>.yaml

3. 次のように入力して、kubectlを使用して、NodeOperationRuleカスタム・リソースが正常に作成されたことを確認します。

   kubectl get nor

4. kubectlを使用して、次のように入力して、oke.oraclecloud.com/node_operationラベル・キーの値を指定するラベルをノードに追加します。

   kubectl label node <node-name> oke.oraclecloud.com/node_operation=<value>

   例:

   kubectl label node 10.0.10.53 oke.oraclecloud.com/node_operation=my-reboot-value

5. カスタム・ラベルのキーと値のペアを指定するためにマニフェストにmatchCustomLabels要素を含めた場合は、kubectlを使用して、次のように入力して、キーと値のペアを指定するノードにラベルを追加します。

   kubectl label node <node-name> <custom-key>=<value>

   例:

   kubectl label node 10.0.10.53 deployment=green

6. (オプション)次を入力して、進行中のノード再起動アクションを表示できます:

   kubectl describe nor <rule-name>

   例:

   kubectl describe nor my-reboot-rule

   出力例:

   Name:         my-reboot-rule
   Namespace:   
   Labels:       <none>
   Annotations:  <none>
   API Version:  oci.oraclecloud.com/v1beta1
   Kind:         NodeOperationRule
   Metadata:
     Creation Timestamp:  2025-02-11T00:11:11Z
     Finalizers:
       nodeoperationrule.oci.oraclecloud.com/finalizers
     Generation:        1
     Resource Version:  244259806
     UID:               xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
   Spec:
     Actions:
       reboot
     Max Parallelism:  2
     Node Eviction Settings:
       Eviction Grace Period:                 60
       Is Force Action After Grace Duration:  true
     Node Selector:
       Match Trigger Label:
         oke.oraclecloud.com/node_operation:  my-reboot-value
       Match Custom Label:
         deployment: green
   Status:
     Back Off Nodes:
     Canceled Nodes:
     In Progress Nodes:
     	Node Name:        10.0.10.53
       Work Request Id:  ocid1.clustersworkrequest.oc1.phx.aaaa______jda
     Pending Nodes:
     Succeeded Nodes:
   Events:
     Type    Reason                  Age   From               Message
     ----    ------                  ----  ----               -------
     Normal  StartedNodeOperation    1m   NodeOperationRule  Started node operation on node with work request ID: 10.0.10.105: ocid1.clustersworkrequest.oc1.phx.aaaa______jda
   ```