Vorbereitende Schritte

• Laden Sie die folgenden CLI-Plug-ins herunter, installieren Sie sie und initialisieren Sie sie.

  • IBM Cloud-Befehlszeilenschnittstelle
  • Plug-in des Infrastrukturservice (infrastructure-service)

  Weitere Information finden Sie unter API- und CLI-Umgebung einrichten.

• Stellen Sie sicher, dass Sie eine VPC erstellt haben.

Informationen zum Erstellen einer Instanz über die CLI sammeln

Sind Sie bereit zum Erstellen einer Instanz? Bevor Sie den Befehl ibmcloud is instance-create ausführen können, müssen Sie die Details zur Instanz kennen, z. B. welches Profil oder Image Sie verwenden möchten.

Rufen Sie die folgenden Informationen mithilfe der entsprechenden Befehle ab.

Sie können eine Instanz aus einem available, partially_available (Image ist noch nicht in allen Zonen verfügbar) oder deprecated Image bereitstellen. Weitere Informationen über Image-Lebenszyklen finden Sie unter Benutzerdefinierter Image-Lebenszyklus.

Vergewissern Sie sich, dass das von Ihnen verwendete Profil in der Zone verfügbar ist, in der Sie die Instanz erstellen möchten.

Verwenden Sie die folgenden Befehle, um die erforderlichen Informationen zum Erstellen einer neuen Instanz zu ermitteln.

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

   ibmcloud is catalog-image-offerings
   ```
   Dieser Befehl gibt die Kennung jedes Bildangebots und die Kennung des privaten Katalogs, in dem sich das Bild befindet, zurück. Speichern Sie die `offering_id` und `catalog_id` in Variablen, die später zur Bereitstellung einer Instanz verwendet werden.

   ```sh {: pre}
   offering_id=6bf79f7b-de48-4ce8-8cae-866b376f2889
   catalog_id=71306253-8444-4cae-a45d-64d35e5393ec
   ```
- Um die `offering_crn` für das Angebot und die `offering_version_crn` für jede Version im Angebot abzurufen, führen Sie den folgenden Befehl aus.

```sh {: pre}
   ibmcloud is catalog-image-offering $catalog_id $offering_id
   ```
Wenn Sie eine Instanz bereitstellen, können Sie die Instanz entweder aus dem privat katalogverwalteten Image in der neuesten Version eines Katalogproduktangebots unter Verwendung des `offering_crn` Werts oder aus der spezifischen Version im Katalogproduktangebot unter Verwendung des `offering_version_crn` Werts bereitstellen.

   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"
    ```
##### Alle verfügbaren Boot-Volumes auflisten {: #list-available-boot-volumes-images-cli}

Listen Sie die verfügbaren Startvolumes für die Erstellung Ihrer Instanz auf. Wenn Sie eine Instanz aus einem Image erstellen, überspringen Sie diesen Schritt. Um eine Instanz aus einem vorhandenen Volume zu erstellen, müssen Sie ein Volume verwenden, das mit den zuvor gewählten Instanzoptionen kompatibel ist. Ein kompatibles Volume befindet sich in derselben Zone wie die Instanz, die bereitgestellt wird, ist nicht angeschlossen und hat ein Betriebssystem, das mit dem in Schritt 5 ausgewählten Profil kompatibel ist. Verwenden Sie den Unterbefehl `volumes`, um die kompatiblen Datenträger anzuzeigen. Zum Beispiel, um unverbundene Volumes mit einer x64 Betriebssystemarchitektur in `us-south-1` zu sehen:

```sh {: pre}
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

Erstellen einer Instanz über die CLI

Verwenden Sie die folgenden Informationen, um eine Instanz mit der CLI zu erstellen.

Bereitstellung eines Bildes aus dem Bestand oder eines benutzerdefinierten Bildes

Sobald Sie die erforderlichen Werte kennen, führen Sie den Befehl ibmcloud is instance-create damit aus. Außerdem müssen Sie einen eindeutigen Namen für die Instanz angeben.

Führen Sie die folgenden Schritte aus, um über die Befehlszeilenschnittstelle (CLI) ein einfaches VSI aus einem Standard-Image zu erstellen. Standardmäßig wird ein Boot-Volume an die Instanz angehängt, wenn die Instanz erstellt wird. Bei den meisten VSIs beträgt die Standardgröße des Startvolumens 100 GB. Die Standardgröße des Startvolumens für eine z/OS-VSI beträgt 250 GB.

1. Erstellen Sie eine Instanz mit dem folgenden Befehl.

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

   Der folgende Befehl instance-create verwendet zum Beispiel die Beispielwerte, die im Abschnitt " Informationen sammeln" zu finden sind.

   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 \
   

   Dabei werden die folgenden Argumente und Optionswerte verwendet

   • INSTANZ_NAME: my-instance
   • VPC: r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • ZONENNAME: us-south-2
   • PROFIL_NAME: bx2-2x8
   • Teilnetz: 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • IMAGE: Debian 11 Bild r006-f83ce520-00b5-40c5-9938-a5c82a273f91
   • TASTEN: r006-89ec781c-9630-4f76-b9c4-a7d204828d61

   Die Antwort hängt von den von Ihnen verwendeten Optionswerten ab.

   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
   

   Informationen zu den Netzwerkschnittstellen, die für die neue Instanz erstellt werden, werden nach der Erstellung der Instanz nicht zurückgegeben. Sie können die Informationen mit dem Befehl ibmcloud is instance INSTANCE anzeigen, wie im folgenden Schritt beschrieben. Der Status wird als ausstehend angezeigt, bis die Instanz erstellt wurde.

   Weitere Informationen zu einigen zusätzlichen Funktionen, die Sie als Befehlsoptionen in den Befehl instance-create aufnehmen können, finden Sie in den folgenden Themen: Erstellen einer Volume-Anlage JSON, Aktivieren oder Deaktivieren des Metadatendienstes und Erstellen einer Platzierungsgruppe.

   Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud is instance-create.

2. Führen Sie anschließend den folgenden Befehl details aus, um zu überprüfen, ob Ihre neue Instanz angezeigt wird und Sie die für die neue Instanz erstellten Netzwerkschnittstellen einsehen können. VSI-ID ist `0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0` die VSI-ID, die bei der Erstellung der Instanz im vorherigen Schritt zugewiesen wurde.

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

   Für dieses Beispiel wird die folgende Antwort angezeigt. Der Status wird nun als läuft angezeigt. Prüfen Sie den Abschnitt Netzwerkschnittstellen, um die ID der Netzwerkschnittstelle zu ermitteln.

   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. Fordern Sie eine Floating-IP-Adresse für Ihre Instanz an, indem Sie den folgenden Befehl ausführen. Ersetzen Sie durch FLOATING_IP_NAME den Namen der Floating-IP und ersetzen Sie TARGET_INTERFACE durch die ID der Netzwerk-Schnittstelle der Instanz, die Sie im vorherigen Schritt ermittelt haben. Wenn Ihre Instanz eine virtuelle Netzwerkschnittstelle (VNI) verwendet, nutzen Sie die Option --vni anstelle von --nic und geben Sie den Namen oder die ID der VNI an, wie im zweiten Beispiel gezeigt.

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

   VNI:

   ibmcloud is floating-ip-reserve \
       FLOATING_IP_NAME \
       --vni VNI_NAME_OR_ID
   

Der für die Floating-IP angegebene Name lautet my-floatingip. 0717-4db768bb-65c3-4045-8712-523e62eeabd2 ist die ID der Netzwerkschnittstelle für die VSI, die im vorherigen Schritt angezeigt wurde.

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

Für dieses Beispiel wird eine Antwort ähnlich der folgenden Ausgabe angezeigt:

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

Record the floating IP `Address` to use later.

For a full list of command options, see [ibmcloud is floating-ip-reserve](/docs/vpc?topic=vpc-vpc-reference#floating-ip-reserve).

Sie benötigen weitere Hilfe? Dann können Sie stets den Befehl ibmcloud is instance-create --help ausführen, um Hilfe zur Instanzerstellung aufzurufen.

Bereitstellung aus einem privaten Katalogbild

Sobald Sie die erforderlichen Werte kennen, führen Sie den Befehl ibmcloud is instance-create damit aus. Außerdem müssen Sie einen eindeutigen Namen für die Instanz angeben.

Führen Sie die folgenden Schritte aus, um über die CLI ein VSI aus einem privaten Katalogangebot oder einer Katalogangebotsversion zu erstellen.

1. Erstellen Sie eine Instanz mit dem folgenden Befehl.

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 \

Wenn Sie beispielsweise eine Instanz mit dem Namen my-instance in us-south-2 erstellen und das Profil bx2-2x8 sowie das Katalogangebot verwenden, sieht Ihr instance-create Befehl in etwa wie im folgenden Beispiel aus.

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/a1234567: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\

Dabei werden die folgenden Argumente und Optionswerte verwendet.

  * INSTANZ_NAME: `my-instance`
  * VPC: `r006-35b9cf35-616e-462e-a145-cf8db4062fcf`
  * ZONENNAME: `us-south-2`
  * PROFIL_NAME: `bx2-2x8`
  * Teilnetz: `0717-198db988-3b9b-4cfa-9dec-0206420d37d0`
  * KATALOG-ANGEBOT: ist `crn:v1:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d`
  * TASTEN: `r006-89ec781c-9630-4f76-b9c4-a7d204828d61`
  * PLATZIERUNG_GRUPPE: `c5f1f366-b92a-4080-991a-aa5c2e33d96b`

Informationen zu den Netzwerkschnittstellen, die für die neue Instanz erstellt werden, werden nach der Erstellung der Instanz nicht zurückgegeben. Sie können die Informationen mit dem Befehl ibmcloud is instance INSTANCE anzeigen, wie im folgenden Schritt beschrieben.

Der Status des VSI wird so lange als ausstehend angezeigt, bis die Instanz erstellt wurde.

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud is instance-create.

1. Führen Sie als Nächstes den folgenden Befehl instance details aus, um zu überprüfen, ob Sie Ihre neue Instanz sehen und die Netzwerkschnittstellen anzeigen können, die für die neue Instanz erstellt wurden. Geben Sie hierfür die ID an INSTANCE, die Ihrem neuen VSI im vorherigen Schritt zugewiesen wurde.

ibmcloud is instance INSTANCE

Der Status wird nun als läuft angezeigt. Prüfen Sie den Abschnitt Netzwerkschnittstellen, um die ID der Netzwerkschnittstelle zu ermitteln.

1. Fordern Sie eine Floating-IP-Adresse für Ihre Instanz an, indem Sie den folgenden Befehl ausführen. Ersetzen Sie durch FLOATING_IP_NAME den Namen der Floating-IP und ersetzen Sie TARGET_INTERFACE durch die ID der Netzwerkschnittstelle, die Sie im vorherigen Schritt ermittelt haben. Wenn Ihre Instanz eine virtuelle Netzwerkschnittstelle (VNI) verwendet, nutzen Sie die Option --vni anstelle von --nic und geben Sie den Namen oder die ID der VNI an, wie im zweiten Beispiel gezeigt.

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

VNI:

ibmcloud is floating-ip-reserve \
    FLOATING_IP_NAME \
    --vni VNI_NAME_OR_ID

Zeichnen Sie die schwebende IP `Address` zur späteren Verwendung auf.

Eine vollständige Liste der Befehlsoptionen finden Sie unter [ibmcloud is floating-ip-reserve](/docs/vpc?topic=vpc-vpc-reference#floating-ip-reserve).

Sie benötigen weitere Hilfe? Dann können Sie stets den Befehl ibmcloud is instance-create --help ausführen, um Hilfe zur Instanzerstellung aufzurufen.

Bereitstellung aus einem bestehenden Volumen

Sobald Sie die erforderlichen Werte kennen, geben Sie sie zum Ausführen des Befehls instance-create an. Außerdem müssen Sie einen eindeutigen Namen für die Instanz angeben.

Führen Sie die folgenden Schritte aus, um eine VSI aus einem bootfähigen Volume zu erstellen, einschließlich der Anbindung des Volumes.

1. Erstellen Sie eine Instanz mit dem folgenden Befehl.

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 \

Wenn Sie beispielsweise eine Instanz mit dem Namen my-instance in us-south-1 erstellen und das Profil bx2-2x8 sowie ein vorhandenes Startvolume verwenden, sieht Ihr instance-create Befehl in etwa wie im folgenden Beispiel aus.

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\

Ein Beispiel für eine JSON-Datei für die Datenträgerzuordnung finden Sie unter JSON-Datei für Datenträgerzuordnung erstellen. Sie können auch Benutzer-Tags für die Volumes in den Volume-Anhang aufnehmen.

Informationen zu den Netzwerkschnittstellen, die für die neue Instanz erstellt werden, werden nach der Erstellung der Instanz nicht zurückgegeben. Sie können die Informationen mit dem Befehl ibmcloud is instance INSTANCE anzeigen, wie im nächsten Schritt beschrieben.

Der Status wird als ausstehend angezeigt, bis die Instanz erstellt wurde.

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud is instance-create.

1. Führen Sie als Nächstes den folgenden Befehl instance details aus, um zu überprüfen, ob Sie Ihre neue Instanz sehen und die Netzwerkschnittstellen anzeigen können, die für die neue Instanz erstellt wurden. Geben Sie hierfür die ID an INSTANCE, die Ihrem neuen VSI im vorherigen Schritt zugewiesen wurde.

ibmcloud is instance INSTANCE

Der Status wird nun als läuft angezeigt. Prüfen Sie den Abschnitt Netzwerkschnittstellen, um die ID der Netzwerkschnittstelle zu ermitteln.

1. Fordern Sie eine Floating-IP-Adresse für Ihre Instanz an, indem Sie den folgenden Befehl ausführen. Ersetzen Sie durch FLOATING_IP_NAME den Namen der Floating-IP und ersetzen Sie TARGET_INTERFACE durch die ID der Netzwerkschnittstelle, die Sie im vorherigen Schritt ermittelt haben. Wenn Ihre Instanz eine virtuelle Netzwerkschnittstelle (VNI) verwendet, nutzen Sie die Option --vni anstelle von --nic und geben Sie den Namen oder die ID der VNI an, wie im zweiten Beispiel gezeigt.

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

VNI:

ibmcloud is floating-ip-reserve \
    FLOATING_IP_NAME \
    --vni VNI_NAME_OR_ID

Zeichnen Sie die schwebende IP Address zur späteren Verwendung auf.

Eine vollständige Liste der Befehlsoptionen finden Sie unter ibmcloud is floating-ip-reserve.

Sie benötigen weitere Hilfe? Dann können Sie stets den Befehl ibmcloud is instance-create --help ausführen, um Hilfe zur Instanzerstellung aufzurufen.

Erstellen einer Instanz mit mehreren Data-Volumes und dynamischer Bandbreitenzuweisung über die CLI

Ausgewählte Compute-Profile unterstützen die gepoolte Bandbreitenzuweisung für Datenvolumen. Für die meisten Berechnungsprofile ist die Eigenschaft --volume-bandwidth-qos-mode standardmäßig auf weighted eingestellt. Bei der Verwendung von weighted wird die Bandbreite der Volumes anteilig auf die Datenvolumes verteilt. Durch Angabe des Wertes pooled aktivieren Sie die dynamische Bandbreitenzuweisung.

Im folgenden Beispiel wird der Befehl ibmcloud is instance-create zum Erstellen des VSI verwendet und die Option mit --volume-bandwidth-qos-mode dem Wert angegeben 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

Die Datei myvolume-attachments.json kann bis zu 12 Datenträger enthalten, die an den virtuellen Server angeschlossen werden sollen. Sehen Sie sich das folgende Beispiel an:

[
  {"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}
]

Erstellen einer Instanz mit vertraulichen Berechnungen

Select availability

Vertrauliches Rechnen mit Intel SGX für VPC und vertrauliches Rechnen mit Intel TDX für VPC sind in den Regionen Dallas (us-south), Washington DC (us-east) und Frankfurt (eu-de) verfügbar.

Boot-Volumes der zweiten Generation mit dem Volume-Profil sdp unterstützen noch kein sicheres Booten. Wenn Secure-Boot erforderlich ist, verwenden Sie ein Boot-Volume mit einem Volume-Profil der ersten Generation.

Sobald Sie die erforderlichen Werte kennen, geben Sie sie zum Ausführen des Befehls ibmcloud is instance-create an. Außerdem müssen Sie einen eindeutigen Namen für die Instanz angeben.

Für confidential-compute-mode müssen Sie entweder sgx oder tdx für die Option angeben.

Führen Sie die folgenden Schritte aus, um ein einfaches VSI zu erstellen, das vertrauliche Rechenvorgänge ermöglicht.

Erstellen Sie eine Instanz mit dem folgenden Befehl.

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

Der folgende Befehl instance-create verwendet zum Beispiel die Beispielwerte, die im Abschnitt " Informationen sammeln" zu finden sind.

   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 \

Dabei werden die folgenden Argumente und Optionswerte verwendet

  * 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`

Erstellen einer Instanz mit sicherem Boot

Select availability

Vertrauliches Rechnen mit Intel SGX für VPC ist nur in den Regionen Dallas (us-south) und Frankfurt (eu-de) verfügbar. Boot-Volumes der zweiten Generation mit dem Volume-Profil sdp unterstützen noch kein sicheres Booten. Wenn Secure-Boot erforderlich ist, verwenden Sie ein Boot-Volume mit einem Volume-Profil der ersten Generation.

Sobald Sie die erforderlichen Werte kennen, geben Sie sie zum Ausführen des Befehls ibmcloud is instance-create an. Außerdem müssen Sie einen eindeutigen Namen für die Instanz angeben.

Für enable-secure-boot müssen Sie entweder true oder false angeben. Der Standardwert ist false.

Führen Sie die folgenden Schritte aus, um ein einfaches VSI zu erstellen, das den sicheren Systemstart ermöglicht.

Erstellen Sie eine Instanz mit dem folgenden Befehl.

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

Der folgende Befehl instance-create verwendet zum Beispiel die Beispielwerte, die im Abschnitt " Informationen sammeln" zu finden sind.

   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 \

Dabei werden die folgenden Argumente und Optionswerte verwendet

  * 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`

Vorbereitende Schritte

Stellen Sie sicher, dass Sie über die erforderlichen Zugriffsrechte verfügen. Um diese Methoden aufzurufen, müssen Ihnen eine oder mehrere IAM-Zugriffsrollen zugewiesen sein, die je nach den aufgeführten Bedingungen die folgenden Aktionen umfassen. Sie können Ihren Zugang überprüfen, indem Sie die Seite Benutzer im Cloud Identity and Access Management Dashboard aufrufen.

Informationen sammeln, um eine Instanz mit der API zu erstellen

Bevor Sie eine Instanz erstellen können, müssen Sie die Details der Instanz kennen, z. B. das Instanzprofil oder das Bild, das Sie verwenden möchten. Sammeln Sie Informationen, indem Sie die folgenden API-Aufrufe tätigen:

Sie können eine Instanz aus einem available, partially_available (Image ist noch nicht in allen Zonen verfügbar) oder deprecated Image bereitstellen. Weitere Informationen zu Image-Lebenszyklen finden Sie unter Benutzerdefinierter Image-Lebenszyklus.

Vergewissern Sie sich, dass das von Ihnen verwendete Profil in der Zone verfügbar ist, in der Sie die Instanz erstellen möchten.

Wenn Sie einen Snapshot von einem anderen Konto verwenden möchten, vergewissern Sie sich zunächst, dass die richtigen IAM-Berechtigungen vorhanden sind. Wenden Sie sich dann an den Eigentümer des Schnappschusses, um die CRN des Schnappschusses zu erfahren.

Einige Profile sind möglicherweise aus einem der folgenden Gründe nicht verfügbar:

• Die Anzahl der Netzwerkschnittstellen des virtuellen Servers überschreitet die Profilgrenzen. Sie können Netzwerkschnittstellen entfernen, um aus mehr Profilen auszuwählen. Weitere Informationen finden Sie unter Größe eines virtuellen Servers anpassen.
• Das ausgewählte Bild enthält einen Ausdruck, dessen Verwendung nicht mit dem Profil kompatibel ist. Wählen Sie in diesen Fällen ein Bild mit einem Ausdruck für die zulässige Verwendung, der mit dem gewünschten Profil kompatibel ist. Weitere Informationen finden Sie unter Hinzufügen von Ausdrücken für die zulässige Verwendung zu benutzerdefinierten Bildern.

Erstellen einer Instanz mit der API

Nachdem Sie die benötigten Informationen abgerufen haben, können Sie mit der POST /instances methode ausführen, um eine Instanz zu erstellen.

Bereitstellung einer Instanz aus einem Standard- oder benutzerdefinierten Image mit der API

Sie können eine Instanz mit einem Standard- oder benutzerdefinierten Bild versehen, indem Sie die Untereigenschaft id des Bildes als Wert der Eigenschaft image angeben.

   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'"
            }
           }'

Bereitstellung einer Instanz aus einem privaten Katalog-Image mit der API

Sie können eine Instanz mit einem privaten Katalogbild versehen, indem Sie die offering_crn oder die version_crn Untereigenschaft des Bildes als Wert der catalog_offering Eigenschaft angeben.

• Erstellen Sie eine Instanz unter Verwendung eines privaten Katalogbildes aus der neuesten Version eines Katalogproduktangebots.

```bash {: pre}
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'"
         }
        }'
```

• Erstellen Sie eine Instanz, indem Sie ein privates Katalogabbild einer bestimmten Version eines Katalogprodukts verwenden.

```bash {: pre}
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'"
         }
        }'
```

Bereitstellung aus einem bestehenden Volumen

Die Wiederverwendung eines vorhandenen bootfähigen Volumes ist schneller als die Erstellung eines neuen Volumes aus einem Snapshot oder einem Image.

Sie können eine Instanz mit einem vorhandenen Volume bereitstellen, indem Sie die Untereigenschaft id oder crn des vorhandenen Volumes als Wert der Eigenschaft boot_volume_attachment angeben.

Das vorhandene bootfähige Volume muss ein unverbundenes bootfähiges Volume sein, das dieselbe Architektur wie das Instanzprofil aufweist. Verwenden Sie den Filter "Listen-Volumes" und verweisen Sie auf die Eigenschaften attachment_state und operating_system, um die Berechtigung eines Volumes anzuzeigen.

Zum Beispiel, um unverbundene Volumes in us-south-1 mit einem x86 Betriebssystem zu sehen.

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"

Standardmäßig wird ein Boot-Volume, das im Rahmen der Bereitstellung einer VSI erstellt wurde, gelöscht, wenn die Instanz gelöscht wird. Sie können dieses Verhalten ändern, indem Sie die Eigenschaft delete_volume_on_instance_delete auf false setzen, wenn Sie die Instanz erstellen oder die Boot-Volume-Anlage aktualisieren.

Verwenden Sie die POST /instances methode, um eine Instanz mit den von Ihnen gesammelten Informationen zu erstellen. Der folgende Aufruf ist ein Beispiel für die Bereitstellung einer Instanz unter Verwendung eines vorhandenen Boot-Volumes.

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"
  }
}'

Boot-Volumes der zweiten Generation mit dem Volume-Profil sdp unterstützen noch kein sicheres Booten. Wenn Secure-Boot erforderlich ist, verwenden Sie ein Boot-Volume mit einem Volume-Profil der ersten Generation.

Weitere Informationen finden Sie unter Instanz erstellen.

Wiederherstellen eines Boot-Volumes aus einem Snapshot und dessen Verwendung zur Bereitstellung einer neuen Instanz

Sie können ein Boot-Volume von einem bootfähigen Snapshot wiederherstellen und dieses Boot-Volume dann bei der Bereitstellung einer Instanz verwenden. Der bootfähige Snapshot muss dasselbe Betriebssystem und dieselbe Architektur haben wie das Instanzprofil.

Geben Sie in der Anfrage POST /instances die Eigenschaft boot_volume_attachment und die ID des bootfähigen Snapshots in der Untereigenschaft source_snapshot an. Alternativ dazu können Sie auch den Namen oder die CRN des Snapshots verwenden. Beispiel:

curl -X POST \
"$vpc_api_endpoint/v1/instances?version=2023-03-07&generation=2" \
-H "Authorization: Bearer $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"
            }
        }
     },
     .
     .
     .
  }'

Weitere Informationen zum Wiederherstellen eines Datenträgers mit der API finden Sie unter Wiederherstellen eines Datenträgers aus einem Snapshot mit der API.

Erstellen einer Instanz mit mehreren Datenträgern und dynamischer Bandbreitenzuweisung mit der API

Ausgewählte Compute-Profile unterstützen die gepoolte Bandbreitenzuweisung für Datenvolumen. Sie können eine VSI programmgesteuert mit mehreren Datenvolumes bereitstellen, indem Sie die Methode instances aufrufen, wie in der folgenden Beispielanfrage gezeigt. Das Beispiel erstellt einen virtuellen Server in us-south-2 zone mit einem 250-GB-Boot-Volume und drei 3-TB-Datenvolumes. Die storage_qos_mode ist auf pooled eingestellt, um eine dynamische Bandbreitenzuweisung zu ermöglichen.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-07-12&generation=2" \
-H "Authorization: Bearer $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
}'

Erstellen einer Instanz mit vertraulicher Datenverarbeitung

Select availability

Vertrauliches Rechnen mit Intel SGX für VPC und vertrauliches Rechnen mit Intel TDX für VPC sind in den Regionen Dallas (us-south), Washington DC (us-east) und Frankfurt (eu-de) verfügbar.

Boot-Volumes der zweiten Generation mit dem Volume-Profil sdp unterstützen noch kein sicheres Booten. Wenn Secure-Boot erforderlich ist, verwenden Sie ein Boot-Volume mit einem Volume-Profil der ersten Generation.

Um eine Instanz mit vertraulicher Berechnung bereitzustellen, fügen Sie die Eigenschaft confidential_compute_mode hinzu und setzen sie entweder auf sgx oder 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"
           }'

Erstellen einer Instanz mit Secure Boot

Um eine Instanz mit Secure Boot bereitzustellen, fügen Sie die Eigenschaft enable_secure_boot hinzu und setzen Sie sie auf 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"
           }'

Boot-Volumes der zweiten Generation mit dem Volume-Profil sdp unterstützen noch kein sicheres Booten. Wenn Secure-Boot erforderlich ist, verwenden Sie ein Boot-Volume mit einem Volume-Profil der ersten Generation.

Vorbereitende Schritte

Stellen Sie sicher, dass Sie Terraform für VPC einrichten.

Privaten Katalog erstellen

Dieser Schritt ist optional. Wenn Sie Bilder aus einem privaten Katalog freigeben möchten, muss der private Katalog zuerst erstellt werden. Wenn Sie ein Katalog-Image auswählen, das zu einem anderen Konto gehört, lesen Sie den Abschnitt Verwenden von kontoübergreifenden Image-Referenzen in einem privaten Katalog in Terraform für weitere Überlegungen und Einschränkungen.

Informationen zum Erstellen einer Instanz mithilfe von Terraform sammeln

Sind Sie bereit zum Erstellen einer Instanz? Bevor Sie den Befehl ibm_is_instance ausführen können, müssen Sie die Details zur Instanz kennen, z. B. welches Profil oder Image Sie verwenden möchten.

Erfassen Sie die folgenden Informationen mit dem Befehl DataSource.

1. Sammeln Sie Details zum Instanzprofil. Führen Sie den folgenden Befehl für das von Ihnen ausgewählte Profil aus. Siehe x86 Instanzprofile für eine Liste der verfügbaren Profile. Weitere Informationen finden Sie in der Terraform-Dokumentation zu ibm_is_instance_profiles. Verwenden Sie ein Instanzprofil, indem Sie auf die Datenquelle Instanzprofil verweisen. Weitere Informationen finden Sie in der Terraform-Dokumentation zu ibm_is_instance_profile.

• Sammeln von Instanzprofildetails für ein bestimmtes Profil

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

1. Listen Sie die verfügbaren Images zur Erstellung Ihrer Instanz auf. Sie können ein Archivbild, ein benutzerdefiniertes Bild aus Ihrem Konto oder ein Bild aus einem privaten Katalog verwenden, das für Ihr Konto freigegeben wurde. Weitere Informationen finden Sie in der Terraform-Dokumentation zu ibm_is_image. Wenn Sie ein Image verwenden möchten, das aus einem privaten Katalog freigegeben wurde, lesen Sie die Terraform-Dokumentation zu ibm_cm_version oder ibm_cm_offering_instance.

Sie können eine Instanz aus einem available, partially_available (Image ist noch nicht in allen Zonen verfügbar) oder deprecated Image bereitstellen. Weitere Informationen zu Image-Lebenszyklen finden Sie unter Benutzerdefinierter Image-Lebenszyklus.

Vergewissern Sie sich, dass das von Ihnen verwendete Profil in der Zone verfügbar ist, in der Sie die Instanz erstellen möchten.

Allowed-use expressions: The image that you select determines the profiles that are available to create the VSI. During the creation of a VSI with images that use an allowed-use expression, the information that is provided in the allowed-use properties is then evaluated against a potential VSI to determine whether that image can be used to create the VSI. Stock images use defined allowed-use expressions. You must define any allowed-use expressions for custom images. For more information, see [Adding allowed-use expressions to custom images](/docs/vpc?topic=vpc-custom-image-allowed-use-expressions&interface=ui).
{: note}

• Wählen Sie ein Standardbild oder ein benutzerdefiniertes Bild aus Ihrem Konto für Ihre Instanz.

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

• Wählen Sie ein Bild aus, das aus einem privaten Katalog für die Instanz freigegeben ist. Weitere Informationen finden Sie in der Terraform-Dokumentation zu ibm_is_images. Sie können ein Bild aus der Liste auswählen, um die Instanz zu erstellen, wie im Abschnitt Gehen Sie zum Abschnitt Erstellen einer Instanz mithilfe von Terraform.

Wenn Sie ein Katalogbild auswählen, das zu einem anderen Konto gehört, müssen Sie weitere Überlegungen anstellen und Einschränkungen beachten. Siehe Verwendung von kontoübergreifenden Bildreferenzen in einem privaten Katalog in Terraform.

  - To list all available private catalog image offerings, run the following command.

      ```terraform {: codeblock}
      data "ibm_is_images" "example_images" {
      catalog_managed = true
      }
      ```

• Auflistung von Profilen und kompatiblen Bildern mit Hilfe von Ausdrücken für die zulässige Verwendung

  • Auflisten von Instanzprofilen, die mit einem Image kompatibel sind

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

  • Instanzprofile auflisten, die mit einem Volume kompatibel sind

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

  • Instanzprofile auflisten, die mit einem Snapshot kompatibel sind

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

1. Erstellen Sie eine VPC-Ressource oder verwenden Sie eine vorhandene VPC, indem Sie auf die VPC-Datenquelle verweisen. Weitere Informationen finden Sie in der Terraform-Dokumentation zu ibm_is_vpc.

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

1. Erstellen Sie eine Teilnetzressource oder verwenden Sie ein vorhandenes Teilnetz, indem Sie auf die Teilnetzdatenquelle verweisen. Weitere Informationen finden Sie in der Terraform-Dokumentation zu 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"
}

1. Erstellen Sie eine ssh-Schlüssel-Ressource oder verwenden Sie einen vorhandenen ssh-Schlüssel, indem Sie auf die ssh-Schlüssel-Datenquelle verweisen. Weitere Informationen finden Sie in der Terraform-Dokumentation zu 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"
}

SSH-Schlüssel können entweder RSA oder Ed25519 sein. Sie können neue RSA-Schlüsselpaare mit Hilfe der Benutzeroberfläche erzeugen. Bereits vorhandene RSA- und ED25519 SSH-Schlüssel können hochgeladen werden. Ed25519 kann nur verwendet werden, wenn das Betriebssystem diesen Schlüsseltyp unterstützt. Ed25519 kann nicht mit Windows- oder VMware-Images verwendet werden.

1. Erstellen Sie eine subnet_reserved_ip-Ressource oder verwenden Sie eine vorhandene subnet_reserved_ip, indem Sie auf die Datenquelle subnet_reserved_ip verweisen. Weitere Informationen finden Sie in der Terraform-Dokumentation zu 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")}"
}

Erstellen einer Instanz mit Terraform

Um Terraform zu verwenden, laden Sie die Terraform-CLI herunter und konfigurieren Sie das IBM Cloud Provider-Plugin. Weitere Informationen finden Sie unter Erste Schritte mit Terraform.

Erstellen Sie die Instanz mit Hilfe eines der folgenden Beispiele. Weitere Informationen finden Sie in der Terraform-Dokumentation zu ibm_is_instance.

Zulässige Formulierungen: Das von Ihnen ausgewählte Image bestimmt, welche Profile zum Erstellen der VSI verfügbar sind. Bei der Erstellung eines VSI mit Images, die einen Ausdruck zur zulässigen Nutzung enthalten, werden die in den Eigenschaften zur zulässigen Nutzung angegebenen Informationen anhand eines potenziellen VSI ausgewertet, um festzustellen, ob dieses Image zur Erstellung des VSI verwendet werden kann. Bei Archivbildern werden bestimmte Ausdrücke für die zulässige Verwendung verwendet. Sie müssen alle Ausdrücke für die erlaubte Verwendung von benutzerdefinierten Bildern definieren. Weitere Informationen finden Sie unter Hinzufügen von Ausdrücken für die zulässige Verwendung zu benutzerdefinierten Bildern.

Führen Sie einen der folgenden Terraform-Befehle aus, je nachdem, welches Image Sie verwenden möchten.

• Erstellen Sie eine Instanz, indem Sie ein Standardbild oder ein benutzerdefiniertes Bild aus Ihrem Konto für Ihre Instanz verwenden.

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]
}

• Erstellen Sie eine Instanz, die ein privates, vom Katalog verwaltetes Image verwendet. Wenn Sie das Volume-Profil der zweiten Generation für das Boot-Volume festlegen, können Sie benutzerdefinierte Kapazitäts-, IOPS- und Bandbreitengrenzen angeben.

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"
   }
}

• Erstellen Sie eine Instanz, indem Sie einen Snapshot mit einem Ausdruck für erlaubte Nutzung von Ihrem Konto für Ihre Instanz verwenden.

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"
    }
  }
}