Documentation Oracle Cloud Infrastructure

Mise à jour d'un pool de noeuds OKE

Sur Private Cloud Appliance, vous pouvez mettre à jour toute configuration que vous pouvez définir lorsque vous créez un pool de noeuds, à l'exception du compartiment dans lequel les noeuds sont créés.

Lorsque vous mettez à jour les propriétés de noeud, les noeuds existants ne sont pas mis à jour par défaut. Les valeurs mises à jour s'appliquent uniquement aux nouveaux noeuds créés. De nouveaux noeuds sont créés lorsque vous augmentez le nombre de noeuds.

Pour remplacer des noeuds existants par de nouveaux noeuds qui utilisent ces paramètres mis à jour, reportez-vous à la section Node Cycling an OKE Node Pool.

Si de nouveaux noeuds de processus actif sont ajoutés, procédez comme suit :

  1. Configurez tous 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 public ou intranet 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 Private Cloud Appliance. 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.

    1. Dans le menu de navigation Interface utilisateur Web de calcul, sélectionnez Conteneurs, puis Clusters Kubernetes (OKE).

    2. Sélectionnez le nom du cluster contenant le pool de noeuds à mettre à jour.

    3. Sur la page de détails du cluster, faites défiler la page jusqu'à la section Ressources et sélectionnez Pools de noeuds.

    4. Pour le pool de noeuds à mettre à jour dans la liste Pools de noeuds, sélectionnez le menu Actions (Image de l'icône à trois points.), puis sélectionnez Modifier.

      La boîte de dialogue Modifier le pool de noeuds s'ouvre. Vous pouvez modifier n'importe quelle configuration, à l'exception du compartiment dans lequel les noeuds sont créés. Pour obtenir la description des propriétés, reportez-vous à la section Creating an OKE Worker Node Pool. La configuration mise à jour s'applique uniquement aux nouveaux noeuds créés.

      Cordon et purge : saisissez le nombre de minutes de la durée de grâce d'expulsion ou utilisez les flèches pour diminuer ou augmenter le nombre de minutes de la durée de grâce d'expulsion. La valeur maximale et la valeur par défaut sont de 60 minutes.

      • Private Cloud Appliance version 3.0.2-b1261765. Vous pouvez indiquer un nombre entier compris entre 0 et 60. Si vous entrez 0, la valeur sera convertie en 0,333 car 20 secondes correspond à la durée minimale de grâce d'expulsion. Le champ affiche une valeur décimale si la valeur existante a été définie au format ISO 8601 et a inclus une valeur de secondes. Par exemple, une valeur existante de PT45S apparaît comme 0,45, PT20M comme 20 et PT39M21S comme 39,35.

      • Private Cloud Appliance version 3.0.2-b1185392. Indiquez un nombre entier compris entre 1 et 60. Si la valeur existante a été définie au format ISO 8601 et inclut une valeur de secondes, cette valeur s'affiche sous la forme du nombre entier supérieur de minutes suivant. La valeur secondes sera toujours utilisée, même si elle ne s'affiche pas.

      Vous ne pouvez pas effacer l'option Forcer la terminaison après la période de grâce. Pour une description du cordon et de la durée de grâce de purge et d'expulsion, reportez-vous à la section Creating an OKE Worker Node Pool et à la section Node and node pool delete settings de l'onglet CLI.

      Remarque

      N'indiquez pas de valeurs pour la balise définie OraclePCA-OKE.cluster_id ou pour la balise à format libre ClusterResourceIdentifier. Ces valeurs de balise sont générées par le système et s'appliquent uniquement aux noeuds (instances), et non à la ressource de pool de noeuds.

    5. Lorsque vous avez terminé d'apporter des modifications, sélectionnez Enregistrer les modifications.

      La page de détails du pool de noeuds s'affiche. Outre les onglets Informations sur le pool de noeuds et Balises, la page de détails du pool de noeuds comporte un onglet Configuration de placement.

      La configuration mise à jour s'applique uniquement aux nouveaux noeuds créés par cette procédure ou ultérieurement.

      Pour remplacer des noeuds existants par de nouveaux noeuds qui utilisent ces paramètres mis à jour, reportez-vous à la section Node Cycling an OKE Node Pool.

    Prochaine étape :

    Si vous apportez des modifications qui ajoutent de nouveaux noeuds de processus actif, procédez comme suit :

    1. Configurez tous 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 public ou intranet 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 Private Cloud Appliance. 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.

  • 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 --node-pool-id <node-pool_OCID> [OPTIONS]

    1. Obtenez les informations dont vous avez besoin pour exécuter la commande.

      • OCID du pool de noeuds à mettre à jour : oci ce node-pool list

      • (Facultatif) Paramètres de suppression des noeuds et des pools de noeuds. Utilisez l'option --node-eviction-node-pool-settings ou --override-eviction-grace-duration pour définir la durée de grâce d'expulsion des noeuds. Les noeuds sont toujours supprimés une fois leurs pods expulsés ou à la fin de la durée de grâce d'expulsion. Reportez-vous à la description dans Création d'un pool de noeuds de processus actif OKE.

      • (Facultatif) Libellés. Pour ajouter des libellés à de nouveaux noeuds, utilisez l'option --initial-node-labels. Les libellés des noeuds existants ne peuvent pas être modifiés à l'aide de l'option --initial-node-labels. Les libellés des noeuds existants peuvent être modifiés à l'aide de kubectl. Pour plus d'informations sur les libellés de noeud, reportez-vous à Création d'un pool de noeuds de processus actif OKE.

      • (Facultatif) Balises. Ajoutez, modifiez ou supprimez des balises définies ou à format libre pour la ressource de pool de noeuds à l'aide des options --defined-tags et --freeform-tags. N'indiquez pas de valeurs pour la balise définie OraclePCA-OKE.cluster_id ou pour la balise à format libre ClusterResourceIdentifier. Ces valeurs de balise sont générées par le système et s'appliquent uniquement aux noeuds (instances), et non à la ressource de pool de noeuds.

        Pour ajouter des balises aux noeuds qui viennent d'être ajoutés au pool de noeuds, utilisez les options --node-defined-tags et --node-freeform-tags.

      • (Facultatif) Package de certificats CA personnalisé. Vous pouvez spécifier un groupe de certificats CA personnalisé à utiliser pour vérifier les connexions TLS à un registre de conteneurs privé. Utilisez les paramètres de métadonnées custom-ca-bundle-cert, registry-host et registry-port avec l'option --node-metadata.

        Dans l'argument d'option --node-metadata, vous devez fournir des valeurs pour custom-ca-bundle-cert et registry-host, et vous pouvez éventuellement fournir une valeur pour registry-port comme indiqué dans l'exemple d'argument de fichier suivant :

        --node-metadata custom-ca-bundle-cert=<base64-encoded-cert-content>,registry-host=<registry.example.com>,registry-port=5000

        Si vous avez configuré un registre privé avec un package d'autorité de certification personnalisé, assurez-vous que les noeuds sont nouvellement provisionnés ou cyclés (redimensionnement et sauvegarde ou redémarrage non simultané) pour appliquer le certificat mis à jour à tous les noeuds de processus actif.

    2. (Facultatif) Créez un argument pour l'option --node-pool-cycling-details et utilisez cette option pour appliquer ces mises à jour à tous les noeuds du pool de noeuds.

      Sans l'option --node-pool-cycling-details, la configuration mise à jour indiquée dans cette commande node-pool update s'applique uniquement aux nouveaux noeuds créés par cette commande ou ultérieurement, comme décrit au début de cette rubrique.

      Pour remplacer des noeuds existants par de nouveaux noeuds qui utilisent ces paramètres mis à jour, spécifiez l'option --node-pool-cycling-details comme décrit dans la section Node Cycling an OKE Node Pool.

    3. Exécutez la commande de mise à jour du pool de noeuds.

      $ oci ce node-pool update --node-pool-id ocid1.nodepool.unique_ID \
<new_configuration_settings>

    Prochaine étape :

    Si vous apportez des modifications qui ajoutent de nouveaux noeuds de processus actif, procédez comme suit :

    1. Configurez tous 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 public ou intranet 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 Private Cloud Appliance. 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 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

  • 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, procédez comme suit :

    1. Configurez tous 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 public ou intranet 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 Private Cloud Appliance. 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 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.