Documentation sur Oracle Cloud Infrastructure

Création d'un groupe d'instances

Sur Compute Cloud@Customer, vous pouvez créer un groupe 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 groupe effectue cette opération sur toutes les instances qui sont membres du groupe. L'exécution de ces opérations sur une instance individuelle qui est membre du groupe n'a aucune incidence sur les autres instances de membre.

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

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

Configuration de positionnement

En plus d'une configuration d'instance, la création du groupe nécessite une configuration de positionnement. Les valeurs spécifiées dans une configuration de positionnement remplacent les valeurs spécifiées dans la configuration d'instance.

Une configuration de positionnement peut spécifier les domaines d'erreur, le sous-réseau principal et les sous-réseaux de carte VNIC secondaires.

Domaines d'erreur

Si vous n'indiquez aucun domaine d'erreur dans la configuration d'instance ou dans la configuration de positionnement, le système sélectionne automatiquement les meilleurs domaines d'erreur pour les instances de groupe. Si vous spécifiez un seul domaine d'erreur, toutes les instances seront placées uniquement dans ce domaine d'erreur. Si vous spécifiez plusieurs domaines d'erreur, les instances de groupe sont placées uniformément dans ces domaines d'erreur, ce qui assure une meilleure haute disponibilité pour le groupe. Si un domaine d'erreur ne peut pas prendre en charge des instances supplémentaires, la création d'instance s'arrête. Le système ne placera pas plus d'instances dans un domaine d'erreur que dans un autre domaine d'erreur.

Si certaines instances ne peuvent pas être lancées en raison de contraintes de ressources, elles restent à l'état Provisionnement et le groupe reste à l'état Ajustement. Une fois les instances size lancées, le groupe peut passer à l'état En cours d'exécution. Pendant que le pool est à l'état Scaling, les instances de pool qui sont à l'état Running sont disponibles pour utilisation.

Voici des exemples d'actions que vous pouvez effectuer si le lancement d'une instance de groupe échoue en raison de contraintes de ressources :

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

  • Mettez à jour le groupe et modifiez la spécification du domaine d'erreur dans la console ou dans une nouvelle instance ou configuration de positionnement.

  • Mettez à jour le groupe pour spécifier 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 groupe dans le même domaine d'erreur où le lancement de l'instance de groupe échoue en raison de contraintes de ressources.

  • Supprimez une instance qui n'est pas membre d'un groupe dans le même domaine d'erreur où le lancement de l'instance de groupe échoue en raison de contraintes de ressources.

Conditions requises :

Pour pouvoir créer un groupe 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 des instances. Voir Utilisation de configurations d'instance.

Évitez d'entrer 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 qui contient la configuration d'instance à utiliser pour créer le groupe.

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

    4. Sous Ressources, sélectionnez Groupes d'instances attachés.
    5. En haut de la page, sélectionnez d'autres compartiments pour lister les groupes d'autres compartiments.

      Sélectionnez Créer un groupe d'instances.

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

      • Nom : Entrez le nom du groupe 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 groupe, le nom par défaut du groupe 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 groupe d'instances. Notez que les instances du groupe seront créées dans le compartiment spécifié dans la configuration d'instance.

      • Nombre d'instances : Spécifiez le nombre d'instances à créer dans ce groupe d'instances.

      • Positionnement du groupe : Sélectionnez les domaines d'erreur, le VCN et le sous-réseau pour les instances de ce groupe d'instances. Vous pouvez sélectionner un autre compartiment à partir duquel choisir le VCN et le sous-réseau. Reportez-vous aux descriptions de Placement Configuration et Fault Domains au début de cette section.

      • Équilibreurs de charge : Sélectionnez la case Attacher des équilibreurs de charge pour spécifier l'équilibrage de charge pour ce groupe. Pour plus d'informations sur l'équilibrage de charge, voir Équilibreur de charge en tant que service. Entrez les informations suivantes :

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

        • Sélectionnez le jeu dorsal auquel ajouter ces instances de groupe.

        • Entrez le numéro de port des instances vers lesquelles l'équilibreur de charge doit acheminer le trafic.

        • Sélectionnez la carte VNIC à utiliser lors de l'ajout de l'instance au jeu dorsal. 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 une fois le groupe d'instances créé, voir Gestion des attachements d'équilibreur de charge de groupe d'instances.

      • Marquage : (Facultatif) Ajoutez un ou plusieurs marqueurs à cette ressource. Les marqueurs peuvent également être appliqués ultérieurement. Pour plus d'informations sur le marquage des ressources, voir Ajout de marqueurs à la création de ressources (IAM dans OCI).

    7. Sélectionnez Créer un groupe d'instances.

      La page des détails du nouveau groupe s'affiche. Les instances demandées sont listées dans la table Instances attachées de la section Ressources à mesure qu'elles sont créées. 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 groupe, puis ajoutez de nouvelles instances au groupe, 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 groupe d'instances.

  • Utilisez la commande oci compute-management instance-pool create et les paramètres requis pour créer un groupe 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 la liste complète des commandes, indicateurs et options de l'interface de ligne de commande, voir Référence de ligne de commande.

    Procédure

    1. Obtenez les informations suivantes :

      • OCID du compartiment dans lequel vous voulez créer la définition du groupe d'instances : oci iam compartment list

        Notez que les instances du groupe sont créées dans le compartiment spécifié dans la configuration d'instance.

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

      • Taille du groupe d'instances. Il s'agit du nombre d'instances de calcul du groupe d'instances.

      • Si vous voulez équilibrer la charge pour ce groupe, obtenez les informations suivantes :

        • OCID de l'équilibreur de charge à attacher à ce groupe et nom du jeu dorsal auquel ajouter ces instances de groupe : oci lb load-balancer list

        • Valeur de port à utiliser lors de la création du jeu dorsal.

        • Carte VNIC à associer à l'équilibreur de charge. La valeur peut être PrimaryVnic ou le nom d'affichage de l'une des cartes vNIC secondaires de la configuration d'instance associée au groupe d'instances.

    2. Construisez un argument pour l'option --placement-configurations.

      Reportez-vous aux descriptions de Placement Configuration et Fault Domains au début de cette section.

      Utilisez la commande suivante pour afficher le contenu de l'argument de configuration de positionnement :

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

    3. Si vous voulez équilibrer la charge pour ce groupe, 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 une fois le groupe d'instances créé, voir Gestion des attachements d'équilibreur de charge de groupe d'instances.

    4. Exécutez la commande de création de groupe 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 groupe. Le nom du groupe n'est pas obligatoirement unique. Si vous ne fournissez pas de valeur pour l'option --display-name, le nom par défaut du groupe d'instances est instancepoolYYYYMMDDhhmmss, où YYYYMMDDhhmmss est la date et l'heure de création.

      Le nom du groupe est utilisé dans les noms des instances. Les instances d'un groupe sont nommées inst-aaaaa-pool_name, où aaaaa contient cinq caractères alphanumériques aléatoires. Si vous modifiez le nom du groupe, puis ajoutez de nouvelles instances au groupe, 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 groupe n'est pas affichée.

      Pour lister les instances appartenant à ce groupe, 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 spécifié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 groupe d'instances.

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