Documentation Oracle Cloud Infrastructure

Cyclisme de noeud sur un pool de noeuds OKE

Sur Private Cloud Appliance, lorsque vous mettez à jour un pool de noeuds, seuls les nouveaux noeuds ajoutés lors de cette mise à jour ou ajoutés ultérieurement 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 des noeuds.

Le cyclage de noeud effectue une mise à jour sur place de tous les noeuds existants du pool de noeuds vers la dernière configuration spécifiée. De nouveaux noeuds sont créés, des charges globales y sont déplacées à partir de noeuds existants, des mises à jour de pool de noeuds en cours sont appliquées et les noeuds d'origine sont arrêtés.

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

  • Hausse maximale. 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 d'arrêter les noeuds existants, ce qui peut entraîner un coût excessif. La valeur par défaut est 1. La valeur maximale est 5.

  • Indisponibilité maximale. Nombre maximal de noeuds existants pouvant être terminés à 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.

Une de ces valeurs doit être supérieure à 0.

Ces deux valeurs peuvent être définies sur un nombre (de 0 au nombre configuré de noeuds dans le pool de noeuds, mais pas supérieur au maximum cité ci-dessus) ou un pourcentage (de 0 % à 100 %, mais pas un pourcentage qui aurait pour résultat un nombre supérieur au maximum cité ci-dessus). Ces valeurs peuvent comporter au maximum quatre caractères.

Ces deux valeurs doivent être un nombre de noeuds, ou les deux 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 définissez l'une de ces propriétés sur une valeur de pourcentage qui dépasse le nombre maximum autorisé de noeuds, le message d'erreur vous indique la valeur de pourcentage maximum autorisé pour ce pool de noeuds.

Remarque

Si l'opération de cyclage de noeud échoue (par exemple, si l'opération expire), 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 en cours d'exécution à grande échelle.

  • Suivez la procédure de la section Updating an OKE Node Pool pour mettre à jour la configuration du pool de noeuds.

    1. Sur la page de détails du pool de noeuds, cliquez sur le bouton Cycler noeuds.

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

      Voir les règles au début de ce sujet.

    3. Cliquez sur le bouton Cycler les noeuds dans la boîte de dialogue pour lancer l'opération de mise à jour du pool de noeuds.

      Pour surveiller la progression de l'opération de mise à jour, affichez 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 pool de noeuds.

    oci ce node-pool update [OPTIONS]

    Afin d'obtenir la liste complète des commandes, des indicateurs et des options de l'interface de ligne de commandes, reportez-vous à Référence de ligne de commandes.

    Procédure

    1. Créez une commande pour mettre à jour la configuration du pool de noeuds, comme décrit dans la section Updating an OKE Node Pool sous l'onglet CLI.

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

      En plus de définir maximumUnavailable et maximumSurge, activez le cyclage de noeud en définissant isNodeCyclingEnabled sur true. Par défaut, isNodeCyclingEnabled est false et le cyclage de noeud n'est pas effectué si vous définissez uniquement maximumUnavailable ou maximumSurge et que vous ne définissez pas isNodeCyclingEnabled sur 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"}'

      Reportez-vous au début de cette rubrique pour connaître les valeurs possibles.

      Dans l'exemple suivant, l'image est mise à jour pour tous les noeuds du pool 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, affichez 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 actuel 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 pool de noeuds. Pour mettre à jour tous les noeuds existants du pool de noeuds, utilisez les attributs nodePoolCyclingDetails : isNodeCyclingEnabled, maximumSurge et maximumUnavailable.

    Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.