Documentation Oracle Cloud Infrastructure

Création d'une configuration d'instance en saisissant 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.

Remarque

Si vous indiquez une taille de volume d'initialisation supérieure à la taille par défaut, vous devez étendre le volume afin de tirer parti de cette plus grande taille. Reportez-vous à Redimensionnement des volumes.

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

Informations importantes sur l'utilisation des images Marketplace 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 d'accepter l'accord 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 préserver l'intégrité des images du Marketplace, il existe des restrictions et des actions autorisées. Pour plus d'informations, reportez-vous à Restrictions relatives aux images Marketplace et à Administration des images Marketplace autorisées.

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

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

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

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

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

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

      • Domaine de pannes : (facultatif) vous pouvez sélectionner un domaine de pannes. Par défaut, le système sélectionne automatiquement le meilleur domaine de pannes pour les instances. Si vous indiquez un domaine de pannes et que le domaine de pannes demandé ne peut pas accueillir l'instance, le lancement de l'instance échoue. Pour plus d'informations sur les domaines de pannes, reportez-vous à Création d'une instance.

      • Image source : sélectionnez une image ou un volume d'initialisation.

        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. Reportez-vous à Images de plate-forme Compute Cloud@Customer.
          • Image personnalisée : sélectionnez cette option 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. Reportez-vous à Gestion des images personnalisées.
          • Volume d'initialisation : sélectionnez cette option pour créer l'instance en fonction d'un volume d'initialisation existant. Vous devrez peut-être sélectionner le compartiment dans lequel se trouve le volume d'initialisation.
          • Image Marketplace : sélectionnez cette option si les images Marketplace sont disponibles sur Compute Cloud@Customer. Reportez-vous à Images Marketplace.

        2. Sélectionnez une image ou un volume d'initialisation dans la liste.

          Si vous avez sélectionné Image de plate-forme, une liste tabulaire contenant les colonnes Système d'exploitation, Version de système d'exploitation et Création d'image apparaît (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, une liste tabulaire contenant les colonnes Nom, Système d'exploitation et Version du système d'exploitation s'affiche. 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 situé au-dessus de la liste des images.

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

          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 précédemment disponible mais qui n'est plus répertoriée, utilisez la console afin de créer l'instance et d'indiquer 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 Marketplace, un panneau d'accord s'affiche. Avant de créer l'instance, vous devez sélectionner Accepter l'accord et confirmer l'accord.

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

        Pour les valeurs OCPU et memory, sélectionnez les valeurs minimales et maximales autorisées dans chaque champ de valeur. 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, reportez-vous à Formes de calcul.

      • Volume d'initialisation : (facultatif) cochez la case pour indiquer un paramètre personnalisé de taille ou de performances de volume d'initialisation.

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

          Si vous indiquez une taille personnalisée, vous devez étendre la partition afin de tirer parti de cette taille. Les images de plate-forme Oracle Linux incluent le package oci-utils. Utilisez la commande oci-growfs de ce package pour étendre la partition racine, puis développer le système de fichiers. Pour les autres systèmes d'exploitation ou les images personnalisées, suivez les instructions correspondantes.

        • Performances des volumes d'initialisation (VPU) : utilisez les flèches d'incrémentation et de décrémentation pour basculer entre des performances équilibrées (10 VPU/Go) et des performances élevées (20 VPU/Go).

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

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

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

      • Adresse IP publique : pour utiliser SSH afin de se 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. Par défaut, cette case est cochée 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 que vous souhaitez affecter une adresse IP publique ultérieurement, reportez-vous à Affectation d'une adresse IP publique éphémère à une instance pour obtenir des instructions.

      • Cartes d'interface réseau virtuelles secondaires : (facultatif) cochez la case Créer une carte d'interface réseau virtuelle supplémentaire afin de créer des cartes d'interface réseau virtuelles secondaires pour les instances créées avec cette configuration d'instance. Pour obtenir la description des informations demandées, reportez-vous à Création et attachement d'une carte d'interface réseau virtuelle secondaire.

      • adresse IP privée : (facultatif) indiquez une adresse IP privée disponible provenant du CIDR de sous-réseau. Par défaut, une adresse IP privée est automatiquement affectée.

        Remarque

        Etant donné que l'adresse IP privée doit être unique pour chaque instance, n'indiquez pas d'adresse IP privée si vous comptez utiliser cette configuration d'instance pour créer un pool 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 au sein du réseau cloud. Le nom d'hôte doit être unique sur toutes les cartes d'interface réseau virtuelles du sous-réseau.

        Remarque

        N'indiquez pas de nom d'hôte si vous allez utiliser cette configuration d'instance pour créer un pool 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, reportez-vous aux sections Creating a Mount Target et Mounting File Systems on UNIX-based Instances pour plus d'informations sur la définition correcte du nom d'hôte pour le montage des systèmes de fichiers.

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

        Remarque

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

      • Groupe de sécurité réseau : (facultatif) par défaut, les instances ne sont attachées à aucun groupe de sécurité réseau. Cochez la case Activer le groupe de sécurité réseau pour ajouter la carte d'interface réseau virtuelle principale de cette instance à des groupes de sécurité réseau.

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

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

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

        Pour plus d'informations sur les groupes de sécurité réseau, reportez-vous à Contrôle du trafic avec des groupes de sécurité réseau.

      • Options d'instance : cochez la case permettant de désactiver les adresses de service de métadonnées d'instance héritées. Par défaut, les routages IMDS (Instance Metadata Service) hérités (/v1) sont activés. Si vous avez mis à niveau vos applications pour utiliser des adresses /v2, cochez cette case pour désactiver les adresses /v1. Pour plus d'informations sur le service de métadonnées d'instance, reportez-vous à Extraction des métadonnées d'instance à partir de l'instance. Pour plus d'informations sur la mise à niveau de vos applications, reportez-vous à Mise à niveau vers les adresses 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 de cycle de vie de l'instance après la maintenance d'infrastructure pour indiquer 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é.

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

    4. Sélectionnez Création d'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 saisissant 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 indiqué est l'emplacement de création de cette configuration d'instance. Ce compartiment peut être différent du compartiment indiqué dans le fichier JSON de détails de l'instance, où les instances seront créées.

    Le nom d'affichage indiqué est le nom de la configuration d'instance. Si vous n'indiquez 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 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 cette configuration d'instance.

      • OCID du compartiment dans lequel 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 d'initialisation 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 de 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 de pannes, le système sélectionne automatiquement le meilleur domaine de pannes. Si vous indiquez un seul domaine de pannes, toutes les instances sont placées dans ce domaine de pannes uniquement.

        Si un domaine de pannes que vous indiquez 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 indiquez un domaine de pannes dans la configuration d'instance, seul le domaine de pannes indiqué 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 pool, les domaines de pannes indiqués dans la configuration de placement remplacent les domaines de pannes indiqués dans la configuration d'instance. Pour plus d'informations, reportez-vous à Création d'un pool d'instances.

        Vous pouvez indiquer des cartes d'interface réseau virtuelles et des sous-réseaux secondaires. Si vous indiquez un libellé de nom d'hôte pour une carte d'interface réseau virtuelle secondaire, le libellé de nom d'hôte indiqué doit être unique sur toutes les cartes d'interface réseau virtuelles du sous-réseau. Si vous indiquez une valeur pour la propriété hostnameLabel, vous devez également définir la valeur de assignPrivateDnsRecord sur true.

        • Si le libellé de nom d'hôte indiqué est déjà utilisé dans le sous-réseau, le lancement de l'instance (Utilisation d'une configuration d'instance pour créer une instance) échouera 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 pool 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 indiquez un sous-réseau public. Si vous définissez cette propriété sur false, puis décidez d'affecter une adresse IP publique ultérieurement, reportez-vous à 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, indiquez la clé publique SSH en tant que 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 d'instance lorsque vous utilisez la commande launch-compute-instance, comme décrit dans Utilisation d'une configuration d'instance pour créer une instance. Si vous n'indiquez 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 pool, comme décrit dans Création d'un pool d'instances.

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

        $ oci compute instance launch -h

        Accédez à la section 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. En outre, certaines propriétés sont organisées en groupes de propriétés, tels que createVnicDetails, shapeConfig et sourceDetails, comme indiqué 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 adresses IMDSv1 pour cette instance. Reportez-vous à Extraction des métadonnées d'instance à partir de l'instance.

      Indiquez la forme flexible, VM.PCAStandard.E5.Flex, ainsi que 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, reportez-vous à Taille de volume d'initialisation dans l'onglet d'interface de ligne de commande Création d'une configuration d'instance à partir d'une instance.

      Pour plus d'informations sur bootVolumeVpusPerGB, reportez-vous à Hautes performances dans l'onglet d'interface de ligne de commande Création d'une configuration d'instance à partir d'une instance. Lorsque des instances sont lancées, la valeur de bootVolumeVpusPerGB est null car cette propriété de volume d'initialisation 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, indiquez une valeur pour la propriété launchOptions. La valeur par défaut est BIOS. Vous pouvez également indiquer 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 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 indiqué est l'emplacement de création de cette configuration d'instance. Ce compartiment peut être différent du compartiment indiqué dans le fichier JSON de détails de l'instance, où les instances seront créées.

      Le nom d'affichage indiqué est le nom de la configuration d'instance. Si vous n'indiquez 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 identique à la sortie de la commande instance-configuration get.

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

    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.