Documentation sur Oracle Cloud Infrastructure

Cyclisme de noeud sur un groupe de noeuds OKE

Sur Private Cloud Appliance, lorsque vous mettez à jour un groupe de noeuds, seuls les nouveaux noeuds qui sont ajoutés lors de cette mise à jour ou qui sont ajoutés plus tard reçoivent les mises à jour. Pour remplacer les noeuds existants par de nouveaux noeuds qui utilisent des paramètres mis à jour, activez l'option de cyclage de noeud.

Le cyclage de noeud effectue une mise à jour sur place de tous les noeuds existants du groupe de noeuds à la dernière configuration spécifiée. De nouveaux noeuds sont créés, les charges de travail déplacées vers eux à partir de noeuds existants, les mises à jour courantes du groupe de noeuds sont appliquées et les noeuds initiaux sont arrêtés.

Vous pouvez définir le nombre maximal de noeuds qui commencent ou se terminent à un moment donné.

  • Augmentation maximum. Nombre maximal de nouveaux noeuds pouvant démarrer à tout moment au cours de cette opération de mise à jour. Définissez cette valeur pour éviter d'ajouter trop de nouveaux noeuds avant l'arrêt des noeuds existants, ce qui pourrait entraîner un coût excessif. La valeur par défaut est 1. La valeur maximale est 5.

  • Indisponibilité maximum. Nombre maximal de noeuds existants pouvant se terminer à tout moment au cours de cette opération de mise à jour. Définissez cette valeur pour vous assurer qu'il reste suffisamment de noeuds pour gérer la charge globale. La valeur par défaut est 0. La valeur maximale est 7.

L'une de ces valeurs doit être supérieure à 0.

Ces deux valeurs peuvent être réglées à un nombre (de 0 au nombre configuré de noeuds dans le groupe de noeuds, mais pas supérieur au maximum cité ci-dessus) ou à un pourcentage (de 0% à 100%, mais pas à un pourcentage qui entraînerait un nombre supérieur au maximum cité ci-dessus). Ces valeurs peuvent comporter un maximum de quatre caractères.

Ces deux valeurs doivent être un nombre de noeuds, ou ces deux valeurs doivent être un pourcentage. Vous ne pouvez pas spécifier l'une de ces valeurs en tant que nombre de noeuds et l'autre en tant que pourcentage.

Si vous réglez l'une de ces propriétés à une valeur de pourcentage supérieure au nombre maximal autorisé de noeuds, le message d'erreur vous indique la valeur de pourcentage maximal autorisé pour ce groupe de noeuds.

Note

Si l'opération de cyclage de noeud échoue (par exemple, la temporisation de l'opération), essayez de réexécuter l'opération. Vous devrez peut-être exécuter l'opération de cyclage de noeud plusieurs fois si le système est chargé et exécuté à grande échelle.

  • Suivez la procédure sous Mise à jour d'un groupe de noeuds OKE pour mettre à jour la configuration du groupe de noeuds.

    1. Dans la page des détails du groupe de noeuds, sélectionnez le bouton Cycle Nodes.

    2. Dans la boîte de dialogue Cycle Nodes, entrez des valeurs pour les propriétés Maximum Surge et Maximum Unavailable.

      Voir les règles au début de cette rubrique.

    3. Sélectionnez le bouton Cycle Nodes (Noeuds de cycle) dans la boîte de dialogue pour lancer l'opération de mise à jour du groupe de noeuds.

      Pour surveiller la progression de l'opération de mise à jour, consultez le statut de la demande de travail associée.

  • Utilisez l'option --node-pool-cycling-details de la commande oci ce node-pool update pour mettre à jour tous les noeuds existants d'un groupe de noeuds.

    oci ce node-pool update [OPTIONS]

    Pour la liste complète des commandes, indicateurs et options de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

    Procédure

    1. Créez une commande pour mettre à jour la configuration du groupe de noeuds, comme décrit sous Mise à jour d'un groupe de noeuds OKE sous l'onglet CLI.

    2. Dans cette même commande (pas plus tard), incluez l'option --node-pool-cycling-details.

      En plus de régler maximumUnavailable et maximumSurge, activez le cyclage de noeud en réglant isNodeCyclingEnabled à true. Par défaut, isNodeCyclingEnabled est false et le cyclage de noeud n'est pas effectué si vous réglez uniquement maximumUnavailable ou maximumSurge et ne réglez pas isNodeCyclingEnabled à true.

      $ oci ce node-pool update --node-pool-id ocid1.nodepool.unique_ID \
new_configuration_settings \
--node-pool-cycling-details '{"isNodeCyclingEnabled":true,"maximumUnavailable":"value","maximumSurge":"value"}'

      Voir le début de cette rubrique pour les valeurs possibles.

      Dans l'exemple suivant, l'image est mise à jour pour tous les noeuds du groupe de noeuds :

      $ oci ce node-pool update --node-pool-id ocid1.nodepool.unique_ID \
--node-source-details '{"imageId":"ocid1.image.unique_ID","sourceType":"IMAGE"}' \
--node-pool-cycling-details '{"isNodeCyclingEnabled":true,"maximumUnavailable":"5%","maximumSurge":"5%"}'

      Pour surveiller la progression de l'opération de mise à jour, consultez le statut de la demande de travail associée.

      Recherchez l'OCID de la demande de travail :

      oci ce work-request list --compartment-id ocid1.compartment.unique_ID \
--resource-id ocid1.nodepool.unique_ID

      Afficher l'état courant de la demande de travail :

      oci ce work-request get --work-request-id ocid1.workrequest.unique_ID

  • Utilisez l'opération UpdateNodePool pour mettre à jour un groupe de noeuds. Pour mettre à jour tous les noeuds existants du groupe de noeuds, utilisez les attributs nodePoolCyclingDetails : isNodeCyclingEnabled, maximumSurge et maximumUnavailable.

    Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.