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 Image 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 Erstellen eines Linux benutzerdefinierten Abbilds, Erstellen eines benutzerdefinierten Windows-Abbilds, Erstellen eines benutzerdefinierten Abbilds für ein allgemeines Betriebssystem, Mitbringen einer eigenen Lizenz und Hochladen von Daten auf IBM Cloud Object Storage. Wie Sie Ausdrücke für die erlaubte Verwendung einfügen, erfahren Sie unter Hinzufügen von Ausdrücken für die erlaubte Verwendung zu benutzerdefinierten Bildern.

Wenn ein Image in IBM Cloud Object Storage verfügbar ist, 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 benutzerdefinierten Bildes 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 die Quelle angeben; geben Sie zum Beispiel die Option --file mit dem Speicherort der Bilddatei 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 unter ibmcloud is image-create auf der Referenzseite zur VPC-CLI.

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 Erstellen eines Linux benutzerdefinierten Abbilds, Erstellen eines benutzerdefinierten Windows-Abbilds, Erstellen eines benutzerdefinierten Abbilds für ein allgemeines Betriebssystem, Bringen Sie Ihre eigene Lizenz mit, und Hochladen von Daten auf IBM Cloud Object Storage. Wie Sie einen Ausdruck für die erlaubte Verwendung einfügen, erfahren Sie unter Hinzufügen von Ausdrücken für die erlaubte Verwendung zu benutzerdefinierten Bildern.

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.

Bei den allgemeinen benutzerdefinierten Betriebssystem-Images handelt es sich um eine Beta-Funktion, die zu Evaluierungs- und Testzwecken zur Verfügung steht. 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"
    }'

Importieren eines benutzerdefinierten Bildes mit Terraform

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

Vergewissern Sie sich, dass Ihr kompatibles angepasstes Image in IBM Cloud Object Storage verfügbar ist. Weitere Informationen finden Sie unter Erstellen eines Linux benutzerdefinierten Abbilds, Erstellen eines benutzerdefinierten Windows-Abbilds, Erstellen eines benutzerdefinierten Abbilds für ein allgemeines Betriebssystem, Mitbringen einer eigenen Lizenz und Hochladen von Daten auf IBM Cloud Object Storage. Wie Sie Ausdrücke für die erlaubte Verwendung einfügen, erfahren Sie unter Hinzufügen von Ausdrücken für die erlaubte Verwendung zu benutzerdefinierten Bildern.

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

Um ein benutzerdefiniertes Image mit Terraform zu importieren, verwenden Sie den Terraform-Ressourcenbefehl ibm_is_image.

Geben Sie den Namen des zu erstellenden benutzerdefinierten Bildes mit dem Wert 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, z. B. den Wert href mit dem Speicherort der Bilddatei. Geben Sie den Wert operating_system mit dem Namen des Betriebssystems für das Abbild an.

resource "ibm_is_image" "example" {
  name               = "my-image"
  href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
  operating_system   = "ubuntu-16-04-amd64"
}

Ä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 Jahresangabe
• MM ist die zweistellige Monatsangabe
• DD ist die zweistellige Tagesangabe
• T trennt die Datums-und Zeitinformationen
• hh ist die zweistellige Stundenangabe
• mm ist die zweistellige Angabe der Minuten
• +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 Image importiert haben, können Sie die Prüfsumme einsehen, die für das Image beim Import in IBM Cloud VPC generiert wurde.

Wenn Sie vor dem Importieren lokal eine Prüfsumme für Ihr Image 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 Images in Ihrer Liste der benutzerdefinierten Images auf den Namen des benutzerdefinierten Images, das Sie validieren möchten.
3. Suchen Sie im Seitenbereich Bilddetails das Feld Prüfsumme ( SHA256 ). Sie sehen Inhalte, die dem folgenden ähnlich sind: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7.

Nur für benutzerdefinierte Images von z/OS Wazi aaS: Sie können die Prüfsumme der importierten benutzerdefinierten Images, die von Wazi Image Builder bereitgestellt 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 ein Ergebnis, das in etwa wie folgt 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 Image importiert haben, können Sie die Prüfsumme einsehen, die für das Image beim Import in IBM Cloud VPC generiert wurde.

Wenn Sie vor dem Importieren lokal eine Prüfsumme für Ihr Image 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 unter ibmcloud is image auf der Referenzseite zur VPC-CLI.

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

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

Getting image r006-1d1e92e9-6550-4d06-8483-d674310045fd under account Rios IMSLess as user gbgrout@ibm.com...
ID                             r006-589548bd-9241-4ad7-a610-1df6ba020793
Name                           my-image-from-volume-cli-1
CRN                            crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-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
                               r006-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
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 Checksum-Wert ( SHA256 ) mit der Ausgabe, die entsteht, wenn Sie die Prüfsumme für das Image lokal berechnen.

• Beispiel für Linux-Befehl: sha256sum ubuntu_image.qcow2
• Beispiel für Mac-Befehl: shasum -a 256 ubuntu_image.qcow2
• Sie erhalten ein Ergebnis, das in etwa wie folgt 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 Image importiert haben, können Sie die Prüfsumme einsehen, die für das Image beim Import in IBM Cloud VPC generiert wurde.

Wenn Sie vor dem Importieren lokal eine Prüfsumme für Ihr Image 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 Checksum-Wert ( SHA256 ) mit der Ausgabe, die entsteht, wenn Sie die Prüfsumme für das Image lokal berechnen.

• Beispiel für Linux-Befehl: sha256sum ubuntu_image.qcow2
• Beispiel für Mac-Befehl: shasum -a 256 ubuntu_image.qcow2
• Sie erhalten ein Ergebnis, das in etwa wie folgt 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.