Virtual Server-Instanzen erstellen

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 Befehlszeile 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, beispielsweise 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}

Zeigen Sie die verfügbaren Startvolumes für die Erstellung Ihrer Instanz an. 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 Befehlszeile

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, verwenden Sie diese, um den ibmcloud is instance-create Befehl auszuführen. Außerdem müssen Sie einen eindeutigen Namen für die Instanz angeben.

Führen Sie die folgenden Schritte aus, um eine grundlegende virtuelle Serverinstanz aus einem Standard-Image über die CLI zu erstellen. Standardmäßig wird ein Boot-Volume an die Instanz angehängt, wenn die Instanz erstellt wird. Für die meisten virtuellen Serverinstanzen beträgt die Standardgröße des Boot-Volumes 100 GB. Die Standardgröße des Startvolumens für eine virtuelle Serverinstanz z/OS 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 Reaktion 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 so lange 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 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. 0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0 ist die ID der virtuellen Serverinstanz, die beim Erstellen 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 mit dem folgenden Befehl eine variable IP-Adresse an, die Ihrer Instanz zugeordnet werden soll. Der Name, der für die schwebende IP angegeben wird, lautet my-floatingip. 0717-4db768bb-65c3-4045-8712-523e62eeabd2 ist die ID der Netzwerkschnittstelle für die virtuelle Serverinstanz, 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
   

   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.

Bereitstellung aus einem privaten Katalogbild

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

Führen Sie die folgenden Schritte aus, um eine virtuelle Serverinstanz aus einem privaten Katalogangebot oder einer Katalogangebotsversion über die CLI 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 und das bx2-2x8 Profil und das Katalogangebot verwenden, sieht Ihr Befehl „ instance-create “ 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 der virtuellen Serverinstanz wird als ausstehend angezeigt, bis die Instanz erstellt ist.

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

2. 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 unter INSTANCE die ID an, die Ihrer neuen virtuellen Serverinstanz 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.

3. Fordern Sie mit dem folgenden Befehl eine variable IP-Adresse an, die Ihrer Instanz zugeordnet werden soll. Geben Sie für FLOATING_IP_NAME einen Namen für Ihre Floating IP und für TARGET_INTERFACE die ID der Netzwerkschnittstelle an, die Sie im vorherigen Schritt ermittelt haben.

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

   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.

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 virtuelle Serverinstanz von einem bootfähigen Volume zu erstellen, das einen Volume-Anhang enthält.

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 und das bx2-2x8 Profil sowie ein vorhandenes Startvolume verwenden, sieht Ihr Befehl instance-create 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 so lange als „ausstehend“ angezeigt, bis die Instanz erstellt wurde.

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

2. 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 unter INSTANCE die ID an, die Ihrer neuen virtuellen Serverinstanz 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.

3. Fordern Sie mit dem folgenden Befehl eine variable IP-Adresse an, die Ihrer Instanz zugeordnet werden soll. Geben Sie für FLOATING_IP_NAME einen Namen für Ihre Floating IP und für TARGET_INTERFACE die ID der Netzwerkschnittstelle an, die Sie im vorherigen Schritt ermittelt haben.

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

   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.

Das folgende Beispiel verwendet den Befehl ibmcloud is instance-create, um die virtuelle Serverinstanz zu erstellen, und gibt die Option --volume-bandwidth-qos-mode mit dem Wert pooled an.

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

Verfügbarkeit auswählen

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.

Gehen Sie wie folgt vor, um eine einfache virtuelle Serverinstanz zu erstellen, die vertrauliche Datenverarbeitung 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

Verfügbarkeit auswählen

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.

Gehen Sie wie folgt vor, um eine einfache virtuelle Serverinstanz zu erstellen, die sicheres Booten 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 über die 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'"
            }
           }'