Réinitialisation des noeuds de processus actif

Pour réinitialiser un noeud géré ou un noeud autogéré spécifique

Pour réinitialiser un noeud géré ou un noeud autogéré spécifique, utilisez la commande oci ce cluster reboot-cluster-node et les paramètres requis :

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

Par exemple :

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}"

Pour redémarrer un noeud géré spécifique à l'aide de l'API OCI, procédez comme suit :

Exécutez l'opération RebootClusterNode pour redémarrer un noeud géré spécifique à l'aide de l'API OCI.

Pour redémarrer un noeud géré ou un noeud autogéré à l'aide de l'API Kubernetes, procédez comme suit :

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

1. Créez un fichier YAML pour définir une ressource personnalisée NodeOperationRule, comme suit :

   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>
   

   où :

   • name: <rule-name> indique le nom de votre choix pour la ressource personnalisée NodeOperationRule. Par exemple, name: my-reboot-rule
   • oke.oraclecloud.com/node_operation: "<value>" indique la valeur de votre choix pour la clé de libellé oke.oraclecloud.com/node_operation. Les noeuds que vous souhaitez réinitialiser doivent être associés à cette paire clé-valeur d'étiquette. Par exemple :

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

     La valeur que vous indiquez pour la clé de libellé oke.oraclecloud.com/node_operation doit être conforme aux exigences de la rubrique Libellés et sélecteurs de la documentation Kubernetes. Seules les exigences basées sur l'égalité de Kubernetes sont prises en charge.

   • matchCustomLabels indique éventuellement un libellé personnalisé avec la paire clé-valeur de votre choix au format <custom-key>: "<value>". Vous pouvez éventuellement spécifier une paire clé-valeur de libellé personnalisée pour répondre à votre propre cas d'utilisation. Par exemple :

         matchCustomLabels:
           deployment: "green"

     La paire clé-valeur de libellé personnalisé que vous indiquez doit être conforme aux exigences de la rubrique Libellés et sélecteurs de la documentation Kubernetes. Seules les exigences basées sur l'égalité de Kubernetes sont prises en charge.

     Si vous spécifiez une paire clé-valeur de libellé personnalisée dans le manifeste, les noeuds ne sont réinitialisés que s'ils ont à la fois ce libellé personnalisé et le libellé oke.oraclecloud.com/node_operation: "<value>".

   • maxParallelism: <n> indique le nombre de noeuds de processus actif à redémarrer en parallèle, jusqu'à 20 au maximum.
   • evictionGracePeriod: <number-of-minutes> indique la durée pendant laquelle les noeuds de processus actif de cordon et de purge doivent être réinitialisés. Acceptez la valeur par défaut (60 minutes, soit la valeur maximale) ou indiquez une autre valeur. Par exemple, vous pouvez accorder 30 minutes aux nœuds de travail en cordon et les vider de leurs charges de travail. Pour réinitialiser immédiatement les noeuds de processus actifs, sans les raccorder ni les vider, indiquez 0 minute.
   • isForceActionAfterGraceDuration: <true|false> indique si les noeuds de processus actif doivent être réinitialisés à la fin de la période de grâce d'expulsion, même s'ils n'ont pas été correctement cordonnés et vidés. La valeur par défaut est false si elle n'est pas indiquée.

   Par exemple :

   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. Utilisez kubectl pour appliquer le fichier yaml au cluster en saisissant la commande suivante :

   kubectl apply -f <filename>.yaml

3. Utilisez kubectl pour confirmer que la ressource personnalisée NodeOperationRule a été créée en saisissant la commande suivante :

   kubectl get nor

4. Utilisez kubectl pour ajouter au noeud un libellé indiquant la valeur de la clé de libellé oke.oraclecloud.com/node_operation en saisissant la commande suivante :

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

   Par exemple :

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

5. Si vous avez inclus un élément matchCustomLabels dans le manifeste pour spécifier une paire clé-valeur de libellé personnalisée, utilisez kubectl pour ajouter un libellé au noeud qui spécifie la paire clé-valeur en saisissant ce qui suit :

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

   Par exemple :

   kubectl label node 10.0.10.53 deployment=green

6. (Facultatif) Vous pouvez afficher l'action de réinitialisation du noeud en cours en saisissant :

   kubectl describe nor <rule-name>

   Par exemple :

   kubectl describe nor my-reboot-rule

   Exemple de sortie :

   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
   ```