Angepasstes Bild über die Benutzerschnittstelle importieren

Wenn Sie über ein Image in IBM Cloud Object Storage verfügen, können Sie es mithilfe der IBM Cloud VPC-Konsole in die IBM Cloud-Infrastruktur importieren.

1. Vergewissern Sie sich, dass Ihr kompatibles angepasstes Image in IBM Cloud Object Storage verfügbar ist. Klicken Sie zum Hochladen eines Images in IBM Cloud Object Storage auf der Seite Objekte Ihres Buckets auf Hochladen. Sie können das Plug-in für die Aspera-Hochgeschwindigkeitsübertragung verwenden, um Images mit mehr als 200 MB hochzuladen. Weitere Informationen finden Sie in den Abschnitten Angepasstes Linux-Image erstellen, Angepasstes Windows-Image erstellen, Eigene Lizenz verwenden (Bring Your Own License, BYOL) und Hochladen von Daten in IBM Cloud Object Storage.
2. Rufen Sie in der IBM Cloud-Konsole Menüsymbol > VPC-Infrastruktur > Berechnen > Images auf.
3. Klicken Sie auf der Registerkarte Angepasste Images auf Erstellen.
4. Füllen Sie die in Tabelle 1 beschriebenen Felder aus und klicken Sie auf "Benutzerdefiniertes Bild erstellen ".

Angepasstes Image über die Befehlszeilenschnittstelle importieren

Vergewissern Sie sich, dass Ihr kompatibles angepasstes Image in IBM Cloud Object Storage verfügbar ist. Weitere Informationen finden Sie unter Angepasstes Image für Linux erstellen, Angepasstes Image für Windows erstellen, Angepasstes Image für generisches Betriebssystem erstellen, Eigene Lizenz verwenden und Daten hochladen in IBM Cloud Object Storage.

Wenn Sie ein Bild in IBM Cloud Object Storage haben, können Sie es über die Befehlszeilenschnittstelle (CLI) in die IBM Cloud VPC-Infrastruktur importieren.

Verwenden Sie den Befehl ibmcloud is image-create, um ein angepasstes Image über die Befehlszeilenschnittstelle zu importieren. Geben Sie den Namen des zu erstellenden angepassten Image mit der Variablen IMAGE_NAME an. Der Name kann nicht von einem anderen Image in der Region verwendet werden und Namen, die mit ibm- beginnen, sind für vom System bereitgestellte Images reserviert. Sie müssen auch die Quelle angeben. Geben Sie beispielsweise die Option --file mit der Position der Imagedatei an. Geben Sie die Option --os-name mit dem Namen des Betriebssystems für das Image an.

ibmcloud is image-create IMAGE_NAME [--file IMAGE_FILE_LOCATION] [--os-name OPERATING_SYSTEM_NAME]

Im folgenden Beispiel wird ein angepasstes Image mit dem Namen my-ubuntu-16-amd64 erstellt. Die Position der Bildquelle ist cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2. Das Betriebssystem ist ubuntu-16-amd64.

ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64

Weitere Informationen finden Sie auf der Seite "ibmcloud is image-create in the VPC CLI reference".

ibmcloud is image-create IMAGE_NAME [--file IMAGE_FILE_LOCATION] [--os-name OPERATING_SYSTEM_NAME] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --deprecate-at 2023-03-01T06:11:28+05:30 --obsolete-at 2023-12-31T06:11:28+05:30

Angepasstes Image mithilfe der API importieren

Vergewissern Sie sich, dass Ihr kompatibles angepasstes Image in IBM Cloud Object Storage verfügbar ist. Weitere Informationen finden Sie unter Angepasstes Linux-Image erstellen, Angepasstes Windows-Image erstellen, Angepasstes Image für ein generisches Betriebssystem erstellen, Eigene Lizenz mitbringen und Daten hochladen in IBM Cloud Object Storage.

Wenn ein Image in IBM Cloud Object Storageverfügbar ist, können Sie es über die Anwendungsprogrammierschnittstelle (API) in die IBM Cloud VPC-Infrastruktur importieren.

Um ein angepasstes Image mithilfe der API zu importieren, verwenden Sie Image erstellen.

name kann nicht von einem anderen Image in der Region verwendet werden und Namen, die mit ibm- beginnen, sind für vom System bereitgestellte Images reserviert. Geben Sie die Untereigenschaft file.href mit der Position des Image an. Geben Sie die Untereigenschaft operating_system.name mit dem Namen des Imagebetriebssystems an.

Generische angepasste Betriebssystemimages sind eine Betafunktion, die für Bewertungs-und Testzwecke verfügbar ist. Die generischen Betriebssysteme verfügen über family von Generic. Stellen Sie sicher, dass Sie die Datei mit dem allow_user_image_creation-Wert true und dem user_data_format auswählen, die für Ihr Betriebssystem erforderlich sind, um ordnungsgemäß zu booten und zu initialisieren. Weitere Informationen finden Sie unter Hinweise zum Benutzerdatenformat.

Im folgenden Beispiel wird ein angepasstes Image mit dem Namen my-image, der Quellenposition cos://us-south/my-bucket/my-image.qcow2 und dem Betriebssystem für das Image debian-9-amd64 importiert.

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      }
    }'

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      },
      "deprecation_at": "2023-03-01T06:11:28+05:30",
      "obsolescence_at": "2023-12-31T06:11:28+05:30"
    }'

Änderungen am Lebenszyklusstatus angepasster Images mithilfe von Terraform planen

Wenn Sie ein angepasstes Image mithilfe von Terraform importieren, können Sie auch die Lebenszyklusstatusänderungen eines angepassten IBM Cloud VPC-Image mit dem Terraform-Ressourcenbefehl ibm_is_imageplanen.

Das Attribut name kann nicht von einem anderen Image in der Region verwendet werden und Namen, die mit ibm- beginnen, sind für vom System bereitgestellte Images reserviert.

Geben Sie zum Planen der Attribute deprecation_at oder obsolescence_at ein Datum im Datums-und Zeitformat nach ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) an.

• YYYY ist die vierstellige Jahreszahl
• MM ist der zweistellige Monat
• DD ist der zweistellige Tag
• T trennt die Datums-und Zeitinformationen
• hh ist die zweistellige Stundenangabe
• mm ist die zweistellige Minutenangabe
• +hh:mm oder -hh:mm ist die koordinierte Weltzeitzone.

Das Datum des 30. September 2023 um 20:00 Uhr in der Zeitzone North American Central Standard Time (CST) wäre also 2023-09-30T20:00:00-06:00.

Wenn Sie das Datum und die Uhrzeit planen, können Sie das aktuelle Datum und die aktuelle Zeit nicht verwenden. Wenn es beispielsweise um 8:00 Uhr am 12. Juni geht, müssen das geplante Datum und die geplante Uhrzeit nach 8:00 Uhr am 12. Juni liegen. Wenn Sie das Datum und die Uhrzeit für deprecation_at und obsolescence_at definieren, muss das Datum obsolescence_at nach dem Datum und der Uhrzeit für deprecation_at liegen.

Im folgenden Beispiel wird ein angepasstes Image mit dem Namen example-image, der Quellenposition cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd und dem Betriebssystem für das Image ubuntu-16-04-amd64 importiert. Das Image wird in 2023-11-28T15:10:00.000Z als veraltet markiert. Das Image ist für 2023-11-28T15:10:00.000Z als veraltet geplant.

• Planen Sie eine Statusänderung in deprecated.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    deprecated_at      = "2023-11-28T15:10:00.000Z"
  }
  

• Planen Sie eine Statusänderung in obsolete.

  resource "ibm_is_image" "example" {
    name               = "example-image"
    href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
    operating_system   = "ubuntu-16-04-amd64"
    obsolescence_at    = "2023-11-28T15:10:00.000Z"
  }
  

Importiertes angepasstes Image über die Benutzerschnittstelle validieren

Nachdem Sie ein benutzerdefiniertes Bild importiert haben, können Sie die Prüfsumme anzeigen, die für das Bild generiert wurde, als es in IBM Cloud VPC importiert wurde.

Wenn Sie vor dem Import lokal eine Prüfsumme für Ihr Bild erstellen, können Sie die beiden Prüfsummen vergleichen, um sicherzustellen, dass sie identisch sind. Übereinstimmende Kontrollsummen geben an, dass keine Änderungen am Image vorgenommen wurden.

1. Rufen Sie in der IBM Cloud-Konsole Menüsymbol > VPC-Infrastruktur > Berechnen > Images auf.

2. Klicken Sie auf der Registerkarte "Benutzerdefinierte Bilder" in Ihrer Liste der benutzerdefinierten Bilder auf den Namen des benutzerdefinierten Bildes, das Sie validieren möchten.

3. Suchen Sie im Seitenbereich für Bilddetails das Feld "Prüfsumme" ( SHA256 ). Sie sehen ähnliche Inhalte wie 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7.

   Nur für z/OS Wazi aaS-Image: Sie können die Kontrollsumme der importierten angepassten Images, die über Wazi Image Builderbereitgestellt werden, nicht validieren.

4. Vergleichen Sie den Wert im Feld 'Kontrollsumme (SHA256)' mit der Ausgabe, die generiert wird, wenn Sie lokal eine Kontrollsumme für das Image generieren.

   • Beispiel für Linux-Befehl: sha256sum ubuntu_image.qcow2
   • Beispiel für Mac-Befehl: shasum -a 256 ubuntu_image.qcow2
   • Sie erhalten eine Ausgabe, die in etwa so aussieht: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

5. Erstellen Sie mithilfe dieses Image eine virtuelle Serverinstanz oder einen Bare-Metal-Server. Weitere Informationen finden Sie unter Create a virtual server instance oder Creating Bare Metal Servers on VPC.

Importiertes angepasstes Image über die Befehlszeilenschnittstelle validieren

Nachdem Sie ein benutzerdefiniertes Bild importiert haben, können Sie die Prüfsumme anzeigen, die für das Bild generiert wurde, als es in IBM Cloud VPC importiert wurde.

Wenn Sie vor dem Import lokal eine Prüfsumme für Ihr Bild erstellen, können Sie die beiden Prüfsummen vergleichen, um sicherzustellen, dass sie identisch sind. Übereinstimmende Kontrollsummen geben an, dass keine Änderungen am Image vorgenommen wurden.

Verwenden Sie den Befehl ibmcloud is image, um ein importiertes angepasstes Image über die Befehlszeilenschnittstelle zu validieren.

Zeigen Sie zuerst die Details des importierten angepassten Image an, das Sie validieren wollen. Geben Sie den Namen oder die ID des angepassten Image an, das mit der Variablen IMAGE erstellt wird.

ibmcloud is image IMAGE

Weitere Informationen finden Sie auf der Seite "VPC CLI-Referenz" unter ibmcloud is image.

Im folgenden Beispiel werden die Details eines angepassten Image mit der ID r134-1d1e92e9-6550-4d06-8483-d674310045fd angezeigt.

ibmcloud is image r134-1d1e92e9-6550-4d06-8483-d674310045fd

Getting image r134-1d1e92e9-6550-4d06-8483-d674310045fd under account Rios IMSLess as user gbgrout@ibm.com...

ID                             r134-589548bd-9241-4ad7-a610-1df6ba020793
Name                           my-image-from-volume-cli-1
CRN                            crn:v1:staging:public:is:us-south:a/efe5afc483594adaa8325e2b4d1290df::image:r134-589548bd-9241-4ad7-a610-1df6ba020793
Status                         available
Operating system               Name             Architecture   Vendor   Version                 Dedicated host only
                               centos-7-amd64   amd64          CentOS   7.x - Minimal Install   false

Source volume                  ID                                          Name
                               r134-6438d80f-4433-4445-be2f-0cca05afff3e   transpose-clubhouse-putt-repent

Created                        2023-03-16T01:11:03+05:30
Deprecation Date               2023-03-01T06:11:28+05:30
Obsolescence Date              2023-12-31T06:11:28+05:30
Visibility                     private
Owner type                     user
Minimum provisioned size(GB)   250
SHA256 Checksum                774d44ac0d55f2bfe869b995565715e5d9970ec23ce7127b2e2776b2618a9f7c
File size(GB)                  2
Encryption                     none
Resource group                 11caaa983d9c4beb82690daab08717e9
Resource type                  image
Catalog Offering Managed       false

Vergleichen Sie den zurückgegebenen Wert der Prüfsumme ( SHA256 ) mit der Ausgabe, die bei der lokalen Berechnung einer Prüfsumme für das Bild generiert wird.

• Beispiel für Linux-Befehl: sha256sum ubuntu_image.qcow2
• Beispiel für Mac-Befehl: shasum -a 256 ubuntu_image.qcow2
• Sie erhalten eine Ausgabe, die in etwa so aussieht: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Verwenden Sie nach der Validierung der Kontrollsummen (SHA256) das Image, um einen virtuellen Server zu erstellen. Siehe Virtuelle Serverinstanz über die Befehlszeilenschnittstelle erstellen.

Importiertes angepasstes Image mithilfe der API validieren

Nachdem Sie ein benutzerdefiniertes Bild importiert haben, können Sie die Prüfsumme anzeigen, die für das Bild generiert wurde, als es in IBM Cloud VPC importiert wurde.

Wenn Sie vor dem Import lokal eine Prüfsumme für Ihr Bild erstellen, können Sie die beiden Prüfsummen vergleichen, um sicherzustellen, dass sie identisch sind. Übereinstimmende Kontrollsummen geben an, dass keine Änderungen am Image vorgenommen wurden.

Zur Validierung als angepasstes Image mithilfe der API verwenden Sie Alle Images auflisten.

Geben Sie für $image_id die ID des angepassten Image an, das Sie validieren möchten.

curl -X GET "$vpc_api_endpoint/v1/images/$image_id/?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token"

Vergleichen Sie den zurückgegebenen Wert der Prüfsumme ( SHA256 ) mit der Ausgabe, die bei der lokalen Berechnung einer Prüfsumme für das Bild generiert wird.

• Beispiel für Linux-Befehl: sha256sum ubuntu_image.qcow2
• Beispiel für Mac-Befehl: shasum -a 256 ubuntu_image.qcow2
• Sie erhalten eine Ausgabe, die in etwa so aussieht: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

Verwenden Sie nach der Validierung der Kontrollsummen (SHA256) das Image, um einen virtuellen Server zu erstellen. Siehe Virtuelle Serverinstanz mithilfe der API erstellen.