Documentation sur Oracle Cloud Infrastructure

Création d'un groupe d'instances

Sur Compute Cloud@Customer, vous pouvez créer un groupe d'instances 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 membres.

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 différentes configurations d'instance et de positionnement.

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 correspond à cinq caractères alphanumériques aléatoires.

Configuration de positionnement

En plus d'une configuration d'instance, la création d'un 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 des domaines d'erreur, un sous-réseau principal et des sous-réseaux de carte VNIC secondaires.

Domaines d'erreur

Si vous ne spécifiez pas de domaine d'erreur dans la configuration d'instance ou 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 dans ce seul domaine d'erreur. Si vous spécifiez plusieurs domaines d'erreur, les instances de groupe sont placées dans ces domaines d'erreur de manière uniforme, 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 de l'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, ces instances 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. Tant que le groupe est à l'état Ajustement, les instances du groupe qui sont à l'état En cours d'exécution 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 le nombre d'instances ou la valeur size.

  • Mettez à jour le groupe et modifiez la spécification du domaine d'erreur dans la console Compute Cloud@Customer ou dans une nouvelle configuration d'instance ou 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 que celui 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 que celui où le lancement de l'instance de groupe échoue en raison de contraintes de ressources.

Préalable

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 le 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 ne fournissez 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.

      • Placement de 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 dans lequel choisir le VCN et le sous-réseau. Consultez les descriptions de la configuration de positionnement et des domaines d'erreur 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 Marqueurs de ressource.

    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 le tableau Instances attachées de la section Ressources au fur et à mesure 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 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 Informations de référence sur la ligne de commande.

    Procédure

    1. Obtenez les informations suivantes :

      • OCID du compartiment dans lequel 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. Nombre d'instances de calcul dans le groupe d'instances.

      • Si vous souhaitez é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 les instances de groupe suivantes : 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 d'une des cartes vNIC secondaires dans la configuration d'instance associée au groupe d'instances.

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

      Consultez les descriptions de la configuration de positionnement et des domaines d'erreur au début de cette section.

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

      $ 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 create du 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 obligatoire pour être 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 correspond à cinq caractères alphanumériques aléatoires. Si vous modifiez le nom du groupe, puis ajoutez de nouvelles instances au groupe, les nouvelles instances porteront le nouveau nom.

      La sortie de cette commande est la même que celle de la commande instance-pool get. La liste des instances du groupe n'est pas affichée.

      Pour lister les instances qui appartiennent à 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.