Documentation Oracle Cloud Infrastructure

Création d'un pool d'instances

Sur Compute Cloud@Customer, vous pouvez créer un pool d'instances qui se trouvent dans la même région.

L'exécution d'opérations telles que la réinitialisation ou la suppression sur l'objet de pool effectue cette opération sur toutes les instances qui sont membres du pool. L'exécution de ces opérations sur une instance individuelle membre du pool n'a aucune incidence sur les autres instances membres.

La création d'un pool d'instances nécessite une configuration d'instance et une configuration de placement. Les instances ajoutées au pool dans une mise à jour de pool peuvent être créées avec différentes configurations d'instance et de placement.

Pour les instances d'un pool, la valeur de la propriété displayName dans la configuration d'instance est ignorée. Les instances d'un pool sont nommées inst-aaaaa-pool_name, où aaaaa contient cinq caractères alphanumériques aléatoires.

Configuration de placement

Outre une configuration d'instance, la création de pool nécessite une configuration de placement. Les valeurs indiquées dans une configuration de placement remplacent les valeurs indiquées dans la configuration d'instance.

Une configuration de placement peut spécifier des domaines de pannes, un sous-réseau principal et des sous-réseaux de carte d'interface réseau virtuelle secondaires.

Domaines de pannes

Si vous n'indiquez pas de domaine de pannes dans la configuration d'instance ou de placement, le système sélectionne automatiquement les meilleurs domaines de pannes pour les instances de pool. Si vous indiquez un seul domaine de pannes, toutes les instances seront placées dans ce domaine de pannes uniquement. Si vous spécifiez plusieurs domaines de pannes, les instances de pool sont placées uniformément dans ces domaines de pannes, ce qui améliore la haute disponibilité du pool. Si un domaine de pannes ne peut pas accueillir d'instances supplémentaires, la création d'instance s'arrête. Le système ne place pas plus d'instances dans un domaine de pannes que dans un autre.

Si certaines instances ne peuvent pas être lancées en raison de contraintes de ressources, elles restent à l'état Provisionnement et le pool reste à l'état Redimensionnement. Une fois les instances size lancées, le pool peut passer à l'état En cours d'exécution. Tant que le pool est à l'état Redimensionnement, les instances de pool à l'état En cours d'exécution peuvent être utilisées.

Voici des exemples d'actions que vous pouvez effectuer en cas d'échec du lancement d'une instance de pool en raison de contraintes de ressources :

  • Mettez à jour le pool et réduisez la valeur Nombre d'instances ou size.

  • Mettez à jour le pool et modifiez la spécification du domaine de pannes dans la console Compute Cloud@Customer ou dans une nouvelle instance ou configuration de placement.

  • Mettez à jour le pool pour indiquer une nouvelle configuration d'instance qui crée des instances nécessitant moins de ressources.

  • Arrêtez une instance qui n'est pas membre d'un pool dans le domaine de pannes où le lancement de l'instance de pool échoue en raison de contraintes de ressources.

  • Supprimez une instance qui n'est pas membre d'un pool dans le domaine de pannes où le lancement de l'instance de pool échoue en raison de contraintes de ressources.

Prérequis

Pour pouvoir créer un pool d'instances, vous avez besoin d'une configuration d'instance. Une configuration d'instance est un modèle qui définit les paramètres à utiliser lors de la création d'instances. Reportez-vous à Utilisation des configurations d'instance.

Evitez de saisir des informations confidentielles dans les noms et les balises.

    1. Dans le menu de navigation de la console Compute Cloud@Customer, sélectionnez Calcul, puis Configurations d'instance.

    2. En haut de la page, sélectionnez le compartiment contenant la configuration d'instance à utiliser pour créer le pool.

    3. Sélectionnez la configuration d'instance à utiliser pour les instances de ce pool.

    4. Sous Ressources, sélectionnez Pools d'instances attachés.
    5. En haut de la page, sélectionnez d'autres compartiments pour répertorier les pools dans d'autres compartiments.

      Sélectionnez Créer un pool d'instance.

    6. Dans la boîte de dialogue Attacher un pool d'instances à instance_configuration_name, entrez les informations suivantes :

      • Nom : entrez le nom du pool d'instances. Le nom ne doit pas nécessairement être unique. Ce nom est utilisé dans les noms des instances créées. Si vous n'indiquez pas de nom pour le pool, le nom par défaut du pool d'instances est instancepoolYYYYMMDDhhmmss, où YYYYMMDDhhmmss est la date et l'heure de création.

      • Créer dans le compartiment : sélectionnez un compartiment pour cette définition de pool d'instances. Les instances du pool seront créées dans le compartiment indiqué dans la configuration d'instance.

      • Nombre d'instances : indiquez le nombre d'instances à créer dans ce pool d'instances.

      • Placement du pool : sélectionnez les domaines de pannes, le VCN et le sous-réseau pour les instances de ce pool. Vous pouvez sélectionner un autre compartiment à partir duquel choisir le VCN et le sous-réseau. Reportez-vous aux descriptions de la configuration de placement et des domaines de pannes au début de cette section.

      • Equilibreurs de charge : cochez la case Attacher des équilibreurs de charge pour spécifier l'équilibrage de charge pour ce pool. Pour plus d'informations sur l'équilibrage de charge, reportez-vous à Load Balancer as a Service. Entrez les informations suivantes :

        • Sélectionnez l'équilibreur de charge à attacher à ce pool.

        • Sélectionnez l'ensemble de back-ends auquel ajouter ces instances de pool.

        • Entrez le numéro de port sur les instances vers lequel l'équilibreur de charge doit diriger le trafic.

        • Sélectionnez la VNIC à utiliser lors de l'ajout de l'instance à l'ensemble de back-ends. L'adresse IP privée est utilisée.

        Pour attacher un autre équilibreur de charge, sélectionnez Ajouter un équilibreur de charge. Pour attacher un équilibreur de charge après la création du pool d'instances, reportez-vous à Gestion des attachements d'équilibreur de charge de pool d'instances.

      • Balisage : (facultatif) ajoutez des balises à cette ressource. Les balises peuvent également être appliquées ultérieurement. Pour plus d'informations sur les ressources de balisage, reportez-vous à Balises de ressource.

    7. Sélectionnez Créer un pool d'instance.

      La page de détails du nouveau pool est affichée. Les instances demandées sont répertoriées dans la table Instances attachées de la section Ressources lors de leur création. Les nouvelles instances sont nommées inst-aaaaa-pool_name, où aaaaa contient cinq caractères alphanumériques aléatoires. Si vous modifiez le nom du pool, puis ajoutez de nouvelles instances au pool, les nouvelles instances portent le nouveau nom.

      Sélectionnez Demandes de travail dans la case Ressources pour vérifier le statut de la création du pool d'instances.

  • Utilisez la commande oci compute-management instance-pool create et les paramètres requis pour créer un pool d'instances.

    oci compute-management instance-pool create --compartment-id <compartment_OCID> --instance-configuration-id <instance-configuration_OCID> --placement-configurations <placement_configurations.json> [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. Obtenez les informations suivantes :

      • OCID du compartiment dans lequel créer la définition de pool d'instances : oci iam compartment list

        Les instances du pool sont créées dans le compartiment indiqué dans la configuration d'instance.

      • OCID de la configuration d'instance à utiliser : oci compute-management instance-configuration list

      • Taille du pool d'instances. Il s'agit du nombre d'instances de calcul dans le pool.

      • Si vous souhaitez équilibrer la charge de ce pool, obtenez les informations suivantes :

        • OCID de l'équilibreur de charge à attacher à ce pool et nom de l'ensemble de back-ends auquel ajouter les instances de pool suivantes : oci lb load-balancer list

        • Valeur de port à utiliser lors de la création de l'ensemble de back-ends.

        • Carte d'interface réseau virtuelle à associer à l'équilibreur de charge. La valeur peut être PrimaryVnic ou le nom d'affichage de l'une des cartes d'interface réseau virtuelles secondaires sur la configuration d'instance associée au pool d'instances.

    2. Créez un argument pour l'option --placement-configurations.

      Reportez-vous aux descriptions des domaines de configuration de positionnement et de pannes au début de cette section.

      Utilisez la commande suivante pour afficher le contenu de l'argument de configurations de placement :

      $ oci compute-management instance-pool create --generate-param-json-input placement-configurations

    3. Si vous souhaitez équilibrer la charge de ce pool, créez un argument pour l'option --load-balancers.

      Utilisez la commande suivante pour afficher le contenu de l'argument des équilibreurs de charge :

      $ oci compute-management instance-pool create --generate-param-json-input load-balancers

      Pour attacher un équilibreur de charge après la création du pool d'instances, reportez-vous à Gestion des attachements d'équilibreur de charge de pool d'instances.

    4. Exécutez la commande de création de pool d'instances.

      Syntaxe :

      oci compute-management instance-pool create -c compartment_OCID --instance-configuration-id instance_configuration_OCID --placement-configurations file://placement_configuration.json --size number_of_instances

      Exemple :

      $ oci compute-management instance-pool create --compartment-id ocid1.compartment.unique_ID --display-name support-pool --instance-configuration-id ocid1.instanceConfiguration.unique_ID --placement-configurations file://./placement_configurations.json --load-balancers file://./load_balancers.json --size 10

      La valeur de l'option --display-name est le nom du pool. Le nom du pool ne doit pas obligatoirement être unique. Si vous n'indiquez pas de valeur pour l'option --display-name, le nom par défaut du pool d'instances est instancepoolYYYYMMDDhhmmss, où YYYYMMDDhhmmss est la date et l'heure de création.

      Le nom du pool est utilisé dans les noms des instances. Les instances d'un pool sont nommées inst-aaaaa-pool_name, où aaaaa contient cinq caractères alphanumériques aléatoires. Si vous modifiez le nom du pool, puis ajoutez de nouvelles instances au pool, les nouvelles instances auront le nouveau nom.

      La sortie de cette commande est identique à la sortie de la commande instance-pool get. La liste des instances du pool n'est pas affichée.

      Pour répertorier les instances qui appartiennent à ce pool, utilisez la commande suivante :

      $ oci compute-management instance-pool list-instances -c <compartment_OCID> --instance-pool-id <instance_pool_OCID>

      La sortie de chaque instance est abrégée par rapport à la sortie de la commande instance get.

      La commande suivante affiche la même sortie abrégée pour l'instance indiquée uniquement :

      $ oci compute-management instance-pool-instance get --instance-id ocid1.instance.unique_ID \
--instance-pool-id ocid1.instancePool.unique_ID

  • Utilisez l'opération CreateInstancePool pour créer un pool d'instances.

    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.