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:
- In der IBM Cloud Konsole, klicken Sie auf Navigationsmenü Symbol
> Infrastruktur
> Compute > Instanzvorlagen.
- Klicken Sie auf „Neue Instanzvorlage“ und geben Sie die in Tabelle 1 aufgeführten Informationen ein.
- 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.
| 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:
Nachdem Sie Ihr Image ausgewählt haben, klicken Sie auf Speichern.
|
| 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 |
| 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.
| 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.
-
Listen Sie die Regionen auf, die Ihrem Konto zugeordnet sind.
ibmcloud is regionsBeispiel:
$ 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 -
Wechseln Sie zu Ihrer Zielregion.
ibmcloud target -r <region-name> -
Listen Sie die Zonen auf, die der Zielregion zugeordnet sind.
ibmcloud is zonesIm folgenden Beispiel wird der Befehl in der
us-southRegion 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 -
Listen Sie die IBM Cloud VPC-Instanzen auf, die Ihrem Konto zugeordnet sind.
ibmcloud is vpcsFü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 DefaultWenn keine zur Verfügung steht, können Sie eine IBM Cloud VPC mithilfe des Befehls
ibmcloud is vpc-createerstellen. Weitere Informationen zum Erstellen einer IBM Cloud VPC-Instanz finden Sie in der CLI-Referenz für IBM Cloud VPC. -
Listen Sie die verfügbaren Profile zur Erstellung Ihrer Instanzvorlage auf.
ibmcloud is instance-profilesDie 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 -
Listen Sie die Teilnetze auf, die der IBM Cloud VPC-Instanz zugeordnet sind.
ibmcloud is subnetsDie 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 DefaultUm 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-createerstellen. Weitere Informationen zum Erstellen eines Subnetzes finden Sie in der CLI-Referenz zu „ IBM Cloud VPC “. -
Listen Sie die verfügbaren Images zur Erstellung Ihrer Instanzvorlage auf.
ibmcloud is imagesDie 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 -
Listen Sie die verfügbaren SSH-Schlüssel auf, die Sie Ihrer Instanz zuordnen können.
ibmcloud is keysDie 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.. DefaultFalls 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.
-
Listet alle verfügbaren Platzierungsgruppen auf, die Sie Ihrer Instanz zuordnen können.
ibmcloud is placement-groupsDie 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:
| 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.
-
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. -
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" -
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" -
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" -
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. -
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" -
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 /keyseinen 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.
-
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.
| 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.
-
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" } -
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.
-
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" } -
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" } -
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: