Instanzvorlage erstellen

Sie können eine Instanzvorlage erstellen, um die Instanzdetails für die Bereitstellung eines oder mehrerer virtueller Server festzulegen. Wenn Ihre Instanzvorlage erstellt wird, können Sie sie verwenden, um einzelne virtuelle Serverinstanzen bereitzustellen, oder Sie können gleichzeitig mehrere Serverinstanzen als Teil der Instanzgruppe bereitstellen.

Instanzvorlage über die Benutzerschnittstelle erstellen

Die Instanzvorlage definiert die Details der virtuellen Serverinstanzen, die von der Vorlage erstellt werden. Geben Sie zum Beispiel das Profil (vCPU und Speicher), das Image, zugeordnete Datenträger und Netzschnittstellen für die Imagevorlage an.

Führen Sie zum Erstellen einer Instanzvorlage die folgenden Schritte aus:

  1. In der IBM Cloud Konsole, klicken Sie auf Navigationsmenü SymbolMenü-Symbol > Infrastruktur VPC-Symbol > Compute > Instanzvorlagen.
  2. Klicken Sie auf „Neue Instanzvorlage“ und geben Sie die in Tabelle 1 aufgeführten Informationen ein.
  3. Klicken Sie auf Instanzvorlage erstellen, wenn die Informationen vollständig sind.

Wenn Sie eine Instanzvorlage erstellen, werden Validierungsschritte durchgeführt, um sicherzustellen, dass Sie Ihre Vorlage zur Bereitstellung einer virtuellen Serverinstanz verwenden können.

Auswahl der Instanzvorlagen
Feld Wert
Standort Standorte bestehen aus Regionen (spezielle geografische Gebiete) und Zonen (fehlertolerante Rechenzentren in einer Region). Wählen Sie die geografische Region, die Region und die Zone aus, in der Ihre virtuelle Serverinstanz erstellt werden soll.
Name Für Ihre Virtual Server-Instanz ist ein Name erforderlich.
Ressourcengruppe Wählen Sie eine Ressourcengruppe für die Instanz aus.
Image

Klicken Sie auf Bild ändern, um ein Bild auszuwählen. Auf der Seite 'Image auswählen' können Sie ein Image, ein angepasstes Image, ein Katalogimage, eine Momentaufnahme oder einen vorhandenen Datenträger auswählen. Wenn der geografische Standort, an dem Sie eine Instanz bereitstellen, dies unterstützt, können Sie eine der folgenden Möglichkeiten wählen:

  • x86 architektur

  • Veraltet s390x Architektur

Nachdem Sie Ihr Image ausgewählt haben, klicken Sie auf Speichern.

  • Archivbilder: Sie können aus den verfügbaren Archivbildern auswählen. Für weitere Informationen siehe:

  • x86 virtuelle Serverbilder

  • Veraltets390x Virtuelle Serverbilder

  • Benutzerdefinierte Bilder: Ein benutzerdefiniertes Bild kann ein Bild sein, das Sie anpassen und auf IBM Cloud Object Storage hochladen, das Sie dann in IBM Cloud VPC importieren können. Sie können auch ein angepasstes Image verwenden, das aus einem Bootdatenträger erstellt wurde. Weitere Informationen über benutzerdefinierte Bilder finden Sie unter Erste Schritte mit benutzerdefinierten Bildern.

  • Katalogbilder: Ein Katalogbild ist ein benutzerdefiniertes Bild, das in einen privaten Katalog importiert wird. Weitere Informationen zu Katalog-Images finden Sie unter VPC-Überlegungen bei der Verwendung benutzerdefinierter Images in einem privaten Katalog.

  • Schnappschuss: Sie können aus den verfügbaren Schnappschüssen auswählen. Weitere Informationen finden Sie unter Über Block Storage-Snapshots für VPC.

  • Vorhandenes Volumen: Sie können aus vorhandenen Volumes auswählen. Das angegebene Volume darf nicht zugeordnet sein und muss über ein Betriebssystem verfügen, dessen Architektur mit der des Instanzprofils übereinstimmt.
    Die Architektur s390x ist veraltet. Sie können auf ein lokales Bereitstellungsmodell migrieren. Für weitere Informationen siehe Linux on IBM Z and LinuxONE. Weitere Informationen zur Verwerfung finden Sie in der Ankündigung zur Verwerfung von Diensten.

Profil Klicken Sie auf Profil ändern, um aus allen verfügbaren vCPU und RAM-Kombinationen auszuwählen. Die Profilfamilien sind Balanced, Compute, Memory, Ultra High Memory, Very High Memory, Storage Optimized, GPU, Flex, Confidential Compute und High Frequency.

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

Weitere Informationen hierzu finden Sie unter Profile.

Einige Profile sind möglicherweise nicht verfügbar, da die Anzahl der Netzwerkschnittstellen auf dem virtuellen Server die Profilgrenzen überschreitet. Sie können Netzwerkschnittstellen entfernen, um aus mehr Profilen auszuwählen. Weitere Informationen finden Sie unter Größe eines virtuellen Servers anpassen.

Einige Profile sind möglicherweise nicht verfügbar, da das ausgewählte Bild eine Nutzungsbedingung enthält, die 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.

Threads pro Kern Die Anzahl der Threads pro Kern bietet Ihnen die Flexibilität, Ihre Arbeitslast zu optimieren. Zwar wird die Anzahl der Threads pro Kern für alle Profile angezeigt, Sie können diese jedoch nur für die Profilfamilie „High Frequency“ bearbeiten. Bei Hochfrequenzprofilen beträgt der Standardwert 2, kann jedoch auf 1 angepasst werden.
SSH-Schlüssel Sie müssen einen vorhandenen öffentlichen SSH-Schlüssel auswählen oder auf SSH-Schlüssel erstellen klicken, um einen neuen zu erstellen. Sie können nur RSA-SSH-Schlüssel erstellen. Für ED25519 SSH-Schlüssel, Sie müssen die Schlüsselinformationen hochladen. Weitere Informationen zum Erstellen eines SSH-Schlüssels finden Sie unter SSH-Schlüssel über die Benutzerschnittstelle erstellen. SSH-Schlüssel werden verwendet, um eine sichere Verbindung zu der Instanz herzustellen, nachdem sie aktiviert wurde.

Hinweis:** Alphanumerische Kombinationen sind auf 100 Zeichen begrenzt. SSH-Schlüssel können entweder RSA oder Ed25519 sein. Ed25519 kann nur verwendet werden, wenn das Betriebssystem diesen Schlüsseltyp unterstützt. Ed25519 kann nicht mit Windows- oder VMware-Images verwendet werden.

Weitere Informationen finden Sie unter Erste Schritte mit SSH-Schlüsseln.

Bootdatenträger Die standardmäßige Größe des Bootdatenträgers beträgt für alle Profile 100 GB. Sie können eine größere Boot-Volume-Kapazität angeben, bis zu 250 GB, wenn Sie Volume-Profile der ersten Generation verwenden, und bis zu 32.000 GB, wenn Sie das Profil sdp verwenden, je nachdem, was das Image benötigt. Sie können auch Benutzertags angeben.
Datenvolumen Sie können einzelne oder mehrere sekundäre Datenträger hinzufügen, die eingeschlossen werden sollen, wenn Sie die Instanz bereitstellen. Um Datenträger hinzuzufügen, klicken Sie auf Erstellen. Sie können vom Kunden verwaltete Verschlüsselung und Benutzertags für den Datenträger angeben.
Virtuelle private Cloud Geben Sie die IBM Cloud VPC-Instanz an, in der Sie Ihre Instanz erstellen wollen. Sie können eine vorhandene VPC verwenden oder eine neue VPC erstellen. Klicken Sie zum Erstellen einer neuen VPC auf Neue VPC.
Netzschnittstellen Definiert die Netzverbindung zu IBM Cloud VPC. Standardmäßig ist die neue Option Netzanschluss mit virtueller Netzschnittstelle für Ihre Instanzvorlage ausgewählt. Alternativ können Sie die traditionelle Option Instance network interface auswählen. Welcher Typ von Netzschnittstellenoption Sie bei der Bereitstellung des virtuellen Servers auswählen, bleibt über den Lebenszyklus des virtuellen Servers bestehen. Nachdem Sie den Typ Ihrer Netzwerkschnittstelle ausgewählt haben, können Sie auf das Bearbeiten-Symbol Bearbeiten-Symbol klicken, um die Details der Netzwerkschnittstelle zu aktualisieren, zum Beispiel das Subnetz oder die zugehörige Sicherheitsgruppe.
Benutzerdaten Sie können Benutzerdaten hinzufügen, mit denen allgemeine Konfigurationstasks oder bestimmte Scripts automatisch ausgeführt werden können. Weitere Informationen hierzu finden Sie unter Benutzerdaten.
Metadaten Standardmäßig deaktiviert; ermöglicht es der anhand dieser Vorlage erstellten Instanz, Metadaten über sich selbst zu erfassen. Klicken Sie auf den Schalter, um den Metadatendienst zu aktivieren. Weitere Informationen finden Sie unter Über Metadaten für VPC.
Zu dediziertem Host hinzufügen Sie können die virtuelle Serverinstanz einem dedizierten Host hinzufügen und die Instanz in einem Single-Tenant-Bereich erstellen. Um eine dedizierte Instanz bereitzustellen, müssen Sie über einen dedizierten Host verfügen oder einen dedizierten Host erstellen.
Zur Platzierungsgruppe hinzufügen Sie können eine Platzierungsgruppe für die Instanz auswählen. Klicken Sie auf die Umschaltfläche, um Platzierungsgruppen zu aktivieren. Wählen Sie anschließend eine Platzierungsgruppe für die Instanz aus oder erstellen Sie sie. Wenn Sie eine Platzierungsgruppe hinzufügen, wird die Instanz entsprechend der Platzierungsgruppenstrategie platziert. Mehr erfahren Sie im Abschnitt Informationen zu Platzierungsgruppen.
Dynamische Bandbreitenzuweisung Klicken Sie auf die Umschalttaste, um die gepoolte Bandbreitenzuweisung für angeschlossene Datenvolumes zu aktivieren. Diese Funktion wird für ausgewählte Compute-Profile unterstützt.
Automatischer Neustart nach Hostfehler Die Einstellung ist standardmäßig aktiviert. Um den automatischen Neustart des Hostfehlers zu inaktivieren, klicken Sie auf die Umschaltfläche. Weitere Informationen finden Sie unter Richtlinien für die Fehlerbehebung bei Hostfehlern.

Instanzvorlage über die Befehlszeilenschnittstelle erstellen

Die Instanzvorlage definiert die Details der virtuellen Serverinstanzen, die von der Vorlage erstellt werden. Geben Sie beispielsweise das Profil ( vCPU und Speicher), das Image, die zugeordneten Volumes und die Netzwerkschnittstellen für die Instanzvorlage an. Sie können eine oder mehrere Instanzvorlagen in Ihrer IBM Cloud VPC mithilfe der Befehlszeilenschnittstelle (CLI) erstellen.

Weitere Informationen zum Erstellen einer virtuellen Serverinstanz mit einem angepassten Image, das aus einem privaten Katalog gemeinsam genutzt wird, finden Sie unter Bereitstellung aus einem privaten Katalogimage.

Vorbereitende Schritte

Stellen Sie sicher, dass Sie Ihre IBM Cloud®-CLI-Umgebung und Ihre IBM Cloud VPC einrichten.

Informationen zum Erstellen einer Instanzvorlage zusammenstellen

Sind Sie bereit zum Erstellen einer Instanzvorlage? Bevor Sie den ibmcloud is instance-template-create Befehl müssen Sie die Details sammeln, die Sie für Ihre Instanzvorlage und Befehlsoptionen einschließen müssen. Sie benötigen beispielsweise die ID oder den Namen der VPC und den Namen der Zone, in der die Instanzvorlage erstellt werden soll. Sie benötigen außerdem den Namen des Instanzprofils, das Sie verwenden möchten, und die ID oder den Namen des Subnetzes, in dem die Vorlage erstellt werden soll.

Stellen Sie die folgenden erforderlichen Details für die Instanzvorlage zusammen.

Erforderliche Details der Instanzvorlage
Details für die Instanzvorlage Befehl zum Auflisten Referenzdokumentation zur VPC-CLI
VPC ibmcloud is vpcs Alle VPCs auflisten
Zone ibmcloud is zones Alle Zonen in der Region auflisten
Profil ibmcloud is instances Alle virtuellen Serverinstanzen auflisten
Teilnetz ibmcloud is subnets Alle Teilnetze auflisten
Image ibmcloud is image Alle Images auflisten
Schlüssel ibmcloud is keys Alle Schlüssel auflisten
Platzierungsgruppen ibmcloud is placement-groups Alle Platzierungsgruppen auflisten

Vergewissern Sie sich, dass das gewünschte Profil in der Zone verfügbar ist, in der Sie die Instanz erstellen wollen.

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

  1. Listen Sie die Regionen auf, die Ihrem Konto zugeordnet sind.

    ibmcloud is regions
    

    Beispiel:

    $ 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
    
  2. Wechseln Sie zu Ihrer Zielregion.

    ibmcloud target -r <region-name>
    
  3. Listen Sie die Zonen auf, die der Zielregion zugeordnet sind.

    ibmcloud is zones
    

    Im folgenden Beispiel wird der Befehl in der us-south Region ausgeführt und die Ausgabe zeigt die verfügbaren Zonen in der Region an.

    $ 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
    
  4. Listen Sie die IBM Cloud VPC-Instanzen auf, die Ihrem Konto zugeordnet sind.

    ibmcloud is vpcs
    

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

    ID                                          Name                         Status      Classic access   Default network ACL                   Default security group                 Resource group
    r006-0d37163a-701d-4ad6-9ece-a3e34cf28935   cdl                          available   false            acl-test-1                            pedicure-budding-providing-excluded    Default
    r006-212def4b-93f0-4b9a-a331-94178b99d474   cli-test-1                   available   false            surprise-pacifier-cubicle-demystify   foyer-alongside-rug-zen                Default
    

    Wenn keine zur Verfügung steht, können Sie eine IBM Cloud VPC mithilfe des Befehls ibmcloud is vpc-create erstellen. Weitere Informationen zum Erstellen einer IBM Cloud VPC-Instanz finden Sie in der CLI-Referenz für IBM Cloud VPC.

  5. Listen Sie die verfügbaren Profile zur Erstellung Ihrer Instanzvorlage auf.

    ibmcloud is instance-profiles
    

    Die Ausgabe des Befehls sieht ähnlich wie im folgenden Beispiel aus.

    Name               vCPU Manufacturer   Architecture   Family              vCPUs   Memory(GiB)   Bandwidth(Mbps)   Volume bandwidth(Mbps)   GPUs   Storage(GB)
    bx2-2x8            intel               amd64          balanced            2       8             4000              1000                     -      -
    bx2d-2x8           intel               amd64          balanced            2       8             4000              1000                     -      1x75
    bx2-4x16           intel               amd64          balanced            4       16            8000              2000                     -      -
    bx2d-4x16          intel               amd64          balanced            4       16            8000              2000                     -     1x150
    bx2-8x32           intel               amd64          balanced            8       32            16000             4000                     -      -
    bx2d-8x32          intel               amd64          balanced            8       32            16000             4000                     -     1x300
    bx2-16x64          intel               amd64          balanced            16      64            32000             8000                     -      -
    bx2d-16x64         intel               amd64          balanced            16      64            32000             8000                     -      1x600
    
  6. Listen Sie die Teilnetze auf, die der IBM Cloud VPC-Instanz zugeordnet sind.

    ibmcloud is subnets
    

    Die Ausgabe des Befehls sieht ähnlich wie im folgenden Beispiel aus.

    ID                                          Name                       Status      Subnet CIDR       Addresses   ACL                                   Public Gateway   VPC                     Zone         Resource group
    0717-cd4f74f1-bfae-423a-886b-9163256ec4a9   subnet-south-1             available   10.240.0.0/24     124/256     acl-test-1                            -                cdl                     us-south-1   Default
    0727-9447a2c3-efb8-44d2-a180-115531e0b0d3   cdl                        available   10.240.64.0/24    238/256     acl-test-1                            -                cdl                     us-south-2   Default
    

    Um die beste Leistung einer Instanzgruppe zu erzielen, sollten Sie darauf achten, dass Sie eine Subnetzgröße von 32 oder mehr verwenden.

    Wenn kein Teilnetz zur Verfügung steht, können Sie ein Teilnetz mithilfe des Befehls ibmcloud is subnet-create erstellen. Weitere Informationen zum Erstellen eines Subnetzes finden Sie in der CLI-Referenz zu „ IBM Cloud VPC “.

  7. Listen Sie die verfügbaren Images zur Erstellung Ihrer Instanzvorlage auf.

    ibmcloud is images
    

    Die Ausgabe des Befehls sieht ähnlich wie im folgenden Beispiel aus.

    ID                                          Name                                                Status       Arch    OS name                              OS version                                               File size(GB)   Visibility   Encryption   Resource group   Catalog Offering User Data Format   Remote Account ID
    r006-3fa3bea4-7f9c-4eeb-8248-ab1f6e03185b   my-test-image                                       available    amd64   centos-7-amd64                       7.x - Minimal Install                                    1               private      none         Default          -                cloud_init
    r006-c55167af-ea8c-4c27-871f-ccc9c868753e   ibm-centos-stream-8-amd64-1                         available    amd64   centos-stream-8-amd64                8                                          2               public       none         Default          -                cloud_init       811f8abfbd32425597dc7ba40da98fa6
    
  8. Listen Sie die verfügbaren SSH-Schlüssel auf, die Sie Ihrer Instanz zuordnen können.

    ibmcloud is keys
    

    Die Ausgabe des Befehls sieht ähnlich wie im folgenden Beispiel aus.

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

    Falls Sie keinen SSH-Schlüssel zur Verfügung haben, können Sie mit dem Befehl „ibmcloud is key-create“ einen SSH-Schlüssel erstellen.

    RSA und ED25519 sind die beiden Arten von SSH-Schlüsseln, die Sie verwenden können. Allerdings können Sie den ED25519 SSH-Schlüsseltyp nicht mit Windows oder VMware Images verwenden. Für diese Images können Sie nur RSA-SSH-Schlüssel verwenden. Weitere Informationen finden Sie unter Einführung in SSH-Schlüssel.

  9. Listet alle verfügbaren Platzierungsgruppen auf, die Sie Ihrer Instanz zuordnen können.

    ibmcloud is placement-groups
    

    Die Ausgabe des Befehls sieht ähnlich wie im folgenden Beispiel aus.

    Listing placement groups for generation 2 compute in all resource groups and region us-east under account vpcdemo as user    yaohaif@cn.ibm.com...
    ID                                            Name                             State    Strategy       Resource Group
    c5f1f366-b92a-4080-991a-aa5c2e33d96b          placement-group-region-us-east   stable   power_spread       5018a8564e8120570150b0764d39ebcc
    placement-group-cccc-cccc-cccc-cccccccccccc   vsi-placementGroup1              stable   host_spread    5018a8564e8120570150b0764d39ebcc
    placement-group-bbbb-bbbb-bbbb-bbbbbbbbbbbb   vsi-placementGroup2              stable   power_spread     5018a8564e8120570150b0764d39ebcc
    placement-group-aaaa-aaaa-aaaa-aaaaaaaaaaaa   vsi-placementGroup3              stable   power_spread   1d18e482b282409e80eff354c919c6a2
    

Erstellen einer Instanzvorlage über die Befehlszeile

Nachdem Sie diese Werte ermittelt haben, verwenden Sie sie zum Ausführen des Befehls instance-template-create. Sie müssen ferner einen Namen für die Instanz angeben.

ibmcloud is instance-template-create INSTANCE_TEMPLATE_NAME VPC ZONE_NAME PROFILE_NAME SUBNET --image IMAGE

Der folgende Beispielbefehl erstellt eine Instanzvorlage mit dem Namen my-instance-template in der VPC, die durch die ID angegeben ist r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b. Die Vorlage wird in der us-south-3 ZONE erstellt und verwendet das bx2-2x8 PROFIL. Das SUBNET wird durch seine ID definiert 0726-298acd6c-e71e-4204-a04f-fe4a4dd89805. Das IMAGE wird durch seine ID angegeben r006-534ef2ac-6158-45b3-9657-57629fa85305.

ibmcloud is instance-template-create my-instance-template r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b us-south-3 bx2-2x8 0076-2249dabc-8c71-4a54-bxy7-953701ca3999 --image r006-534ef2ac-6158-45b3-9657-57629fa85305 --placement-group r006-953db18c-068c-4a11-9b07-645684b444b2
Creating instance template my-instance-template under account Test Account as user test-user@ibm.com...

ID                          0727-0fdac0fb-ad59-4d7b-9f03-604ddc1db002
Name                        my-instance-template
CRN                         crn:v1:bluemix:public:is:us-south-2:a/a1234567::instance-template:0727-0fdac0fb-ad59-4d7b-9f03-604ddc1db002
Resource group              Default
Image                       r006-3fa3bea4-7f9c-4eeb-8248-ab1f6e03185b
VPC                         r006-212def4b-93f0-4b9a-a331-94178b99d474
Zone                        us-south-2
Profile                     bx2-2x8
Boot volume                 Name   Capacity   Profile           IOPS   Attachment name                      Auto delete   Tags
                            -      100        general-purpose   0      illude-education-spotted-reanalyze   true          -

Primary Network Interface   Name      Subnet ID                                   Security Groups                             Allow source IP spoofing   Reserved IP Address   Reserved IP ID   Reserved IP Name   Reserved IP Auto Delete
                            primary   0727-944126da-e46d-4104-8ba4-ab5a5832864b   r006-2295f00e-8af0-4736-be11-94677955b6b2   false                      -                     -                -                  -

Placement                   ID
                            r006-9994e3ab-18ae-49a7-95cf-25c77e09fa76

Created                     2023-03-29T22:02:59+05:30

Das folgende Beispiel erstellt eine Instanzvorlage mit dem Namen my-gen3-instance-template in der VPC, die durch die ID angegeben ist r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b. Die Vorlage wird in der us-south-3_ ZONE erstellt und verwendet das cx3d-8x20 PROFIL. Das SUBNET wird durch seine ID definiert 00726-298acd6c-e71e-4204-a04f-fe4a4dd89805. Das IMAGE wird durch seine ID angegeben r006-534ef2ac-6158-45b3-9657-57629fa85305. Wenn das ausgewählte Rechenprofil die gepoolte Bandbreitenzuweisung für Datenvolumina unterstützt, können Sie auch die --storage_qos_modes Option hinzufügen.

ibmcloud is instance-template-create my-gen3-instance-template r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b us-south-3 cx3d-8x20 00726-298acd6c-e71e-4204-a04f-fe4a4dd89805 --image r006-534ef2ac-6158-45b3-9657-57629fa85305 --storage_qos_modes pooled

Weitere Beispiele für den Befehl ibmcloud is instance-template-create finden Sie in der VPC-CLI-Referenz.

Wenn Sie eine Instanzvorlage erstellen, werden Validierungsschritte durchgeführt, um sicherzustellen, dass Sie Ihre Vorlage zur Bereitstellung einer virtuellen Serverinstanz verwenden können. Sie benötigen weitere Hilfe? Sie können den ibmcloud is help instance-template-create Befehl ausführen, um die Hilfe anzuzeigen.

Erstellen einer Instanzvorlage über die API

Die Instanzvorlage definiert die Details der virtuellen Serverinstanzen, die von der Vorlage erstellt werden. Geben Sie beispielsweise das Profil ( vCPU und Speicher), das Image, die zugeordneten Volumes und die Netzwerkschnittstellen für die Instanzvorlage an. Sie können mithilfe der Anwendungsprogrammierschnittstelle (API) eine oder mehrere Instanzvorlagen in Ihrer „ IBM Cloud VPC “ erstellen.

Weitere Informationen zum Erstellen einer virtuellen Serverinstanz mit einem angepassten Image, das aus einem privaten Katalog gemeinsam genutzt wird, finden Sie unter Bereitstellung aus einem privaten Katalogimage.

Vorbereitende Schritte

Definieren Sie Variablen für das IAM-Token, den API-Endpunkt und die API-Version. Anweisungen hierzu finden Sie unter API- und CLI-Umgebung einrichten.

Stellen Sie sicher, dass Sie über die erforderlichen Zugriffsrechte verfügen. Zum Aufrufen dieser Methoden müssen Ihnen eine oder mehrere IAM-Zugriffsrollen zugeordnet sein, die die folgenden Aktionen enthalten, abhängig von den aufgelisteten Bedingungen. Sie können Ihren Zugriff auf der Seite Benutzer des Cloud Identity and Access Management-Dashboardsüberprüfen.

Wenn Sie weitere Informationen zur API erhalten möchten, klicken Sie auf den Bereitstellungsseiten in der IBM Cloud-Konsole auf Beispiel-API-Aufruf abrufen. Daraufhin wird die korrekte Abfolge der API-Anforderungen angezeigt, sodass Sie die ausgeführten Aktionen und deren Abhängigkeiten besser nachvollziehen können.

Informationen zum Erstellen einer Instanzvorlage zusammenstellen

Sind Sie bereit zum Erstellen einer Instanzvorlage? Bevor Sie die POST Anfrage mit dem /instance/templates-Methode müssen Sie die Details kennen, die Sie in Ihre Instanzvorlage aufnehmen möchten. Sie benötigen beispielsweise die ID oder den Namen der VPC und den Namen der Zone, in der Sie die Instanz erstellen möchten. Sie benötigen außerdem den Namen des Instanzprofils, das Sie verwenden möchten, sowie die ID oder den Namen des Subnetzes, in dem Sie die Vorlage erstellen möchten. Stellen Sie die folgenden erforderlichen Instanzvorlagendetails zusammen, indem Sie die folgenden API-Aufrufe absetzen:

Erforderliche Details der API-Instanzvorlage
Instanzdetails Auflistungsmethoden API-Spezifikationsdokumentation
VPC GET /vpcs Alle VPCs auflisten
Zone GET /regions/<region>/zones Alle Zonen in einer Region auflisten
Profil GET /instance/profiles Alle Instanzprofile auflisten
Teilnetz GET /subnets Alle Teilnetze auflisten
Image GET /images Alle Images auflisten
Schlüssel GET /keys Alle Schlüssel auflisten
Platzierungsgruppen GET /placement_groups Alle Platzierungsgruppen auflisten

Vergewissern Sie sich, dass das gewünschte Profil in der Zone verfügbar ist, in der Sie die Instanz erstellen wollen.

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

  1. Listen Sie die IBM Cloud VPC-Instanzen auf, die Ihrem Konto zugeordnet sind.

    curl -X GET "$vpc_api_endpoint/v1/vpcs?version=2023-07-13&generation=2" -H "Authorization: Bearer $iam_token"
    

    Falls noch kein IBM Cloud VPC vorhanden ist, können Sie mit der Methode „ POST /vpcs “ einen neuen erstellen. Weitere Informationen zur Erstellung einer IBM Cloud VPCfinden Sie unter IBM Cloud API Docs-Create a VPC.

  2. Listen Sie die Regionen auf, die Ihrem Konto zugeordnet sind.

    curl -X GET "$vpc_api_endpoint/v1/regions?version=2023-07-13&generation=2" -H "Authorization: Bearer $iam_token"
    
  3. Listen Sie die Zonen auf, die Ihrer Region zugeordnet sind.

    curl -X GET "$vpc_api_endpoint/v1/regions/$region_name/zones?version=2023-07-13&generation=2" -H "Authorization: Bearer $iam_token"
    
  4. Listen Sie die Profile auf, die zum Erstellen Ihrer Instanzvorlage verfügbar sind.

    curl -X GET "$vpc_api_endpoint/v1/instance/profiles?version=2023-07-13&generation=2" -H "Authorization: Bearer $iam_token"
    
  5. Listen Sie die Teilnetze auf, die der IBM Cloud VPC-Instanz zugeordnet sind.

    curl -X GET "$vpc_api_endpoint/v1/subnets?version=2023-07-13&generation=2" -H "Authorization: Bearer $iam_token"
    

    Um die beste Leistung einer Instanzgruppe zu erzielen, sollten Sie darauf achten, dass Sie eine Subnetzgröße von 32 oder mehr verwenden.

    Wenn Ihnen kein Subnetz zur Verfügung steht, können Sie eines mithilfe der Methode „ POST /subnets “ erstellen. Weitere Informationen zur Erstellung einer IBM Cloud VPCfinden Sie unter IBM Cloud API Docs-Create a subnet.

  6. Listen Sie die Bilder auf, die für die Erstellung Ihrer Instanzvorlage verfügbar sind.

    curl -X GET "$vpc_api_endpoint/v1/images?version=2023-07-13&generation=2" -H "Authorization: Bearer $iam_token"
    
  7. Listen Sie die verfügbaren SSH-Schlüssel auf, die Sie Ihrer Instanz zuordnen können.

    curl -X GET "$vpc_api_endpoint/v1/keys?version=2023-07-13&generation=2" -H "Authorization: Bearer $iam_token"
    

    Falls Sie keinen SSH-Schlüssel zur Verfügung haben, können Sie mit dem Befehl „ibmcloud is key-create“ einen SSH-Schlüssel erstellen.

    Wenn kein SSH-Schlüssel verfügbar ist, können Sie mithilfe der Methode POST /keys einen erstellen. Weitere Informationen zum Erstellen eines IBM Cloud VPCs finden Sie unter IBM Cloud API Docs-Create a key.

    RSA und ED25519 sind die beiden Arten von SSH-Schlüsseln, die Sie verwenden können. Allerdings können Sie den ED25519 SSH-Schlüsseltyp nicht mit Windows oder VMware Images verwenden. Für diese Images können Sie nur RSA-SSH-Schlüssel verwenden. Weitere Informationen finden Sie unter Einführung in SSH-Schlüssel.

  8. Listet alle verfügbaren Platzierungsgruppen auf, die Sie Ihrer Instanz zuordnen können.

    curl -X GET "$vpc_api_endpoint/v1/placement_groups?version=2023-07-13&generation=2" -H "Authorization: Bearer $iam_token"
    

Instanzvorlage mit der API erstellen

Wenn Sie diese Werte kennen, verwenden Sie sie, um eine POST Anfrage mit dem /instance/templates Methode. Sie müssen ferner einen Namen für die Instanz angeben.

Das folgende Beispiel erstellt eine Instanzvorlage mit dem Namen my-instance-template in us-south-1 benannt ist, und verwendet das bx2-2x8 profil.

curl -X POST "$vpc_api_endpoint/v1/instance/templates?version=2023-07-13&generation=2"
  -H "Authorization: Bearer $iam_token"
  -d '{
    "zone": {"name": "us-south-1"},
    "resource_group": {"id": "db8e8d865a83e0aae03f25a492c5b39e"},
    "name": "my-instance-template",
    "vpc": {"id": "r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b"},
    "user_data": "",
    "profile": {"name": "bx2-2x8"},
    "keys": [{"id": "r006-68f8333a-1169-42da-ba01-75268bac8362"}],
    "volume_attachments": [],
    "boot_volume_attachment": {
      "volume": {
        "name": "my-instance-template-boot-1720804230000",
        "capacity": 100,
        "profile": {"name": "general-purpose"}},
      "delete_volume_on_instance_delete": true
    },
    "metadata_service": {
      "enabled": true,
      "protocol": "https",
      "response_hop_limit": 1},
    "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"}}`

Das folgende Beispiel erstellt eine Instanzvorlage mit dem Namen my-gen3-instance-template in us-south-3 benannt ist und das cx3d-8x20 profil verwendet. Wenn das ausgewählte Rechenprofil die gepoolte Bandbreitenzuweisung für Datenvolumina unterstützt, kann die Eigenschaft --storage_qos_modes ebenfalls einbezogen werden.

curl -X POST "$vpc_api_endpoint/v1/instance/templates?version=2024-07-12&generation=2"
  -H "Authorization: Bearer $iam_token"
  -H "Content-Type: application/json" \
  -H "accept: application/json" \
  -d '{
  "zone": {"name": "us-south-3"},
  "resource_group": {"id": "db8e8d865a83e0aae03f25a492c5b39e"},
  "name": "my-gen3-instance-template",
  "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-1",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"}},
      "delete_volume_on_instance_delete": false},
    {"volume": {
        "name": "my-data-volume-2",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"}},
      "delete_volume_on_instance_delete": false},
    {"volume": {
        "name": "my-data-volume-3",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"}},
      "delete_volume_on_instance_delete": false}
  ],
  "boot_volume_attachment": {
    "volume": {
      "name": "my-gen3-instance-template-boot-1720803726000",
      "capacity": 100,
      "profile": {"name": "general-purpose"}
    },
    "delete_volume_on_instance_delete": true
  },
  "metadata_service": {
    "enabled": false,
    "response_hop_limit": 1},
  "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_modes": "pooled"
}'

Weitere Beispiele für die Methode /instance/templates finden Sie in der Dokumentation zur API Create an instance template.

Instanzvorlage mit Terraform erstellen

Sie können eine oder mehrere Instanzvorlagen in IBM Cloud VPC mithilfe von Terraform erstellen.

Weitere Informationen zum Erstellen einer virtuellen Serverinstanz mit einem angepassten Image, das aus einem privaten Katalog gemeinsam genutzt wird, finden Sie unter Instanz mit Terraform erstellen.

Vorbereitende Schritte

Stellen Sie sicher, dass Sie Terraform for VPC eingerichtet haben.

Informationen zum Erstellen einer Instanzvorlage zusammenstellen

Sind Sie bereit zum Erstellen einer Instanzvorlage? Bevor Sie die ibm_is_instance_template Wenn Sie in Ihrer Konfiguration eine Ressource verwenden, müssen Sie die Details kennen, die Sie in Ihre Instanzvorlage aufnehmen möchten. Sie benötigen beispielsweise die ID oder den Namen der VPC sowie den Namen der Zone, in der Sie die Instanzvorlage erstellen möchten. Sie benötigen außerdem den Namen des Instanzprofils, das Sie verwenden möchten, sowie die ID oder den Namen des Subnetzes, in dem Sie die Vorlage erstellen möchten.

Stellen Sie die folgenden erforderlichen Angaben zur Terraform-Instanzvorlage zusammen.

Erforderliche Details der Terraform-Instanzvorlage
Details für die Instanzvorlage Block auflisten Referenzdokumentation zu VPC Terraform-Datenquellen
Instanzprofil ibm_is_instance_profiles ibm_is_instanzprofile
Image ibm_is_images ibm_is_Bilder
VPC ibm_is_vpc ibm_ist_vpc
Teilnetz ibm_is_subnets ibm_is_teilnetze
Zone ibm_is_zone ibm_is_zone
Schlüssel ibm_is_ssh_keys ibm_ist_ssh_keys
Platzierungsgruppen ibm_is_placement_groups ibm_is_Platzierungsgruppen

Verwenden Sie die folgende Anleitung, um die erforderlichen Informationen zum Erstellen einer Instanzvorlage zu ermitteln.

Stellen Sie die folgenden Informationen mithilfe des Blocks DataSource zusammen.

  1. Stellen Sie Instanzprofildetails zusammen. Führen Sie den folgenden Block für das von Ihnen ausgewählte Profil aus. Eine Liste der verfügbaren Profile finden Sie unter x86-Instanzprofile. Weitere Informationen finden Sie in der Terraform-Dokumentation unter „ ibm_is_instance_profiles “. Um ein Instanzprofil zu verwenden, beziehen Sie sich auf die Instanzprofil-Datenquelle. Weitere Informationen finden Sie in der Terraform-Dokumentation unter „ ibm_is_instance_profile “.

    data "ibm_is_instance_profile" "example_profile" {
       name = "bx2-2x8"
    }
    
  2. Listen Sie die verfügbaren Images zur Erstellung Ihrer Instanz auf. Sie können ein Bestandsbild, ein angepasstes Bild aus Ihrem Konto oder ein Bild, das mit Ihrem Konto gemeinsam genutzt wurde, aus einem privaten Katalog verwenden. Weitere Informationen finden Sie in der Terraform-Dokumentation zum Thema „ ibm_is_image “. Wenn Sie ein Image verwenden möchten, das aus einem privaten Katalog freigegeben wurde, lesen Sie die Terraform-Dokumentation unter ibm_cm_version oder ibm_cm_offering_instance.

    • Wählen Sie ein Bestandsbild oder ein angepasstes Bild aus Ihrem Konto für Ihre Instanz aus.
    data "ibm_is_image" "example_image" {
       name = "ibm-centos-7-6-minimal-amd64-2"
    }
    
    • Wählen Sie ein Image aus, das aus einem privaten Katalog für die Instanz gemeinsam genutzt wird. Weitere Informationen finden Sie in der Terraform-Dokumentation zu „ ibm_is_images “.
    data "ibm_is_images" "example_images" {
       catalog_managed = true
    }
    

    Wenn Sie ein Katalogimage auswählen, das zu einem anderen Konto gehört, müssen Sie weitere Aspekte und Einschränkungen prüfen. Siehe Kontenübergreifende Imageverweise in einem privaten Katalog in Terraform verwenden.

  3. 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 zur Datenquelle ibm_is_vpc oder zur Ressource ibm_is_vpc.

    data "ibm_is_vpc" "example_vpc" {
       name = "example-vpc"
    }
    
  4. Erstellen Sie eine Teilnetzressource oder verwenden Sie ein vorhandenes Teilnetz, indem Sie auf die Teilnetzdatenquelle verweisen. Weitere Informationen finden Sie in der Terraform-Dokumentation zur Datenquelle ibm_is_subnet oder zur Ressource ibm_is_subnet.

    data "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. Um einen vorhandenen SSH-Schlüssel zu verwenden, beziehen Sie sich auf die SSH-Schlüssel-Datenquelle ibm_is_ssh_key. Wenn keine SSH-Schlüssel verfügbar sind, verwenden Sie die Ressource ibm_is_ssh_key, um einen zu erstellen.

    RSA und ED25519 sind die beiden Arten von SSH-Schlüsseln, die Sie verwenden können. Allerdings können Sie den ED25519 SSH-Schlüsseltyp nicht mit Windows oder VMware Images verwenden. Für diese Images können Sie nur RSA-SSH-Schlüssel verwenden. Weitere Informationen finden Sie unter Einführung in SSH-Schlüssel.

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

Erstellen der Instanzvorlage mit Terraform

Wenn Sie diese Werte kennen, verwenden Sie sie zum Schreiben der ibm_is_instance_template Ressourcenblock. Sie müssen ferner einen Namen für die Instanz angeben.

Das folgende Beispiel erstellt eine Instanzvorlage mit dem Namen my-instance-template in der us-south-1 region benannt wird, und verwendet das bx2-8x32 profil.

resource "ibm_is_instance_template" "my-instance-template" {
  name    = "my-instance-template"
  image   = r006-3fa3bea4-7f9c-4eeb-8248-ab1f6e03185b
  profile = "bx2-8x32"

  primary_network_interface {
    subnet            = 0727-944126da-e46d-4104-8ba4-ab5a5832864b
    allow_ip_spoofing = true
  }

  placement_group = r006-9994e3ab-18ae-49a7-95cf-25c77e
  vpc             = r006-212def4b-93f0-4b9a-a331-94178b99d474
  zone            = "us-south-1"
  keys            = [363f6d70-0000-0001-0000-00000013b96c]

  boot_volume {
    name                             = "example-boot-volume"
    delete_volume_on_instance_delete = true
  }
}

Das folgende Beispiel erstellt eine Instanzvorlage mit dem Namen my-gen3-instance-template in us-south-3 benannt ist und das cx3d-8x20 profil verwendet. Wenn das ausgewählte Compute-Profil eine gepoolte Bandbreitenzuweisung für Datenvolumina unterstützt, kann die Option storage_qos_modes ebenfalls einbezogen werden.

resource "ibm_is_instance_template" "example" {
  name                = "my-gen3-instance-template"
  image               = r006-534ef2ac-6158-45b3-9657-57629fa85305
  profile             = "cx3d-8x20"
  primary_network_interface {
    subnet            = 0d933c75-492a-4756-9832-1200585dfa79
    allow_ip_spoofing = true
  }
  vpc                 = r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b
  zone                = "us-south-3"
  keys                = [363f6d70-0000-0001-0000-00000013b96c]
  storage_qos_modes   = [pooled]
  boot_volume {
    name                             = "example-boot-volume"
    delete_volume_on_instance_delete = true
  }
  volume_attachments {
    delete_volume_on_instance_delete = false
    name                             = "example-data-vol-01"
    volume_prototype {
      profile = "5iops-tier"
      capacity = 3000
    }
  }
  volume_attachments {
    delete_volume_on_instance_delete = false
    name                             = "example-data-vol-02"
    volume_prototype {
      profile = "5iops-tier"
      capacity = 3000
    }
  }
}

Weitere Beispiele für ibm_is_instance_template finden Sie in der Terraform-Referenz ibm_is_instance_template.

Nächste Schritte

Nachdem Sie eine Instanzvorlage erstellt haben, können Sie entweder eine einzelne virtuelle Serverinstanz bereitstellen oder mehrere Instanzen gleichzeitig als Teil einer Instanzgruppe bereitstellen. Optional können Sie Richtlinien für die automatische Skalierung für Ihre Instanzgruppe einrichten, um virtuelle Serverinstanzen dynamisch zu Ihrer Gruppe hinzuzufügen oder von dieser zu entfernen. Weitere Informationen finden Sie in den folgenden Quellen: