Utilisation de réservations de capacité pour provisionner des noeuds gérés

Découvrez comment réserver de la capacité de calcul pour les grappes que vous avez créées à l'aide de Kubernetes Engine (OKE).

Le service de calcul vous permet de créer des réservations de capacité pour vous assurer que la capacité de calcul est disponible pour les charges de travail en cas de besoin lors d'événements critiques, tels que la reprise après sinistre ou des pics de charge de travail inattendus. Pour plus d'informations sur la façon dont le service de calcul affecte la capacité, sur la quantité de capacité réservée et sur l'application des limites et des quotas, voir Réservations de capacité.

Après avoir créé une réservation de capacité dans le service de calcul, vous pouvez spécifier cette réservation de capacité lors de l'utilisation de Kubernetes Engine pour définir la configuration de positionnement d'un groupe de noeuds gérés. La spécification de la réservation de capacité garantit que les noeuds gérés du groupe de noeuds sont créés à l'aide d'instances de calcul à partir de la capacité réservée.

Notez ce qui suit :

  • Avant de pouvoir spécifier une réservation de capacité dans la configuration de positionnement d'un groupe de noeuds, la réservation de capacité doit déjà exister. Pour les étapes de création d'une réservation de capacité, voir Gestion des réservations de capacité.
  • Assurez-vous que la forme du noeud, le domaine de disponibilité et le domaine d'erreur dans la configuration de positionnement du groupe de noeuds correspondent respectivement au type d'instance, au domaine de disponibilité et au domaine d'erreur de la réservation de capacité.
  • Si vous spécifiez plusieurs domaines de disponibilité dans la configuration de positionnement d'un groupe de noeuds, vous pouvez spécifier une réservation de capacité différente pour chaque domaine de disponibilité.
  • Toutes les modifications que vous apportez aux propriétés des noeuds de travail ne s'appliquent qu'aux nouveaux noeuds de travail. La mise à jour de la réservation de capacité associée à un groupe de noeuds n'a aucune incidence sur les propriétés des noeuds de travail existants.

Politiques IAM requises pour l'utilisation des réservations de capacité

Pour utiliser une réservation de capacité lors de la définition de la configuration de positionnement d'un groupe de noeuds, vous devez appartenir à un groupe disposant d'une autorisation pour utiliser des réservations de capacité. Pour accorder cette autorisation, créez la politique suivante :

Allow group <group-name> to use compute-capacity-reservations in <location>

Notez que si un groupe ne se trouve pas dans le domaine d'identité par défaut, ajoutez le préfixe group '<identity-domain-name>'/'group-name' au nom du groupe. Vous pouvez également spécifier un groupe à l'aide de son OCID, dans le format group id <group-ocid>.

Pour provisionner des noeuds gérés à partir d'une réservation de capacité, vous devez accorder à Kubernetes Engine l'autorisation de lancer des instances à l'aide de réservations de capacité. Pour accorder cette autorisation, créez une politique à l'aide des énoncés de politique suivants :

Allow service oke to use compute-capacity-reservations in tenancy
Allow any-user to use compute-capacity-reservations in tenancy where request.principal.type = 'nodepool'

Pour plus d'informations, voir Politique de gestion des identités et des accès requise.

Réservation de capacité par défaut

Kubernetes Engine prend en charge l'utilisation des réservations de capacité par défaut lors du lancement des noeuds gérés. Avec les réservations de capacité par défaut, vous pouvez vous assurer qu'une même réservation de capacité est utilisée chaque fois qu'une instance est lancée dans le domaine de disponibilité et la location associés à la réservation. Après avoir créé une réservation de capacité par défaut, toutes les instances (y compris les noeuds gérés) lancées dans ce domaine de disponibilité et cette location utilisent la capacité de la réservation de capacité par défaut lorsque cela est possible. Pour plus d'informations, voir Réservations de capacité par défaut.

Il peut arriver que vous ne vouliez pas provisionner des noeuds de travail à partir d'une réservation de capacité par défaut. Vous pouvez sélectionner une autre réservation de capacité ou choisir de ne pas utiliser de réservation de capacité du tout.

Utilisation de la console

Création d'une grappe et définition des réservations de capacité

  1. Suivez les instructions pour créer une grappe à l'aide du flux de création personnalisée. Voir Utilisation de la console pour créer une grappe avec des paramètres définis explicitement dans le flux de création personnalisée.
  2. Lors de la spécification de la configuration de placement pour un groupe de noeuds gérés dans la grappe :
    1. Spécifiez le premier domaine de disponibilité et sous-réseau :
      • Domaine de disponibilité : Sélectionnez le domaine de disponibilité associé à la réservation de capacité que vous voulez utiliser.
      • Domaine d'erreur : (Facultatif) Un ou plusieurs domaines d'erreur dans le domaine de disponibilité dans lequel placer les noeuds de travail.
      • Sous-réseau : Sélectionnez le sous-réseau associé à la réservation de capacité que vous voulez utiliser.
    2. Sélectionnez Afficher les options avancées et spécifiez la réservation de capacité à utiliser :

      • Type de capacité : Sélectionnez Réservation de capacité.
      • Réservation de capacité : Sélectionnez la réservation de capacité à utiliser dans la liste. Si vous ne sélectionnez pas explicitement une réservation de capacité et qu'une réservation de capacité par défaut a été créée pour le domaine de disponibilité, la réservation de capacité par défaut est utilisée. Si vous ne voulez pas utiliser la réservation de capacité par défaut ou toute autre réservation de capacité, sélectionnez Abandonner la réservation par défaut.

    3. Facultativement, sélectionnez Autre rangée pour ajouter des domaines de disponibilité, des sous-réseaux et des réservations de capacité supplémentaires à la configuration de positionnement. Si vous spécifiez plusieurs domaines de disponibilité dans la configuration de positionnement d'un groupe de noeuds, vous pouvez spécifier une réservation de capacité différente pour chaque domaine de disponibilité.

Création d'un groupe de noeuds gérés et définition des réservations de capacité

  1. Dans la page de liste Grappes, sélectionnez le nom de la grappe dans laquelle vous voulez créer un nouveau groupe de noeuds. Si vous avez besoin d'aide pour trouver la page de liste ou la grappe, voir Liste des grappes.
  2. Sous Ressources, sélectionnez Groupes de noeuds, puis Ajouter un groupe de noeuds pour créer un nouveau groupe de noeuds géré et spécifier les propriétés requises pour ses noeuds de travail.
  3. Lors de la spécification de la configuration de placement pour un groupe de noeuds gérés dans la grappe :
    1. Spécifiez le premier domaine de disponibilité et sous-réseau :
      • Domaine de disponibilité : Sélectionnez le domaine de disponibilité associé à la réservation de capacité que vous voulez utiliser.
      • Domaine d'erreur : (Facultatif) Un ou plusieurs domaines d'erreur dans le domaine de disponibilité dans lequel placer les noeuds de travail.
      • Sous-réseau : Sélectionnez le sous-réseau associé à la réservation de capacité que vous voulez utiliser.
    2. Sélectionnez Afficher les options avancées et spécifiez la réservation de capacité à utiliser :

      • Type de capacité : Sélectionnez Réservation de capacité.
      • Réservation de capacité : Sélectionnez la réservation de capacité à utiliser dans la liste. Si vous ne sélectionnez pas explicitement une réservation de capacité et qu'une réservation de capacité par défaut a été créée pour le domaine de disponibilité, la réservation de capacité par défaut est utilisée. Si vous ne voulez pas utiliser la réservation de capacité par défaut ou toute autre réservation de capacité, sélectionnez Abandonner la réservation par défaut.

    3. Facultativement, sélectionnez Autre rangée pour ajouter des domaines de disponibilité, des sous-réseaux et des réservations de capacité supplémentaires à la configuration de positionnement. Si vous spécifiez plusieurs domaines de disponibilité dans la configuration de positionnement d'un groupe de noeuds, vous pouvez spécifier une réservation de capacité différente pour chaque domaine de disponibilité.

Mise à jour d'un groupe de noeuds gérés et définition des réservations de capacité

  1. Dans la page de liste Grappes, sélectionnez le nom de la grappe à modifier. Si vous avez besoin d'aide pour trouver la page de liste ou la grappe, voir Liste des grappes.
  2. Sous Ressources, sélectionnez Groupes de noeuds, puis sélectionnez le nom du groupe de noeuds gérés à modifier.
  3. Dans la page Détails du groupe de noeuds, sélectionnez Modifier.
  4. Lors de la spécification de la configuration de placement pour un groupe de noeuds gérés dans la grappe :
    1. Spécifiez le premier domaine de disponibilité et sous-réseau :
      • Domaine de disponibilité : Sélectionnez le domaine de disponibilité associé à la réservation de capacité que vous voulez utiliser.
      • Domaine d'erreur : (Facultatif) Un ou plusieurs domaines d'erreur dans le domaine de disponibilité dans lequel placer les noeuds de travail.
      • Sous-réseau : Sélectionnez le sous-réseau associé à la réservation de capacité que vous voulez utiliser.
    2. Sélectionnez Afficher les options avancées et spécifiez la réservation de capacité à utiliser :

      • Type de capacité : Sélectionnez Réservation de capacité.
      • Réservation de capacité : Sélectionnez la réservation de capacité à utiliser dans la liste. Si vous ne sélectionnez pas explicitement une réservation de capacité et qu'une réservation de capacité par défaut a été créée pour le domaine de disponibilité, la réservation de capacité par défaut est utilisée. Si vous ne voulez pas utiliser la réservation de capacité par défaut ou toute autre réservation de capacité, sélectionnez Abandonner la réservation par défaut.

    3. Facultativement, sélectionnez Autre rangée pour ajouter des domaines de disponibilité, des sous-réseaux et des réservations de capacité supplémentaires à la configuration de positionnement. Si vous spécifiez plusieurs domaines de disponibilité dans la configuration de positionnement d'un groupe de noeuds, vous pouvez spécifier une réservation de capacité différente pour chaque domaine de disponibilité.
  5. Enregistrez les modifications.

Utilisation de l'interface de ligne de commande

Pour des informations sur l'utilisation de l'interface de ligne de commande, voir Interface de ligne de commande. Pour une liste complète des indicateurs et les options disponibles pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

Création d'un groupe de noeuds gérés et définition des réservations de capacité

Pour utiliser l'interface de ligne de commande pour créer un groupe de noeuds gérés qui utilise une réservation de capacité pour provisionner des noeuds gérés, incluez la paire clé/valeur capacityReservationId dans le paramètre --placement-configs.

Par exemple :

oci ce node-pool create \
--cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd \
--name test-node \
--node-image-id ocid1.image.oc1.iad.aaaaaaaa6______nha \
--compartment-id oocid1.compartment.oc1..aaaaaaaay______t6q \
--kubernetes-version v1.21.5 \
--node-shape VM.Standard2.1 \
--placement-configs "[{\"availability-domain\":\"IqDk:US-ASHBURN-AD-2\", \"capacityReservationId\":\"ocid1.capacityreservation.oc1.iad.anuwcljt2ah______yeq\", \"subnet-id\":\"ocid1.subnet.oc1.iad.aaaaaaaa2xpk______zva\", \"faultDomains\":[\"FAULT-DOMAIN-3\", \"FAULT-DOMAIN-1\"]}, {\"availability-domain\":\"IqDk:US-ASHBURN-AD-1\", \"subnet-id\":\"ocid1.subnet.oc1.iad.aaaaaaaauhls______bpq\", \"faultDomains\": [\"FAULT-DOMAIN-1\", \"FAULT-DOMAIN-2\"]}]" \
--size 1 \
--region=us-ashburn-1 \

Si une réservation de capacité par défaut a été créée pour le domaine de disponibilité dans lequel vous créez le groupe de noeuds, cette réservation de capacité est utilisée par défaut. Si vous ne voulez pas utiliser la réservation de capacité par défaut ou toute autre réservation de capacité, réglez la valeur de la clé capacityReservationId à une chaîne vide entre guillemets doubles, à savoir \"capacityReservationId\":\"".

Si vous spécifiez plusieurs domaines de disponibilité dans la configuration de positionnement d'un groupe de noeuds, vous pouvez spécifier une réservation de capacité différente pour chaque domaine de disponibilité.

Utilisation de l'API

Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'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.

Utilisez l'attribut placementConfigs de l'objet nodeConfigDetails pour spécifier des réservations de capacité lors de la création ou de la mise à jour de groupes de noeuds gérés.

Si une réservation de capacité par défaut a été créée pour le domaine de disponibilité dans lequel vous créez le groupe de noeuds gérés, cette réservation de capacité est utilisée par défaut. Si vous ne voulez pas utiliser la réservation de capacité par défaut ou toute autre réservation de capacité, réglez la valeur du champ capacityReservationId à une chaîne vide entre guillemets doubles, à savoir "capacityReservationId":"".

Si vous spécifiez plusieurs domaines de disponibilité dans la configuration de positionnement d'un groupe de noeuds, vous pouvez spécifier une réservation de capacité différente pour chaque domaine de disponibilité.