Documentation Oracle Cloud Infrastructure

Cyclage d'un pool de noeuds OKE par un noeud

Sur Compute Cloud@Customer, lorsque vous mettez à jour un pool de noeuds, seuls les nouveaux noeuds ajoutés au cours de cette mise à jour ou ajoutés ultérieurement reçoivent les mises à jour. Pour remplacer les nœuds existants par de nouveaux nœuds qui utilisent des paramètres mis à jour, activez l'option de cyclage des nœuds.

Le cyclage de noeuds 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, les 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é.

  • Surtension maximale. Nombre maximal de nouveaux noeuds pouvant être démarrés à tout moment au cours de cette opération de mise à jour. Définissez cette valeur pour éviter d'ajouter trop de nouveaux noeuds avant la fin des 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 arrêté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 sur un pourcentage (de 0 % à 100 %, mais pas sur un pourcentage qui entraînerait un nombre supérieur au maximum cité ci-dessus). Ces valeurs peuvent contenir jusqu'à 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 supérieure au nombre maximal autorisé de noeuds, le message d'erreur vous indique la valeur de pourcentage maximale autorisée pour ce pool de noeuds.

Remarque

Si l'opération de cyclage du noeud échoue (par exemple, 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 décrite dans 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 Cycle Nodes, entrez les valeurs des propriétés Maximum Surge et Maximum Unavailable.

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

    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 la commande oci ce node-pool update et les paramètres requis pour mettre à jour un pool de noeuds.

    oci ce node-pool update [OPTIONS]

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

    Procédure

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

    2. Dans cette même commande (et non plus ultérieurement), 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 a la valeur false et le cyclage de noeud n'est pas effectué indépendamment de la définition d'autres variables de cyclage de noeud.

      $ 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 demande de travail :

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

      Affichez 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.

    Si vous apportez des modifications qui ajoutent de nouveaux noeuds de processus actif, envisagez les étapes suivantes :

    1. Configurez les registres ou référentiels dont les noeuds de processus actif ont besoin. Assurez-vous que vous avez accès à un registre de conteneurs intranet ou public autogéré à utiliser avec le service OKE et les images de votre application.

    2. Créez un service pour exposer les applications en conteneur en dehors de Compute Cloud@Customer. Reportez-vous à Exposition d'applications en conteneur.

    3. Créez un stockage persistant pour les applications à utiliser. Reportez-vous à Ajout de stockage pour les applications en conteneur.

    Pour modifier les propriétés des noeuds existants, vous pouvez créer un pool de noeuds avec les nouveaux paramètres et déplacer le travail vers les nouveaux noeuds.

    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.