Création d'instances de serveur virtuel

Avant de commencer

• Téléchargez, installez et initialisez les plug-ins CLI suivants.

  • CLI IBM Cloud
  • Le plug-in infrastructure-service

  Pour plus d'informations, voir Configuration de votre environnement d'API et d'interface de ligne de commande.

• Vérifiez que vous avez créé un VPC.

Collecte d'informations pour créer une instance à partir de l'interface CLI

Vous êtes prêt à créer une instance ? Avant de pouvoir exécuter la ibmcloud is instance-create commande, vous devez connaître les détails de l'instance, tels que le profil ou l'image que vous souhaitez utiliser.

Rassemblez les informations suivantes à l'aide des commandes associées.

Utilisez les commandes suivantes afin de déterminer les informations requises pour créer une nouvelle instance.

ibmcloud is regions

$ ibmcloud is regions
Listing regions under account Test Account as user test.user@ibm.com...
Name       Endpoint                              Status
au-syd     https://au-syd.iaas.cloud.ibm.com     available
br-sao     https://br-sao.iaas.cloud.ibm.com     available
ca-tor     https://ca-tor.iaas.cloud.ibm.com     available
eu-de      https://eu-de.iaas.cloud.ibm.com      available
eu-es      https://eu-es.iaas.cloud.ibm.com      available
eu-gb      https://eu-gb.iaas.cloud.ibm.com      available
jp-osa     https://jp-osa.iaas.cloud.ibm.com     available
jp-tok     https://jp-tok.iaas.cloud.ibm.com     available
us-east    https://us-east.iaas.cloud.ibm.com    available
us-south   https://us-south.iaas.cloud.ibm.com   available

ibmcloud target -r <region-name>

ibmcloud is zones

$ ibmcloud is zones
Listing zones in target region us-south under account Test Account as user test.user@ibm.com...
Name         Region     Status
us-south-1   us-south   available
us-south-2   us-south   available
us-south-3   us-south   available

ibmcloud is vpcs

ID                                        Name       Status     Classic access   Default network ACL              Default security group        Resource group
r006-35b9cf35-616e-462e-a145-cf8db4062fcf my-vpc     available  false            immortality-casing-extoll-exit   enhance-corsage-managing-jinx Default

ibmcloud is subnets

ID                                          Name            Status      Subnet CIDR      Addresses   ACL                              Public Gateway   VPC
Zone         Resource group
0717-198db988-3b9b-4cfa-9dec-0206420d37d0   my-subnet       available   10.240.64.0/28   7/16        immortality-casing-extoll-exit   -               my-vpc
us-south-2   Default

ibmcloud is images

ID                                          Name                               Status       Arch    OS name                   OS version       File size(GB)
Visibility   Encryption   Resource group   Catalog Offering User Data Format   Remote Account ID
r006-24d856e2-6aec-41c2-8f36-5a8a3766f0d6   my-test-image                      available    amd64   centos-7-amd64            7.x - Minimal Install  1             private      none         Default          -                cloud_init
r006-9768bb7f-c75d-4408-ba34-61015632f907   ibm-debian-10-13-minimal-amd64-2   available    amd64   debian-10-amd64           10.x Buster/Stable     1             public       none         Default          -                cloud_init       811f8abfbd32425597dc7ba40da98fa6
r006-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4    available    amd64   debian-11-amd64           11.x Bullseye/Stable   1             public       none         Default          -                cloud_init       811f8abfbd32425597dc7ba40da98fa6

  Save the `offering_crn` and `offering_version_crn`in variables, which are used later to provision an instance.

  ```sh {: pre}
   offering_crn="crn:v1:bluemix:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d"
   offering_version_crn="crn:v1:bluemix:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:version:136559f6-4588-4af2-8585-f3c625eee09d/8ae92879-e253-4a7c-b09f-8d30af12e518"
   ```

ibmcloud is volumes --attachment-state unattached --operating-system-architecture amd64 --zone us-south-1

ibmcloud is instance-profiles

Name                         vCPU Manufacturer   Architecture   Family              vCPUs   Memory(GiB)   Bandwidth(Mbps)   Volume bandwidth(Mbps)   GPUs          Storage(GB)   Min NIC Count   Max NIC Count
bx2-2x8                      intel               amd64          balanced            2       8             4000              1000                     -      -                    1               5
bx2a-2x8                     amd                 amd64          balanced            2       8             2000              500                      -      -                    1               5
bx2d-2x8                     intel               amd64          balanced            2       8             4000              1000                     -            1x75          1               5
bx2-4x16                     intel               amd64          balanced            4       16            8000              2000                     -      -                    1               5
bx2a-4x16                    amd                 amd64          balanced            4       16            4000              1000                     -      -                    1               5
bx2d-4x16                    intel               amd64          balanced            4       16            8000              2000                     -            1x150         1               5

FAILED
Response HTTP Status Code: 400
Error code: bad_field
Error message: Image OS IBM Hyper Protect is not supported by the instance profile <profile_name>
Error target name: profile, type: field

ibmcloud is keys

ID                                          Name     Type   Length   FingerPrint          Resource group
r006-89ec781c-9630-4f76-b9c4-a7d204828d61   my-key   rsa    4096     gtnf+pdX2PYI9Ofq..   Default

ibmcloud is placement-groups

ID                                            Name                             State    Strategy       Resource Group
c5f1f366-b92a-4080-991a-aa5c2e33d96b          placement-group-region-us-south   stable   power_spread  Default

Création d'une instance à partir de l'interface CLI

Utilisez les informations suivantes pour créer une instance à l'aide de la CLI.

Fourniture à partir d'une image stockée ou personnalisée

Une fois que vous connaissez les valeurs requises, utilisez-les pour exécuter la ibmcloud is instance-create commande. Vous devez également indiquer un nom unique pour l'instance.

Suivez les étapes suivantes pour créer une instance de serveur virtuel de base à partir d'une image stockée dans l'interface CLI. Par défaut, un volume de démarrage est attaché à l'instance lors de sa création. Pour la plupart des instances de serveurs virtuels, la taille du volume de démarrage par défaut est de 100 Go. La taille du volume de démarrage par défaut pour une instance de serveur virtuel z/OS est de 250 Go.

1. Créez une instance à l'aide de la commande suivante.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --keys KEYS \
   

   Par exemple, la commande instance-create suivante utilise les valeurs d'exemple qui se trouvent dans la section Collecte d'informations.

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \
   

   Les valeurs d'argument et d'option suivantes sont utilisées

   • INSTANCE_NAME : my-instance
   • VPC : r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • ZONE_NAME : us-south-2
   • NOM_PROFILE : bx2-2x8
   • SUBNET : 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • IMAGE : Debian 11 image r006-f83ce520-00b5-40c5-9938-a5c82a273f91
   • TOUCHES : r006-89ec781c-9630-4f76-b9c4-a7d204828d61

   La réponse varie en fonction des valeurs d'option que vous utilisez.

   ID                                    0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Name                                  my-instance
   CRN                                   crn:v1:public:is:us-south-2:a/a1234567::instance:0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Status                                pending
   Availability policy on host failure   restart
   Startable                             true
   Profile                               bx2-2x8
   Architecture                          amd64
   vCPU Manufacturer                     intel
   vCPUs                                 2
   Memory(GiB)                           8
   Bandwidth(Mbps)                       4000
   Volume bandwidth(Mbps)                1000
   Network bandwidth(Mbps)               3000
   Lifecycle Reasons                     Code   Message
                                          -      -
   
   Lifecycle State                       pending
   
   Metadata service                      Enabled   Protocol   Response hop limit
                                         false     http       1
   
   Image                                 ID                                          Name
                                         r006-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4
   
   VPC                                   ID                                          Name
                                         r006-35b9cf35-616e-462e-a145-cf8db4062fcf   my-vpc
   
   Zone                                  us-south-2
   Resource group                        ID                                 Name
                                         cdc21b72d4e647b195de988b175e3d82   Default
   
   Created                               2023-03-23T21:50:24+00:00
   Boot volume                           ID   Name   Attachment ID                               Attachment name
                                         -    -      0717-7ccd4284-e59d-45d8-932a-9e52f62f187a   landing-faucet-prankish-sprout
   

   Les informations relatives aux interfaces réseau créées pour la nouvelle instance ne sont pas renvoyées après la création de l'instance. Vous pouvez visualiser les informations en utilisant la commande ibmcloud is instance INSTANCE comme décrit dans l'étape suivante. Le statut reste «* en attente* » jusqu'à ce que l'instance soit créée.

   Pour plus d'informations sur certaines fonctionnalités supplémentaires que vous pouvez inclure en tant qu'options de la commande instance-create, consultez les rubriques suivantes : Créer un attachement de volume JSON, Activer ou désactiver le service de métadonnées et Créer un groupe de placement.

   Pour obtenir une liste complète des options de commande, voir ibmcloud is instance-create.

2. Ensuite, exécutez la commande suivante instance details pour vérifier que vous pouvez voir votre nouvelle instance et les interfaces réseau qui ont été créées pour la nouvelle instance. 0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0 est l'ID de l'instance du serveur virtuel qui a été attribué lors de la création de l'instance à l'étape précédente.

   ibmcloud is instance 0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   

   Pour cet exemple, vous voyez la réponse suivante. Le statut indique désormais «* en cours d'exécution* ». Consultez la section Interfaces réseau pour trouver l'ID de l'interface réseau.

   ID                                    0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Name                                  my-instance
   CRN                                   crn:v1:public:is:us-south-2:a/a1234567::instance:0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Status                                running
   Availability policy on host failure   restart
   Startable                             true
   Profile                               bx2-2x8
   Architecture                          amd64
   vCPU Manufacturer                     intel
   vCPUs                                 2
   Memory(GiB)                           8
   Bandwidth(Mbps)                       4000
   Volume bandwidth(Mbps)                1000
   Network bandwidth(Mbps)               3000
   Lifecycle Reasons                     Code   Message
                                          -      -
   
   Lifecycle State                       stable
   
   Metadata service                      Enabled   Protocol   Response hop limit
                                         false     http       1
   
   Image                                 ID                                          Name
                                         r006-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4
   
   VPC                                   ID                                          Name
                                         r006-35b9cf35-616e-462e-a145-cf8db4062fcf   my-vpc
   
   Zone                                  us-south-2
   Resource group                        ID                                 Name
                                         cdc21b72d4e647b195de988b175e3d82   Default
   
   Created                               2023-03-23T21:50:24+00:00
   Network Interfaces                    Interface   Name      ID                                          Subnet            Subnet ID                                   Floating IP   Security Groups                 Allow source IP spoofing   Reserved IP
                                         Primary     primary   0717-4db768bb-65c3-4045-8712-523e62eeabd2   my-subnet   0717-198db988-3b9b-4cfa-9dec-0206420d37d0         -             enhance-corsage-managing-jinx   false                      10.240.64.10
   
   Boot volume                           ID                                          Name                           Attachment ID                                    Attachment name
                                         r006-7a1d72d1-56ac-438e-bf85-6c0173e3f9a6   expend-anger-whiff-jackknife   0717-7ccd4284-e59d-45d8-932a-9e52f62f187a        landing-faucet-prankish-sprout
   

3. Demandez une adresse IP flottante à associer à votre instance à l'aide de la commande suivante. Le nom spécifié pour l'IP flottante est my-floatingip. 0717-4db768bb-65c3-4045-8712-523e62eeabd2 est l'ID de l'interface réseau pour l'instance de serveur virtuel affichée à l'étape précédente.

   ibmcloud is floating-ip-reserve \
       my-floatingip \
       --nic 0717-4db768bb-65c3-4045-8712-523e62eeabd2
   

   Pour cet exemple, vous voyez une réponse similaire à la sortie suivante.

   ID               r006-9b79b9bc-a2dc-4337-865a-57d9b9198b76
   Address          169.59.214.164
   Name             my-floatingip
   CRN              crn:v1:public:is:us-south-2:a/a1234567::floating-ip:r006-9b79b9bc-a2dc-4337-865a-57d9b9198b76
   Status           available
   Zone             us-south-2
   Created          2023-03-23T22:13:07+00:00
   Target           ID                                          Target type         Instance ID                                 Target interface name   Target interface private IP
                    0717-4db768bb-65c3-4045-8712-523e62eeabd2   network_interface   0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0   primary                 -
   
   
   Resource group   ID                                 Name
                    cdc21b72d4e647b195de988b175e3d82   Default
   

   Enregistrez l'IP flottante Address pour l'utiliser ultérieurement.

   Pour obtenir la liste complète des options de commande, consultez ibmcloud is floating-ip-reserve.

Vous avez besoin d'aide supplémentaire ? Vous pouvez exécuter ibmcloud is instance-create --help pour afficher l'aide à la création d'une instance.

Mise à disposition à partir d'une image du catalogue privé

Une fois que vous connaissez les valeurs requises, utilisez-les pour exécuter la ibmcloud is instance-create commande. Vous devez également indiquer un nom unique pour l'instance.

Procédez comme suit pour créer une instance de serveur virtuel à partir d'une offre de catalogue privé ou d'une version d'offre de catalogue à partir de l'interface CLI.

1. Créez une instance à l'aide de la commande suivante.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --catalog-offering <CRN for the IBM Cloud catalog offering> or --catalog-offering-version <The CRN for the version of an IBM Cloud catalog offering> \
       --keys KEYS \
       --placement-group PLACEMENT_GROUP_NAME \
   

   Par exemple, si vous créez une instance appelée my-instance dans us-south-2 et utilisez le bx2-2x8 profil et l'offre de catalogue, votre instance-create commande ressemble à l'exemple suivant.

   ibmcloud is instance-create\
       my-instance\
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf\
       us-south-2\
       bx2-2x8\
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0\
       --catalog-offering crn:v1:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61\
       --placement-group c5f1f366-b92a-4080-991a-aa5c2e33d96b\
   

   Les valeurs suivantes des arguments et des options sont utilisées.

   • INSTANCE_NAME : my-instance
   • VPC : r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • ZONE_NAME : us-south-2
   • NOM_PROFILE : bx2-2x8
   • SUBNET : 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • OFFRE CATALOGUE : est crn:v1:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d
   • TOUCHES : r006-89ec781c-9630-4f76-b9c4-a7d204828d61
   • GROUPE_DE_PLACEMENT : c5f1f366-b92a-4080-991a-aa5c2e33d96b

   Les informations relatives aux interfaces réseau créées pour la nouvelle instance ne sont pas renvoyées après la création de l'instance. Vous pouvez visualiser les informations en utilisant la commande ibmcloud is instance INSTANCE comme décrit dans l'étape suivante.

   Le statut de l'instance de serveur virtuel est affiché en attente jusqu'à ce que l'instance soit créée.

   Pour obtenir une liste complète des options de commande, voir ibmcloud is instance-create.

2. Ensuite, exécutez la commande suivante instance details pour vérifier que vous pouvez voir votre nouvelle instance et les interfaces réseau qui ont été créées pour la nouvelle instance. Pour INSTANCE, indiquez l'ID qui a été attribué à votre nouvelle instance de serveur virtuel à l'étape précédente.

   ibmcloud is instance INSTANCE
   

   Le statut indique désormais «* en cours d'exécution* ». Consultez la section Interfaces réseau pour trouver l'ID de l'interface réseau.

3. Demandez une adresse IP flottante à associer à votre instance à l'aide de la commande suivante. Pour FLOATING_IP_NAME, indiquez un nom pour votre IP flottante, et pour TARGET_INTERFACE, indiquez l'ID de l'interface réseau que vous avez identifiée à l'étape précédente.

   ibmcloud is floating-ip-reserve \
       FLOATING_IP_NAME \
       --nic TARGET_INTERFACE
   

   Enregistrez l'IP flottante Address pour l'utiliser ultérieurement.

   Pour obtenir la liste complète des options de commande, consultez ibmcloud is floating-ip-reserve.

Vous avez besoin d'aide supplémentaire ? Vous pouvez exécuter ibmcloud is instance-create --help pour afficher l'aide à la création d'une instance.

Mise à disposition à partir d'un volume existant

Une fois que vous connaissez les valeurs requises, utilisez-les pour exécuter la commande instance-create. Vous devez également indiquer un nom unique pour l'instance.

Suivez les étapes suivantes pour créer une instance de serveur virtuel à partir d'un volume amorçable, et qui inclut un attachement de volume.

1. Créez une instance à l'aide de la commande suivante.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --boot-volume BOOT_VOLUME_JSON | @BOOT_VOLUME_JSON_FILE \
       --keys KEYS \
       --volume-attach VOLUME_ATTACH_JSON \
   

   Par exemple, si vous créez une instance appelée my-instance dans us-south-1 et utilisez le bx2-2x8 profil et un volume de démarrage existant, votre instance-create commande ressemble à l'exemple suivant.

   ibmcloud is instance-create\
       my-instance\
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf\
       us-south-1\
       bx2-2x8\
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0\
       --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"id": "r006-feec3e99-995e-4e8f-896b-48b42c7d05a7"}}'\
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61\
       --volume-attach @/Users/myname/myvolume-attachment_create.json\
   

   Pour un exemple de fichier JSON de pièce jointe de volume, voir Création d'un fichier JSON de connexion de volume. Vous pouvez également inclure des étiquettes d'utilisateur pour les volumes dans l'attachement du volume.

   Les informations relatives aux interfaces réseau créées pour la nouvelle instance ne sont pas renvoyées après la création de l'instance. Vous pouvez visualiser les informations en utilisant la commande ibmcloud is instance INSTANCE comme décrit dans l'étape suivante.

   Le statut reste «* en attente* » jusqu'à ce que l'instance soit créée.

   Pour obtenir une liste complète des options de commande, voir ibmcloud is instance-create.

2. Ensuite, exécutez la commande suivante instance details pour vérifier que vous pouvez voir votre nouvelle instance et les interfaces réseau qui ont été créées pour la nouvelle instance. Pour INSTANCE, indiquez l'ID qui a été attribué à votre nouvelle instance de serveur virtuel à l'étape précédente.

   ibmcloud is instance INSTANCE
   

   Le statut indique désormais «* en cours d'exécution* ». Consultez la section Interfaces réseau pour trouver l'ID de l'interface réseau.

3. Demandez une adresse IP flottante à associer à votre instance à l'aide de la commande suivante. Pour FLOATING_IP_NAME, indiquez un nom pour votre IP flottante, et pour TARGET_INTERFACE, indiquez l'ID de l'interface réseau que vous avez identifiée à l'étape précédente.

   ibmcloud is floating-ip-reserve \
       FLOATING_IP_NAME \
       --nic TARGET_INTERFACE
   

   Enregistrez l'IP flottante Address pour l'utiliser ultérieurement.

   Pour obtenir la liste complète des options de commande, consultez ibmcloud is floating-ip-reserve.

   Vous avez besoin d'aide supplémentaire ? Vous pouvez exécuter ibmcloud is instance-create --help pour afficher l'aide à la création d'une instance.

Création d'une instance avec plusieurs volumes de données et allocation dynamique de la bande passante du volume à partir de la CLI

Certains profils de calcul prennent en charge l'allocation de bande passante mutualisée pour les volumes de données. Pour la plupart des profils de calcul, la valeur par défaut de la propriété --volume-bandwidth-qos-mode est weighted. Lorsque weighted est utilisé, la bande passante du volume est répartie proportionnellement entre les volumes de données. En spécifiant la valeur pooled, vous activez l'allocation dynamique de la bande passante.

L'exemple suivant utilise la commande ibmcloud is instance-create pour créer l'instance de serveur virtuel et spécifie l'option --volume-bandwidth-qos-mode avec la valeur pooled.

ibmcloud is instance-create my-virtual-server my-vpc us-south-2 cx3d-8x20 my-subnet --image r006-534ef2ac-6158-45b3-9657-57629fa85305 --keys r006-68f8333a-1169-42da-ba01-75268bac8362 --volume-attach @/Users/myname/myvolume-attachment.json --volume-bandwidth-qos-mode pooled

Le fichier myvolume-attachments.json peut inclure jusqu'à 12 volumes de données qui doivent être attachés au serveur virtuel. Voir l'exemple suivant :

[
  {"volume": {
        "name": "my-data-volume-1",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
   "delete_volume_on_instance_delete": false},
  {"volume": {
        "name": "my-data-volume-2",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
   "delete_volume_on_instance_delete": false},
  {"volume": {
        "name": "my-data-volume-3",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
   "delete_volume_on_instance_delete": false}
]

Créer une instance avec calcul confidentiel

Sélectionner la disponibilité

L'informatique confidentielle avec Intel SGX pour VPC n'est disponible que dans la région US-South (Dallas). Les volumes de démarrage de deuxième génération avec le profil de volume sdp ne prennent pas encore en charge le démarrage sécurisé. Si le démarrage sécurisé est requis, utilisez un volume de démarrage avec un profil de volume de première génération.

Une fois que vous connaissez les valeurs requises, utilisez-les pour exécuter la commande ibmcloud is instance-create. Vous devez également indiquer un nom unique pour l'instance.

Pour confidential-compute-mode, vous devez spécifier sgx ou tdx pour l'option.

Suivez les étapes suivantes pour créer une instance de serveur virtuel de base qui active le calcul confidentiel.

Créez une instance à l'aide de la commande suivante.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --confidential-compute-mode sgx \
       --keys KEYS \

Par exemple, la commande instance-create suivante utilise les valeurs d'exemple qui se trouvent dans la section Collecte d'informations.

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --confidential-compute-mode sgx \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \

Les valeurs d'argument et d'option suivantes sont utilisées

  * INSTANCE_NAME: `my-instance`
  * VPC: `r006-35b9cf35-616e-462e-a145-cf8db4062fcf`
  * ZONE_NAME: `us-south-2`
  * PROFILE_NAME: `bx2-2x8`
  * SUBNET: `0717-198db988-3b9b-4cfa-9dec-0206420d37d0`
  * IMAGE: Debian 11 image `r006-f83ce520-00b5-40c5-9938-a5c82a273f91`
  * KEYS: `r006-89ec781c-9630-4f76-b9c4-a7d204828d61`

Créer une instance avec démarrage sécurisé

Sélectionner la disponibilité

L'informatique confidentielle avec Intel SGX for VPC n'est disponible que dans les régions de Dallas (us-south) et de Francfort (eu-de). Les volumes de démarrage de deuxième génération avec le profil de volume sdp ne prennent pas encore en charge le démarrage sécurisé. Si le démarrage sécurisé est requis, utilisez un volume de démarrage avec un profil de volume de première génération.

Une fois que vous connaissez les valeurs requises, utilisez-les pour exécuter la commande ibmcloud is instance-create. Vous devez également indiquer un nom unique pour l'instance.

Pour enable-secure-boot, vous devez spécifier true ou false. La valeur par défaut est false.

Procédez comme suit pour créer une instance de serveur virtuel de base qui active le démarrage sécurisé.

Créez une instance à l'aide de la commande suivante.

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --enable-secure-boot true \
       --keys KEYS \

Par exemple, la commande instance-create suivante utilise les valeurs d'exemple qui se trouvent dans la section Collecte d'informations.

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --enable-secure-boot true \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \

Les valeurs d'argument et d'option suivantes sont utilisées

  * INSTANCE_NAME: `my-instance`
  * VPC: `r006-35b9cf35-616e-462e-a145-cf8db4062fcf`
  * ZONE_NAME: `us-south-2`
  * PROFILE_NAME: `bx2-2x8`
  * SUBNET: `0717-198db988-3b9b-4cfa-9dec-0206420d37d0`
  * IMAGE: Debian 11 image `r006-f83ce520-00b5-40c5-9938-a5c82a273f91`
  * KEYS: `r006-89ec781c-9630-4f76-b9c4-a7d204828d61`

Avant de commencer

Assurez-vous que vous disposez des droits d'accès requis. Pour appeler ces méthodes, vous devez vous voir attribuer un ou plusieurs rôles d'accès IAM comprenant les actions suivantes, en fonction des conditions énumérées. Vous pouvez vérifier votre accès en allant sur la page Utilisateurs du tableau de bord Cloud Identity and Access Management.

Collecte d'informations pour créer une instance avec l'API

Avant de créer une instance, vous devez en connaître les détails, tels que le profil de l'instance ou l'image que vous souhaitez utiliser. Recueillez des informations en effectuant les appels API suivants :

Si vous prévoyez d'utiliser un instantané provenant d'un autre compte, assurez-vous d'abord que les autorisations IAM appropriées sont en place. Contactez ensuite le propriétaire de l'instantané pour obtenir le CRN de l'instantané.

Certains profils peuvent ne pas être disponibles pour l'une des raisons suivantes :

• Le nombre d'interfaces réseau du serveur virtuel dépasse les limites du profil. Vous pouvez supprimer des interfaces réseau afin de sélectionner un plus grand nombre de profils. Pour plus d'informations, consultez la section Redimensionnement d'un serveur virtuel.
• L'image sélectionnée contient une expression d'utilisation autorisée qui n'est pas compatible avec le profil. Dans ce cas, sélectionnez une image dont l'expression d'utilisation autorisée est compatible avec le profil recherché. Pour plus d'informations, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

Création d'une instance avec l'API

Après avoir récupéré les informations dont vous avez besoin, vous pouvez exécuter la méthode POST /instances pour créer une instance.

Fournir une instance à partir d'une image standard ou personnalisée avec l'API

Vous pouvez doter une instance d'une image stock ou personnalisée en spécifiant la sous-propriété id de l'image comme valeur de la propriété image.

   curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
     -H "Authorization:$iam_token" \
     -d '{
           "name": "my-instance",
           "zone": {
             "name": "us-south-3"
           },
           "vpc": {
             "id": "'$vpc'"
           },
           "primary_network_interface": {
             "subnet": {
               "id": "'$subnet'"
             }
           },
           "keys":[{"id": "'$key'"}],
           "profile": {
             "name": "'$profile_name'"
            },
           "image": {
             "id": "'$image_id'"
            }
           }'

Fournir une instance à partir d'une image de catalogue privé avec l'API

Vous pouvez approvisionner une instance avec une image de catalogue privé en spécifiant l'image offering_crn ou la sous-propriété version_crn comme valeur de la propriété catalog_offering.

• Créez une instance à l'aide d'une image de catalogue privée provenant de la version la plus récente d'une offre de produit du catalogue.

  curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
    -H "Authorization:$iam_token" \
    -d '{
          "name": "my-instance",
          "zone": {
            "name": "us-south-3"
          },
          "vpc": {
            "id": "'$vpc'"
          },
          "primary_network_interface": {
            "subnet": {
              "id": "'$subnet'"
            }
          },
          "keys":[{"id": "'$key'"}],
          "profile": {
            "name": "'$profile_name'"
           },
          "catalog_offering": {
            "offering": {
              "crn": "'$offering_crn'"
           }
          }'
  

• Créez une instance en utilisant une image de catalogue privée provenant d'une version spécifique d'une offre de produit de catalogue.

  curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
    -H "Authorization:$iam_token" \
    -d '{
          "name": "my-instance",
          "zone": {
            "name": "us-south-3"
          },
          "vpc": {
            "id": "'$vpc'"
          },
          "primary_network_interface": {
            "subnet": {
              "id": "'$subnet'"
            }
          },
          "keys":[{"id": "'$key'"}],
          "profile": {
            "name": "'$profile_name'"
           },
          "catalog_offering": {
            "version": {
              "crn": "'$version_crn'"
           }
          }'
  

Mise à disposition à partir d'un volume existant

La réutilisation d'un volume amorçable existant est plus rapide que la création d'un nouveau volume à partir d'un instantané ou d'une image.

Vous pouvez approvisionner une instance avec un volume existant en spécifiant la sous-propriété id ou crn du volume existant comme valeur de la propriété boot_volume_attachment.

Le volume amorçable existant doit être un volume amorçable non attaché ayant la même architecture que le profil d'instance. Utilisez le filtre de la liste des volumes et faites référence aux propriétés attachment_state et operating_system pour voir l'éligibilité d'un volume.

Par exemple, pour voir les volumes non attachés dans us-south-1 avec un système d'exploitation x86.

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2023-02-08&generation=2?attachment_state=unattached&zone.name=us-south-1&operating_system.architecture=amd64"
-H "Authorization: Bearer $iam_token"

Par défaut, un volume de démarrage créé dans le cadre du provisionnement d'une instance de serveur virtuel est supprimé lorsque l'instance est supprimée. Vous pouvez modifier ce comportement en définissant la propriété delete_volume_on_instance_delete sur false lorsque vous créez l'instance ou mettez à jour l'attachement du volume de démarrage.

Utilisez la méthode POST /instances pour créer une instance avec les informations que vous avez recueillies. L'appel suivant est un exemple de provisionnement d'une instance en utilisant un volume de démarrage existant.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2023-02-08&generation=2"
-H "Authorization: Bearer $iam_token"
-d '{
  "boot_volume_attachment": {
    "volume": {
      "id": "r006-feec3e99-995e-4e8f-896b-48b42c7d05a7"
    }
  },
  "keys": [
    {
      "id": "363f6d70-0000-0001-0000-00000013b96c"
    }
  ],
  "name": "my-instance",
  "placement_target": {
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"
  },
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {
      "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"
    }
  },
  "profile": {
    "name": "bx2-2x8"
  },
  "volume_attachments": [
    {
      "volume": {
        "capacity": 1000,
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "name": "my-data-volume",
        "profile": {
          "name": "5iops-tier"
        }
      }
    }
  ],
  "vpc": {
    "id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"
  },
  "zone": {
    "name": "us-south-1"
  }
}'

Les volumes de démarrage de deuxième génération avec le profil de volume sdp ne prennent pas encore en charge le démarrage sécurisé. Si le démarrage sécurisé est requis, utilisez un volume de démarrage avec un profil de volume de première génération.

Pour plus d'informations, voir Création d'une instance.

Restaurer un volume de démarrage à partir d'un instantané et l'utiliser pour provisionner une nouvelle instance

Vous pouvez restaurer un volume de démarrage à partir d'un instantané de démarrage, puis utiliser ce volume de démarrage lors de l'approvisionnement d'une instance. Le snapshot amorçable doit avoir le même système d'exploitation et la même architecture que le profil d'instance.

Dans la requête POST /instances, spécifiez la propriété boot_volume_attachment et l'identifiant de l'instantané de démarrage dans la sous-propriété source_snapshot. Vous pouvez également utiliser le nom ou le CRN de l'instantané. Consultez l'exemple suivant.

curl -X POST \
"$vpc_api_endpoint/v1/instances?version=2023-03-07&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
      "boot_volume_attachment": {
        "delete_volume_on_instance_delete": true,
        "volume": {
            "profile": {
                "name": "general-purpose"
            },
            "source_snapshot": {
                "id": "eb373975-4171-4d91-81d2-c49efb033753"
            }
        }
     },
     .
     .
     .
  }'

Pour plus d'informations sur la restauration d'un volume à l'aide de l'API, voir Restaurer un volume à partir d'un instantané à l'aide de l'API.

Création d'une instance avec plusieurs volumes de données et allocation dynamique de la bande passante du volume à l'aide de l'API

Certains profils de calcul prennent en charge l'allocation de bande passante mutualisée pour les volumes de données. Vous pouvez provisionner de manière programmatique une instance de serveur virtuel avec plusieurs volumes de données en appelant la méthode instances, comme le montre l'exemple de requête suivant. L'exemple crée un serveur virtuel dans la zone us-south-2 avec un volume de démarrage de 250 Go et trois volumes de données de 3 To. L'adresse storage_qos_mode est réglée sur pooled pour permettre l'allocation dynamique de la bande passante au volume.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-07-12&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
  "zone": {"name": "us-south-2"},
  "resource_group": {"id": "db8e8d865a83e0aae03f25a492c5b39e"},
  "name": "my-gen3-instance",
  "vpc": {"id": "r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b"},
  "user_data": "",
  "profile": {"name": "cx3d-8x20"},
  "keys": [{"id": "r006-68f8333a-1169-42da-ba01-75268bac8362"}],
  "volume_attachments": [
    {"volume": {
        "name": "my-data-volume-a",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
      "delete_volume_on_instance_delete": false},
    {"volume": {
        "name": "my-data-volume-b",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
      "delete_volume_on_instance_delete": false
    },
    {"volume": {
        "name": "my-data-volume-c",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
      "delete_volume_on_instance_delete": false
      }],
  "boot_volume_attachment": {
    "volume": {
      "name": "my-gen3-instance-boot-1720810915000",
      "capacity": 250,
      "profile": {"name": "general-purpose"},
      "user_tags": []},
    "delete_volume_on_instance_delete": true
  },
  "metadata_service": {"enabled": false},
  "primary_network_attachment": {
    "name": "eth0",
    "virtual_network_interface": {
      "allow_ip_spoofing": false,
      "auto_delete": true,
      "enable_infrastructure_nat": true,
      "primary_ip": {"auto_delete": true},
      "subnet": {"id": "0726-298acd6c-e71e-4204-a04f-fe4a4dd89805"},
      "security_groups": [{"id": "r006-ccdd1f58-f0f2-4ea0-8774-a24bbe61b5d9"}],
      "protocol_state_filtering_mode": "auto"}
  },
  "network_attachments": [],
  "image": {"id": "r006-534ef2ac-6158-45b3-9657-57629fa85305"},
  "enable_secure_boot": false
  "storage_qos_mode": pooled
}'

Création d'une instance avec calcul confidentiel

Sélectionner la disponibilité

L'informatique confidentielle avec Intel SGX for VPC n'est disponible que dans les régions de Dallas (us-south) et de Francfort (eu-de). Les volumes de démarrage de deuxième génération avec le profil de volume sdp ne prennent pas encore en charge le démarrage sécurisé. Si le démarrage sécurisé est requis, utilisez un volume de démarrage avec un profil de volume de première génération.

Pour provisionner une instance avec un calcul confidentiel, ajoutez la propriété confidential_compute_mode et définissez-la sur sgx ou tdx.

   curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
     -H "Authorization:$iam_token" \
     -d '{
           "name": "my-instance",
           "zone": {
             "name": "us-south-3"
           },
           "vpc": {
             "id": "'$vpc'"
           },
           "primary_network_interface": {
             "subnet": {
               "id": "'$subnet'"
             }
           },
           "keys":[{"id": "'$key'"}],
           "profile": {
             "name": "'$profile_name'"
            },
           "image": {
             "id": "'$image_id'"
            },
            "confidential_compute_mode": "sgx"
           }'

Création d'une instance avec démarrage sécurisé

Pour provisionner une instance avec un démarrage sécurisé, ajoutez la propriété enable_secure_boot et définissez-la sur true.

   curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
     -H "Authorization:$iam_token" \
     -d '{
           "name": "my-instance",
           "zone": {
             "name": "us-south-3"
           },
           "vpc": {
             "id": "'$vpc'"
           },
           "primary_network_interface": {
             "subnet": {
               "id": "'$subnet'"
             }
           },
           "keys":[{"id": "'$key'"}],
           "profile": {
             "name": "'$profile_name'"
            },
           "image": {
             "id": "'$image_id'"
            },
            "enable_secure_boot": "true"
           }'

Les volumes de démarrage de deuxième génération avec le profil de volume sdp ne prennent pas encore en charge le démarrage sécurisé. Si le démarrage sécurisé est requis, utilisez un volume de démarrage avec un profil de volume de première génération.

Avant de commencer

Assurez-vous d'avoir configuré Terraform pour VPC.

Création d'un catalogue privé

Cette étape est facultative. Si vous envisagez de partager des images à partir d'un catalogue privé, ce dernier doit d'abord être créé. Si vous sélectionnez une image de catalogue qui appartient à un autre compte, consultez la section Utilisation de références d'images inter-comptes dans un catalogue privé dans Terraform pour plus de considérations et de limitations.

Collecte d'informations pour créer une instance à l'aide de Terraform

Vous êtes prêt à créer une instance ? Avant de pouvoir exécuter la ibm_is_instance commande, vous devez connaître les détails de l'instance, tels que le profil ou l'image que vous souhaitez utiliser.

Rassemblez les informations suivantes en utilisant la commande DataSource.

1. Rassembler les détails du profil de l'instance. Exécutez la commande suivante pour le profil que vous avez sélectionné. Voir x86 profils d'instance pour une liste des profils disponibles. Pour plus d'informations, voir la documentation Terraform sur ibm_is_instance_profiles. Utilisez un profil d'instance en vous référant à la source de données du profil d'instance. Pour plus d'informations, voir la documentation Terraform sur ibm_is_instance_profile.

   • Rassembler les détails d'un profil d'instance pour un profil spécifique

   data "ibm_is_instance_profile" "example_profile" {
      name = "bx2-2x8"
   }
   

2. Répertoriez les images disponibles pour créer votre instance. Vous pouvez utiliser une image en stock, une image personnalisée de votre compte ou une image qui a été partagée avec votre compte à partir d'un catalogue privé. Pour plus d'informations, consultez la documentation Terraform sur ibm_is_image. Si vous prévoyez d'utiliser une image qui a été partagée à partir d'un catalogue privé, consultez la documentation Terraform sur ibm_cm_version ou ibm_cm_offering_instance.

   Expressions d'utilisation autorisée : L'image que vous sélectionnez détermine les profils disponibles pour créer l'instance de serveur virtuel. Lors de la création d'une instance de serveur virtuel avec des images utilisant une expression d'utilisation autorisée, les informations fournies dans les propriétés d'utilisation autorisée sont ensuite évaluées par rapport à une instance de serveur virtuel potentielle afin de déterminer si cette image peut être utilisée pour créer l'instance de serveur virtuel. Les images de stock utilisent des expressions définies d'utilisation autorisée. Vous devez définir toutes les expressions d'utilisation autorisée pour les images personnalisées. Pour plus d'informations, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

   • Sélectionnez une image de stock ou une image personnalisée de votre compte pour votre instance.

     data "ibm_is_image" "example_image" {
        name = "ibm-centos-7-6-minimal-amd64-2"
     }
     

   • Sélectionnez une image partagée à partir d'un catalogue privé pour l'instance. Pour plus d'informations, voir la documentation Terraform sur ibm_is_images. Vous pouvez sélectionner une image dans la liste pour créer l'instance comme indiqué dans la section Aller à la section Créer une instance en utilisant Terraform.

   Si vous sélectionnez une image de catalogue appartenant à un autre compte, vous devez tenir compte d'un plus grand nombre de considérations et de limitations. Voir Utilisation de références d'images inter-comptes dans un catalogue privé dans Terraform.

   • Pour répertorier toutes les offres d'images de catalogues privés disponibles, exécutez la commande suivante.

     data "ibm_is_images" "example_images" {
     catalog_managed = true
     }
     

   • Lister les profils et les images compatibles en utilisant des expressions d'utilisation autorisée

     • Répertorier les profils d'instance compatibles avec une image

       data "ibm_is_image_instance_profiles" "testacc_image_instance_profiles" {
       identifier = "r134-0950e619-325e-446e-b895-e0bdd21dd1ea"
       }
       

     • Liste des profils d'instance compatibles avec un volume

       data "ibm_is_volume_instance_profiles" "testacc_volume_instance_profiles" {
       identifier = "r134-0950e619-325e-446e-b895-e0bdd21dd1ea"
       }
       

     • Liste des profils d'instance compatibles avec un instantané

       data "ibm_is_snapshot_instance_profiles" "testacc_snapshot_instance_profiles" {
       identifier = "r134-0950e619-325e-446e-b895-e0bdd21dd1ea"
       }
       

3. Créez une ressource VPC ou utilisez un VPC existant en vous référant à la source de données VPC. Pour plus d'informations, voir la documentation Terraform sur ibm_is_vpc.

   resource "ibm_is_vpc" "example_vpc" {
      name = "example-vpc"
   }
   

4. Créez une ressource de sous-réseau ou utilisez un sous-réseau existant en vous référant à la source de données de sous-réseau. Pour plus d'informations, consultez la documentation Terraform sur ibm_is_subnet.

   resource "ibm_is_subnet" "example_subnet" {
      name            = "example-subnet"
      vpc             = ibm_is_vpc.example_vpc.id
      zone            = "us-south-1"
      ipv4_cidr_block = "10.240.0.0/24"
   }
   

5. Créez une ressource ssh-key ou utilisez une clé ssh existante en vous référant à la source de données ssh-key. Pour plus d'informations, voir la documentation Terraform sur ibm_is_ssh_keys.

   resource "ibm_is_ssh_key" "example_sshkey" {
      name       = "example-sshkey"
      type       = "rsa"
      public_key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCKVmnMOlHKcZK8tpt3MP1lqOLAcqcJzhsvJcjscgVERRN7/9484SOBJ3HSKxxNG5JN8owAjy5f9yYwcUg+JaUVuytn5Pv3aeYROHGGg+5G346xaq3DAwX6Y5ykr2fvjObgncQBnuU5KHWCECO/4h8uWuwh/kfniXPVjFToc+gnkqA+3RKpAecZhFXwfalQ9mMuYGFxn+fwn8cYEApsJbsEmb0iJwPiZ5hjFC8wREuiTlhPHDgkBLOiycd20op2nXzDbHfCHInquEe/gYxEitALONxm0swBOwJZwlTDOB7C6y2dzlrtxr1L59m7pCkWI4EtTRLvleehBoj3u7jB4usR"
   }
   

   Les clés SSH peuvent être de type RSA ou Ed25519. Vous pouvez générer de nouvelles paires de clés RSA à l'aide de l'interface utilisateur. Les clés RSA et ED25519 SSH préexistantes peuvent être téléchargées. Ed25519 ne peut être utilisé que si le système d'exploitation prend en charge ce type de clé. Ed25519 ne peut pas être utilisé avec des images Windows ou VMware.

6. Créez une ressource subnet_reserved_ip ou utilisez un subnet_reserved_ip existant en vous référant à la source de données subnet_reserved_ip. Pour plus d'informations, voir la documentation Terraform sur ibm_is_subnet_reserved_ip.

   resource "ibm_is_subnet_reserved_ip" "example_reserved_ip" {
      subnet    = ibm_is_subnet.example_subnet.id
      name      = "example-reserved-ip1"
      address   = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "13")}"
   }
   

Création d'une instance à l'aide de Terraform

Pour utiliser Terraform, téléchargez l'interface CLI Terraform et configurez le IBM Cloud plug-in Provider. Pour plus d'informations, voir Démarrer avec Terraform.

Créez l'instance en utilisant l'un des exemples suivants. Pour plus d'informations, voir la documentation Terraform sur ibm_is_instance.

Expressions d'utilisation autorisée : L'image que vous sélectionnez détermine les profils disponibles pour créer l'instance de serveur virtuel. Lors de la création d'une instance de serveur virtuel avec des images utilisant une expression d'utilisation autorisée, les informations fournies dans les propriétés d'utilisation autorisée sont ensuite évaluées par rapport à une instance de serveur virtuel potentielle afin de déterminer si cette image peut être utilisée pour créer l'instance de serveur virtuel. Les images de stock utilisent des expressions définies d'utilisation autorisée. Vous devez définir toutes les expressions d'utilisation autorisée pour les images personnalisées. Pour plus d'informations, voir Ajout d'expressions d'utilisation autorisée aux images personnalisées.

Exécutez l'une des commandes Terraform suivantes en fonction de l'image que vous prévoyez d'utiliser.

• Créez une instance en utilisant une image de stock ou une image personnalisée de votre compte pour votre instance.

  resource "ibm_is_instance" "example_instance" {
    name    = "example-instance-reserved-ip"
    image   = data.ibm_is_image.example_image.id
    profile = data.ibm_is_instance_profile.example_profile.name
  
    primary_network_interface {
      name   = "eth0"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
      }
    }
    network_interfaces {
      name   = "eth1"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        name = "example-reserved-ip1"
        auto_delete = true
        address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
      }
    }
  
    vpc  = ibm_is_vpc.example_vpc.id
    zone = "us-south-1"
    keys = [ibm_is_ssh_key.example_sshkey.id]
  }
  

• Créer une instance qui utilise une image gérée par un catalogue privé. Lorsque vous spécifiez le profil de volume de deuxième génération pour le volume de démarrage, vous pouvez spécifier des limites personnalisées de capacité, d'IOPS et de bande passante.

  resource "ibm_is_instance" "example_instance" {
    name    = "example-instance-reserved-ip"
    image   = data.ibm_is_image.example_image.id
    profile = data.ibm_is_instance_profile.example_profile.name
  
    primary_network_interface {
      name   = "eth0"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
      }
    }
    network_interfaces {
      name   = "eth1"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        name = "example-reserved-ip1"
        auto_delete = true
        address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
      }
    }
  
    vpc  = ibm_is_vpc.example_vpc.id
    zone = "us-south-1"
    keys = [ibm_is_ssh_key.example_sshkey.id]
  
    boot_volume {
      name           = "example-boot-volume"
      profile        = "sdp"
      size           = 250
      iops           = 3000
      bandwidth      = 1000
      encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
     }
  }
  

  • Créez une instance en utilisant un snapshot avec une expression d'utilisation autorisée de votre compte pour votre instance.

  resource "ibm_is_instance" "testacc_instance" {
    name    = "example-instance"
    profile = "cx2-2x4"
    primary_network_interface {
      subnet = ibm_is_subnet.testacc_subnet.id
    }
    vpc  = ibm_is_vpc.testacc_vpc.id
    zone = "us-south-1"
    keys = [ibm_is_ssh_key.testacc_sshkey.id]
    boot_volume {
      name     = "example-boot-volume"
      snapshot = ibm_is_snapshot.testacc_snapshot.id
      allowed_use {
        api_version       = "2025-06-05"
        bare_metal_server = "true"
        instance          = "true"
      }
    }
  }