Documentation sur Oracle Cloud Infrastructure

Création d'une configuration d'instance en entrant des valeurs de configuration

Sur Compute Cloud@Customer, vous pouvez créer une configuration d'instance en entrant des valeurs pour les paramètres de configuration d'instance individuels.

Note

Si vous spécifiez une taille de volume de démarrage supérieure à la taille par défaut, vous devez étendre le volume pour tirer parti de la plus grande taille. Voir Redimensionnement des volumes.

Évitez d'entrer des informations confidentielles dans les noms et les balises.

Informations importantes sur l'utilisation d'images du marché des applications pour créer des instances

La première fois que vous créez une instance à l'aide d'une image Marketplace, vous devez utiliser la console Compute Cloud@Customer afin de pouvoir accepter le contrat d'utilisateur. Ensuite, vous pouvez utiliser la console, l'interface de ligne de commande et l'API pour créer des instances avec une image Marketplace.

Pour maintenir l'intégrité des images de Marketplace, il existe des restrictions et des actions autorisées. Pour plus d'informations, voir Restrictions relatives aux images du marché des applications et Administration autorisée des images du marché des applications.

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

    2. Sélectionnez Créer une configuration d'instance.

    3. Dans la boîte de dialogue Créer une configuration d'instance, entrez les informations suivantes :

      • Nom : Entrez un nom pour la configuration d'instance.

      • Créer dans le compartiment : Sélectionnez le compartiment dans lequel créer cette configuration d'instance.

      • Compartiment dans lequel créer des instances : Sélectionnez le compartiment dans lequel créer les instances.

      • Domaine d'erreur : (Facultatif) Vous pouvez sélectionner un domaine d'erreur. Par défaut, le système sélectionne automatiquement le meilleur domaine d'erreur pour les instances. Si vous spécifiez un domaine d'erreur et que le domaine d'erreur demandé ne peut pas prendre en charge l'instance, le lancement de l'instance échoue. Pour plus d'informations sur les domaines d'erreur, voir Création d'une instance.

      • Image source : Sélectionnez une image ou un volume de démarrage.

        1. Sélectionnez le type de source :

          • Image de plate-forme : Sélectionnez cette option pour créer une instance basée sur l'une des images Oracle Linux et Oracle Solaris disponibles dans chaque compartiment. Voir Images de plate-forme Compute Cloud@Customer.
          • Image personnalisée : sélectionnable si une image personnalisée a été créée. Vous devrez peut-être sélectionner le compartiment dans lequel se trouve l'image personnalisée. Voir Gestion des images personnalisées.
          • Volume de démarrage : Sélectionnez cette option pour créer l'instance en fonction d'un volume de démarrage existant. Vous devrez peut-être sélectionner le compartiment dans lequel se trouve le volume de démarrage.
          • Image Marketplace : Sélectionnable si les images Marketplace sont disponibles sur Compute Cloud@Customer. Voir Images Marketplace.

        2. Sélectionnez une image ou un volume de démarrage dans la liste.

          Si vous avez sélectionné Image de plate-forme, vous voyez une liste tabulaire avec les colonnes Système d'exploitation, Version du système d'exploitation et Création d'image (date de création de l'image). Vous pouvez utiliser la flèche du menu déroulant à droite de la version du système d'exploitation pour sélectionner une autre version. Par exemple, pour le système d'exploitation Oracle Linux, vous pouvez utiliser le menu déroulant pour sélectionner 9, 8 ou 7.9.

          Si vous avez sélectionné Image personnalisée, vous voyez une liste tabulaire avec les colonnes Nom, Système d'exploitation et Version de système d'exploitation. Vous pouvez utiliser les flèches dans les en-têtes de colonne pour trier la liste. Vous pouvez filtrer la liste à l'aide du menu déroulant Système d'exploitation au-dessus de la liste des images.

          Si vous avez sélectionné Volume de démarrage, vous voyez une liste tabulaire avec les colonnes Nom, Taille (Go) et Créé (date de création du volume de démarrage). Vous pouvez utiliser les flèches dans les en-têtes de colonne pour trier la liste. Dans la section Volume de démarrage (après la section Forme), vous pouvez personnaliser la taille du volume de démarrage.

          Si la liste est trop longue pour tenir dans une vue, utilisez les boutons fléchés pour afficher une autre page de la liste.

          Pour utiliser une image de plate-forme qui était précédemment disponible mais qui n'est plus répertoriée, utilisez la console pour créer l'instance et spécifier l'OCID de l'image.

          Si vous avez sélectionné une image Marketplace, sélectionnez une image Marketplace. Si c'est la première fois que vous créez une instance avec cette image du marché des applications, un panneau des ententes s'affiche. Avant de créer l'instance, vous devez sélectionner Accepter l'entente et confirmer l'entente.

      • Forme : Si vous utilisez une image de plate-forme, sélectionnez VM.PCAStandard.E5. Forme flexible et configurer le nombre d'OCPU et de mémoire.

        Pour les valeurs OCPU et mémoire, sélectionnez une valeur dans chaque champ de valeur pour voir les valeurs minimale et maximale permise. La configuration d'OCPU et de mémoire peut être modifiée après la création de l'instance.

        Pour obtenir une description de la forme prise en charge, voir Formes de calcul.

      • Volume de démarrage : (Facultatif) Cochez cette case pour spécifier une taille de volume de démarrage ou un paramètre de performance de volume personnalisé.

        • Taille du volume de démarrage (Go) : La taille du volume de démarrage par défaut pour l'image sélectionnée est affichée. Pour spécifier une taille supérieure, entrez un nombre entier de gigaoctets jusqu'à 16384 (16 To) ou utilisez les flèches d'incrément et de décrémentation. Vous ne pouvez pas entrer une valeur inférieure à la taille par défaut.

          Si vous spécifiez une taille de volume de démarrage personnalisée, vous devez étendre la partition pour tirer parti de la taille supérieure. Les images de plate-forme Oracle Linux incluent l'ensemble oci-utils. Utilisez la commande oci-growfs de cet ensemble pour étendre la partition racine, puis agrandir le système de fichiers. Pour les autres systèmes d'exploitation ou pour les images personnalisées, suivez les instructions correspondantes.

        • Performance du volume de démarrage (VPU) : Utilisez les flèches d'incrément et de décrémentation pour basculer entre la performance équilibrée (10 UPV/Go) et la haute performance (20 UPV/Go).

      • Sous-réseau : Sélectionnez un sous-réseau.

        1. Sélectionnez un réseau VCN dans la liste. Vous devrez peut-être remplacer le compartiment par le compartiment où se trouve le VCN.

        2. Sélectionner un sous-réseau.

      • Adresse IP publique : Pour utiliser SSH pour vous connecter aux instances créées avec cette configuration d'instance, cochez la case Affecter une adresse IP publique afin qu'une adresse IP publique soit affectée aux instances. Cette case est cochée par défaut si vous avez spécifié un sous-réseau public. Si vous ne cochez pas cette case ou si vous désélectionnez cette case, puis souhaitez affecter une adresse IP publique plus tard, voir Affectation d'une adresse IP publique éphémère à une instance pour obtenir des instructions.

      • Cartes VNIC secondaires : (Facultatif) Cochez la case Créer une carte VNIC supplémentaire pour créer des cartes VNIC secondaires pour les instances créées avec cette configuration d'instance. Pour obtenir les descriptions des informations demandées, voir Création et attachement d'une carte VNIC secondaire.

      • adresse IP privée : (Facultatif) Spécifiez une adresse IP privée disponible dans le CIDR du sous-réseau. Par défaut, une adresse IP privée est automatiquement affectée.

        Note

        Comme l'adresse IP privée doit être unique pour chaque instance, ne spécifiez pas d'adresse IP privée si vous allez utiliser cette configuration d'instance pour créer un groupe d'instances.

      • Enregistrement DNS : (Facultatif) Cochez la case Affecter un enregistrement DNS privé pour affecter un enregistrement DNS aux instances créées avec cette configuration d'instance.

      • Nom d'hôte : (Facultatif) Entrez un nom d'hôte si vous utilisez le DNS dans le réseau en nuage. Le nom d'hôte doit être unique pour toutes les cartes vNIC du sous-réseau.

        Note

        Ne spécifiez pas de nom d'hôte si vous allez utiliser cette configuration d'instance pour créer un groupe d'instances.

        Par défaut, le nom d'instance est utilisé pour le nom d'hôte. Le nom d'hôte peut également être configuré dans le système d'exploitation après la création de l'instance.

        S'il s'agit d'une instance UNIX, voir Création d'une cible de montage et Montage de systèmes de fichiers sur des instances UNIX pour plus d'informations sur la définition correcte du nom d'hôte pour le montage de systèmes de fichiers.

      • Clés SSH : Pour vous connecter à l'instance à l'aide de SSH, fournissez une clé SSH publique.

        Note

        Vous ne pouvez pas fournir cette clé SSH après la création de l'instance.

      • Groupe de sécurité de réseau : (Facultatif) Par défaut, les instances ne sont attachées à aucun groupe de sécurité de réseau. Cochez la case Activer le groupe de sécurité de réseau pour ajouter la carte VNIC principale de cette instance à un ou plusieurs groupes de sécurité de réseau.

        1. Sélectionnez un groupe de sécurité de réseau dans la liste déroulante. Vous devrez peut-être modifier le compartiment pour trouver le groupe de sécurité de réseau souhaité.

        2. Sélectionnez Ajouter un groupe de sécurité de réseau à attacher à un autre groupe de sécurité de réseau.

        3. Pour supprimer un groupe de sécurité de réseau de la liste, sélectionnez la corbeille à droite de ce groupe. Pour supprimer le dernier groupe de sécurité de réseau ou tous les groupes, désélectionnez la case Activer les groupes de sécurité de réseau.

        Voir Contrôle du trafic avec les groupes de sécurité de réseau pour plus d'informations sur les groupes de sécurité de réseau.

      • Options d'instance : Cochez cette case pour désactiver les points d'extrémité du service de métadonnées d'instance existante. Par défaut, les routes existantes (/v1) du service de métadonnées d'instance (IMDS) sont activées. Si vous avez mis à niveau vos applications pour utiliser des points d'extrémité /v2, cochez cette case pour désactiver les points d'extrémité /v1. Pour plus d'informations sur le service de métadonnées d'instance, voir Extraction des métadonnées d'instance à partir de l'instance. Pour plus d'informations sur la mise à niveau de vos applications, voir Mise à niveau vers des points d'extrémité IMDS version 2.

      • Configuration de la disponibilité : (Facultatif) Par défaut, le système sélectionne automatiquement la meilleure option de disponibilité d'instance lors d'une opération de maintenance telle que la migration en direct. Cochez la case Restaurer l'état du cycle de vie de l'instance après la maintenance de l'infrastructure pour spécifier que les instances en cours d'exécution doivent être redémarrées automatiquement après un événement de maintenance. Si cette case n'est pas cochée, l'instance est récupérée à l'état arrêté.

      • 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.

    4. Sélectionnez Créer une configuration d'instance.

  • Utilisez la commande oci compute-management instance-configuration create et les paramètres requis pour créer une configuration d'instance en entrant des valeurs de configuration.

    oci compute-management instance-configuration create -c <compartment_OCID> --display-name <IC_name> --instance-details file://<custom_config_file>.json

    Le compartiment spécifié est l'endroit où cette configuration d'instance est créée. Ce compartiment peut être différent du compartiment spécifié dans le fichier JSON des détails de l'instance, où les instances seront créées.

    Le nom d'affichage spécifié est le nom de la configuration d'instance. Si vous ne fournissez pas de valeur pour l'option --display-name, le nom par défaut de la configuration d'instance est instanceconfiguration YYYYMMDDhhmmss , où YYYYMMDDhhmmss est la date et l'heure de création.

    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 :

      • L'OCID du compartiment dans lequel vous voulez créer cette configuration d'instance.

      • OCID du compartiment dans lequel vous voulez créer les instances qui utilisent cette configuration d'instance.

      • Nom du domaine de disponibilité pour les instances qui utilisent cette configuration d'instance.

      • OCID de l'image ou du volume de démarrage pour les instances qui utilisent cette configuration d'instance.

      • Nom de la forme pour les instances qui utilisent cette configuration d'instance.

      • OCID du sous-réseau pour les instances qui utilisent cette configuration d'instance.

    2. Créez le fichier de configuration qui fournit l'entrée à la commande de création de configuration.

      Le fichier de configuration est un fichier JSON de paires propriété/valeur.

      • Utilisez la commande suivante pour générer la syntaxe correcte du fichier de configuration et les noms des propriétés :

        $ oci compute-management instance-configuration create --generate-param-json-input instance-details > instance_details.json

        Vous n'avez pas besoin de toutes les données générées par cette commande. Copiez uniquement les informations dont vous avez besoin, en veillant à garder chaque propriété dans son contexte correct.

        Si vous omettez la spécification du domaine d'erreur, le système sélectionne automatiquement le meilleur domaine d'erreur. Si vous spécifiez un seul domaine d'erreur, toutes les instances sont placées dans ce seul domaine d'erreur.

        Si un domaine d'erreur que vous spécifiez ne dispose pas de ressources suffisantes, le lancement des instances peut échouer :

        • Lorsque vous créez une instance unique (Utilisation d'une configuration d'instance pour créer une instance) et que vous spécifiez un domaine d'erreur dans la configuration d'instance, seul ce domaine d'erreur spécifié est utilisé pour créer l'instance. Les contraintes de ressource peuvent entraîner l'échec du lancement de l'instance.

        • Lorsque vous créez des instances dans un groupe, les domaines d'erreur spécifiés dans la configuration de positionnement remplacent les domaines d'erreur spécifiés dans la configuration d'instance. Voir Création d'un groupe d'instances pour plus d'informations.

        Vous pouvez spécifier des cartes vNIC et des sous-réseaux secondaires. Si vous spécifiez une étiquette de nom d'hôte pour une carte VNIC secondaire, l'étiquette de nom d'hôte spécifiée doit être unique pour toutes les cartes VNIC du sous-réseau. Si vous fournissez une valeur pour la propriété hostnameLabel, vous devez également régler la valeur de assignPrivateDnsRecord à true.

        • Si l'étiquette de nom d'hôte spécifiée est déjà utilisée dans le sous-réseau, le lancement de l'instance (Utilisation d'une configuration d'instance pour créer une instance) échoue avec l'erreur "Nom d'hôte hostname déjà utilisé pour le sous-réseau".

        • La propriété hostnameLabel est ignorée lorsque vous utilisez la configuration d'instance pour créer un groupe d'instances. Par défaut, le nom d'instance est utilisé pour le nom d'hôte.

        Si vous omettez la propriété assignPublicIp, une adresse IP publique est affectée par défaut si vous spécifiez un sous-réseau public. Si vous réglez cette propriété à false, puis décidez d'affecter une adresse IP publique plus tard, voir Affectation d'une adresse IP publique éphémère à une instance pour obtenir des instructions.

        Si les utilisateurs utilisent ssh pour se connecter à l'instance, spécifiez la clé publique SSH comme valeur de la propriété ssh_authorized_keys dans le bloc metadata. Vous ne pouvez pas ajouter la clé publique SSH après la création de l'instance.

        La propriété displayName est utilisée pour le nom de l'instance lorsque vous utilisez la commande launch-compute-instance, comme décrit sous Utilisation d'une configuration d'instance pour créer une instance. Si vous ne fournissez pas de valeur pour la propriété displayName, le nom par défaut des instances est instance YYYYMMDDhhmmss , où YYYYMMDDhhmmss est la date et l'heure de création.

        La propriété displayName est ignorée lorsque vous créez des instances dans un groupe, comme décrit sous Création d'un groupe d'instances.

      • La commande suivante indique les propriétés requises pour créer une instance :

        $ oci compute instance launch -h

        Faites défiler l'affichage jusqu'à la section Required Parameters (Paramètres requis). Les paramètres facultatifs sont décrits ci-dessous.

      Les noms des propriétés dans le fichier de configuration sont similaires, mais différents, des noms des options instance launch. De plus, certaines propriétés sont organisées en groupes de propriétés, tels que createVnicDetails, shapeConfig et sourceDetails, comme illustré dans l'exemple de fichier de configuration suivant :

      {
  "instanceType": "compute",
  "launchDetails": {
    "availabilityDomain": "AD-1",
    "compartmentId": "compartment_OCID",
    "createVnicDetails": {
      "assignPublicIp": true,
      "freeformTags": {
        "ConfigType": "Configuration for an XYZ instance."
      },
      "subnetId": "subnet_OCID"
    },
    "displayName": "instance_name",
    "instanceOptions": {
      "areLegacyImdsEndpointsDisabled": true
    },
    "metadata": {
      "ssh_authorized_keys": "public_SSH_key"
    },
    "shape": "shape_name",
    "shapeConfig": {
      "memoryInGBs": 512,
      "ocpus": 32
    },
    "sourceDetails": {
      "bootVolumeSizeInGBs": 100,
      "bootVolumeVpusPerGB": 20,
      "imageId": "image_OCID",
      "sourceType": "image"
    }
  }
}

      Utilisez instanceOptions si vous devez désactiver les points d'extrémité IMDSv1 pour cette instance. Voir Extraction des métadonnées d'instance.

      Spécifiez la forme flexible, VM.PCAStandard.E5.Flex, et spécifiez également la configuration de la forme. Vous devez fournir une valeur pour ocpus. La propriété memoryInGBs est facultative; la valeur par défaut en gigaoctets est 16 fois le nombre de ocpus.

      Pour plus d'informations sur bootVolumeSizeInGBs, voir "Taille du volume de démarrage" dans l'onglet Création d'une configuration d'instance à partir d'une instance de l'interface de ligne de commande.

      Pour plus d'informations sur bootVolumeVpusPerGB, voir "Haute performance" dans l'onglet Création d'une configuration d'instance de l'interface de ligne de commande d'une instance. Lorsque des instances sont lancées, la valeur de bootVolumeVpusPerGB est null car cette propriété de volume de démarrage n'est pas stockée dans l'objet d'instance après le lancement de l'instance. Pour vérifier la valeur, utilisez la commande get boot volume et consultez la valeur de vpus-per-gb.

      Pour modifier la valeur de la propriété firmware, fournissez une valeur pour la propriété launchOptions. La valeur par défaut est BIOS. Vous pouvez également spécifier UEFI_64. Les autres propriétés dans launchOptions ne peuvent pas être modifiées.

      "launchOptions": {
  "bootVolumeType": "PARAVIRTUALIZED",
  "firmware": "UEFI_64",
  "isConsistentVolumeNamingEnabled": false,
  "isPvEncryptionInTransitEnabled": false,
  "networkType": "PARAVIRTUALIZED",
  "remoteDataVolumeType": "PARAVIRTUALIZED"
}

    3. Exécutez la commande de création de la configuration d'instance.

      Syntaxe :

      oci compute-management instance-configuration create -c <compartment_OCID> --display-name <IC_name> --instance-details file://<custom_config_file>.json

      Le compartiment spécifié est l'endroit où cette configuration d'instance est créée. Ce compartiment peut être différent du compartiment spécifié dans le fichier JSON des détails de l'instance, où les instances seront créées.

      Le nom d'affichage spécifié est le nom de la configuration d'instance. Si vous ne fournissez pas de valeur pour l'option --display-name, le nom par défaut de la configuration d'instance est instanceconfiguration YYYYMMDDhhmmss , où YYYYMMDDhhmmss est la date et l'heure de création.

      La sortie de cette commande est la même que celle de la commande instance-configuration get.

  • Utilisez l'opération CreateInstanceConfiguration pour créer une configuration d'instance en entrant des valeurs de configuration.

    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.