Angepasste Images verwalten
Nachdem Sie ein benutzerdefiniertes Image in IBM Cloud VPC importiert haben, können Sie Details zum Image anzeigen, den Lebenszyklus des Images verwalten, das Image zur Erstellung einer virtuellen Serverinstanz verwenden, das Image exportieren und sogar mit einem privaten Katalog gemeinsam nutzen.
- Informationen zum Verwalten eines Image von einem Datenträger finden Sie unter Image von Datenträger verwalten.
- Informationen zur Verwendung eines benutzerdefinierten Images in einem privaten Katalog finden Sie unter "Einbinden eines virtuellen Server-Images für VPC ".
- Wie Sie Ausdrücke für die erlaubte Verwendung mit Ihren benutzerdefinierten Bildern verwenden können, um die Fähigkeiten und Einschränkungen eines Bildes zu definieren und bei der Servererstellung kompatible Bild- und Profilkombinationen zu finden, erfahren Sie unter Hinzufügen von Ausdrücken für die erlaubte Verwendung zu benutzerdefinierten Bildern.
IBM Cloud® Identity and Access Management (IAM) ermöglicht es Ihnen, Benutzer für Plattformdienste sicher zu authentifizieren und den Zugriff auf Ressourcen plattformübergreifend in der IBM Cloud einheitlich zu steuern. Weitere Informationen zu den Zugriffsanforderungen für angepasste Images finden Sie in den IAM-Rollen und -Aktionen unter Image Service for VPC.
Weitere Informationen zu den $iam_token Variablen und $vpc_api_endpoint in den folgenden Beispielen finden Sie in den Abschnitten Authentifizierung und Endpunkt-URLs in der Einführung in die Virtual Private Cloud-API.
Angepasste Images über die Benutzerschnittstelle verwalten
Zum Verwalten eines Images können Sie die IBM Cloud-Konsole verwenden.
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
>
VPC > Compute > Images.
- Klicken Sie auf der Registerkarte Angepasste Images auf das Symbol 'Aktionen'
für ein bestimmtes Image und wählen Sie eine der verfügbaren Optionen aus. Verschlüsselte angepasste Images werden durch ein Schlosssymbol hinter dem Imagenamen gekennzeichnet. Folgende Aktionen stehen zur Auswahl:
| Aktion | Beschreibung |
|---|---|
| Umbenennen von | Benennen Sie das angepasste Bild um. |
| Virtuelle Serverinstanz erstellen | Erstellen Sie einen neuen virtuellen Server aus dem angepassten Image. |
| Exportieren | Kopieren Sie das angepasste Image nach IBM Cloud Object Storage. |
| Mit Katalog teilen | Geben Sie das angepasste Image IBM Cloud VPC für einen vorhandenen privaten Katalog frei. |
| Kopieren | Kopieren Sie die UUID des angepassten Image. |
| Kontrollsumme anzeigen | Zeigen Sie die Kontrollsumme für das angepasste Image an. |
| Lebenszyklus planen | Öffnet die Anzeige Bildlebenszyklus planen. Sie können eine sofortige Statusänderung vornehmen oder eine Statusänderung für ein zukünftiges Datum und eine zukünftige Zeit planen. Sie können eine einzelne Statusänderung
planen oder den vollständigen Lebenszyklus der Images planen. Imagestatus:
Sie können zwischen den drei Status hin- und herwechseln. Es werden nur die Status angezeigt, die Sie ändern können. Sie können Statusänderungen anhand des Kalenderdatums, der Uhrzeit oder der Anzahl der Tage planen. Die veralteten Daten müssen immer nach dem Veraltungsdatum liegen. |
| Löschen | Löschen Sie das angepasste Image.
Wenn Sie ein angepasstes Image in einem privaten Katalog löschen wollen, lesen Sie den Abschnitt Angepasstes Image in einem privaten Katalog löschen. |
Angepasste Images über die Befehlszeilenschnittstelle auflisten
Sie können alle angepassten IBM Cloud VPC-Images in Ihrer Region über die Befehlszeilenschnittstelle (CLI) auflisten.
Verwenden Sie den Befehl ibmcloud is images, um alle angepassten Images über die Befehlszeilenschnittstelle aufzulisten. Angepasste Images sind für das Konto, in dem sie erstellt werden, privat, sodass die Option
--visibility private lautet.
ibmcloud is images --visibility private
Weitere Informationen finden Sie unter ibmcloud is images auf der Referenzseite zur VPC-CLI.
Alle Bilder mithilfe der API auflisten
Sie können alle IBM Cloud VPC-Images in Ihrer Region mithilfe der Anwendungsprogrammierschnittstelle (API) auflisten.
Verwenden Sie Alle Images auflisten, um alle Images mithilfe der API aufzulisten. Angepasste Images sind privat für das Konto, in dem sie erstellt werden, sodass Sie die Eigenschaft visibility auf private setzen können, um nur angepasste Images abzurufen.
curl -X GET \
”$vpc_api_endpoint/v1/images?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Alle Images mit Terraform auflisten
Sie können alle IBM Cloud VPC-Images in Ihrer Region mithilfe von Terraform auflisten.
Verwenden Sie zum Auflisten aller Images mithilfe von Terraform den Terraform-Datenquellenbefehl ibm_is_images.
Angepasste Images sind privat für das Konto, in dem sie erstellt wurden, sodass Sie das Attribut visibility auf private setzen können, um nur angepasste Images abzurufen.
data "ibm_is_images" "images" {
visibility = "public"
}
Anzeigen von Details zu benutzerdefinierten Images über die Benutzeroberfläche
Sie können die folgenden Details eines angepassten Image anzeigen:
- „allowed-use“-Ausdrücke
- Zugeordnete Ressourcengruppe
- Kontrollsumme
- Erstellungsdatum
- CRN
- Datum der Nichtweiterverwendung (falls festgelegt)
- Verschlüsselungstyp
- Standort
- Name und ID
- Veraltete Daten (falls festgelegt)
- Betriebssystem und Version
- Größe
- Quellentyp
Sie können den Namen des angepassten Image bearbeiten, Tags für die Suchbarkeit hinzufügen und den eindeutigen Cloudressourcennamen (CRN) anzeigen und kopieren. Der SHA256 Prüfsummenwert für das Bild ist zugänglich.
Führen Sie die folgenden Schritte aus, um Details zu einem angepassten Image anzuzeigen:
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
>
VPC > Compute > Images.
- Klicken Sie auf der Registerkarte " Benutzerdefinierte Bilder" auf den Namen eines benutzerdefinierten Bildes und dann im nächsten Fenster auf
View image details. - Auf der Seite Bilddetails können Sie den Namen des Bildes bearbeiten, die Prüfsumme kopieren, Tags hinzufügen, die CRN für das Bild kopieren und die Ausdrücke für die zulässige Verwendung des Bildes bearbeiten.
- Über das Menü Aktionen auf der Seite Image-Details können Sie Aktionen ausführen, z. B. eine virtuelle Serverinstanz aus dem benutzerdefinierten Image erstellen oder das Image löschen. Eine vollständige Liste der möglichen Aktionen finden Sie unter Angepasste Images mithilfe der Benutzerschnittstelle verwalten.
Angepasste Imagedetails über die Befehlszeilenschnittstelle anzeigen
Sie können die Details eines angepassten Image, wie z. B. Name und ID, Betriebssystem und Version, Verschlüsselungsstatus, veraltete oder veraltete Daten und zugeordnete Ressourcengruppe, über die Befehlszeilenschnittstelle anzeigen.
Um die Details eines benutzerdefinierten Images über die CLI anzuzeigen, verwenden Sie den Befehl ibmcloud is image. Geben Sie den Namen oder die ID des angepassten Images mit der Variablen IMAGE an.
ibmcloud is image IMAGE
Weitere Informationen finden Sie unter ibmcloud is image auf der Referenzseite zur VPC-CLI.
Angepasste Imagedetails mithilfe der API abrufen
Sie können die Details eines angepassten Image, wie z. B. Name und ID, Betriebssystem und Version, Verschlüsselungsstatus, veraltete oder veraltete Daten und zugeordnete Ressourcengruppe, über die Anwendungsprogrammierschnittstelle (API) anzeigen.
Um die Details eines bestimmten angepassten Image mithilfe der API abzurufen, verwenden Sie Bild abrufen. Geben Sie für die Variable $image_id die ID des angepassten Image an, das Sie
abrufen wollen.
curl -X GET \
”$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Angepasste Imagedetails mithilfe von Terraform abrufen
Mithilfe von Terraform können Sie die Details eines angepassten Image anzeigen, z. B. Name und ID, Betriebssystem und Version, Verschlüsselungsstatus, veraltete oder veraltete Daten und zugeordnete Ressourcengruppe.
Um die Details eines Image mit Terraform anzuzeigen, verwenden Sie den Terraform-Datenquellenbefehl ibm_is_images.
Geben Sie für die Variable name den Namen des angepassten Images an, das Sie abrufen wollen.
data "ibm_is_images" "image_name" {
}
Angepasstes Image in IBM Cloud Object Storage exportieren
Sie können ein angepasstes Image in IBM Cloud Object Storageexportieren. Später möchten Sie das Bild möglicherweise in eine neue Region kopieren, indem Sie es erneut importieren. Oder Sie möchten das Bild außerhalb der VPC extrahieren, um es an einem anderen Ort, z. B. vor Ort, zu verwenden. Für das Speichern von Images in IBM Cloud Object Storagekönnen Gebühren anfallen. Weitere Informationen finden Sie unter Abrechnung.
Voraussetzungen
Zum Exportieren eines angepassten Image müssen die folgenden Voraussetzungen erfüllt sein:
- Sie benötigen eine IAM-Rolle, die die Aktionen
is.image.image.exportundis.image.image.operateenthält. Weitere Informationen finden Sie unter IAM-Zugriff für VPC-Infrastrukturservices verwalten. - Sie müssen eine IBM Cloud Object Storage-Serviceinstanz erstellen. Sie müssen außerdem eine Berechtigung für den Image-Service für VPC erstellen, um auf IBM Cloud Object Storage mit der Servicezugriffsrolle 'Schreibberechtigter' zuzugreifen. Weitere Informationen finden Sie unter Zugriff auf IBM Cloud Object Storage zum Importieren und Exportieren von Images.
- Sie benötigen IAM-Zugriff, um in das Bucket zu schreiben, in das Sie ein Image exportieren möchten. Weitere Informationen finden Sie unter Zugriff auf ein einzelnes Bucket zuweisen.
Wenn das zu exportierende Image gelöscht wird, während ein Exportjob in Bearbeitung ist, wird der Imagestatus auf deleting gesetzt. Der Exportjob kann abgeschlossen werden, bevor das Image gelöscht wird. Wenn das Löschen des Images
abgeschlossen ist, ist der zugehörige Exportjobverlauf nicht verfügbar. Sie können die Ereignisse der Aktivitätsverfolgung für den Exportauftrag verwenden, um seinen endgültigen Status
zu bestimmen.
Angepasstes Image über die Benutzerschnittstelle exportieren
Führen Sie die folgenden Schritte aus, um ein angepasstes Image nach IBM Cloud Object Storagezu exportieren.
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
>
VPC > Compute > Images.
- Klicken Sie auf der Registerkarte Angepasste Images auf den Namen des angepassten Images, das Sie exportieren möchten.
- Klicken Sie auf der Seite mit den Imagedetails auf das Menü Aktionen und wählen Sie Exportieren aus.
- In der Anzeige Angepasstes Image exportieren können Sie optional einen Namen für den Exportjob angeben. Der Name wird zusammen mit dem Imagenamen verwendet, um den Namen des exportierten Objekts in IBM Cloud Object Storagezu erstellen. Wenn Sie keinen Namen angeben, wird automatisch ein Name generiert.
- Wählen Sie das Dateiformat für den Export aus. Gültige Dateiformate sind QCOW2 und VHD. Wenn das angepasste Image ein verschlüsseltes Image ist, ist das Format QCOW2 erforderlich.
- Geben Sie die IBM Cloud Object Storage-Serviceinstanz und das Bucket an, in die das angepasste Image exportiert werden soll. Alternativ können Sie den CRN für das Bucket IBM Cloud Object Storage angeben, in das Sie das Image exportieren wollen.
- Klicken Sie auf Benutzerdefiniertes Bild exportieren.
Angepasstes Image über die Befehlszeilenschnittstelle exportieren
Sie können ein angepasstes IBM Cloud VPC-Image über die Befehlszeilenschnittstelle (CLI) in IBM Cloud Object Storage exportieren.
Verwenden Sie den Befehl ibmcloud is image-export-job-create, um ein angepasstes Image über die Befehlszeilenschnittstelle zu exportieren. Geben Sie mit der Variablen IMAGE den Namen oder die ID des angepassten
Image an, das exportiert werden soll. Sie können einen Namen für den Exportjob mit NEW_NAME angeben. Sie können auch das Dateiformat für den Export des Image angeben, entweder qcow2 oder vhd. Das Format
qcow2 ist das Standarddateiformat und das erforderliche Format, wenn das angepasste Image verschlüsselt ist. Geben Sie außerdem IBM Cloud Object Storage BUCKET an, wo Sie das angepasste Image exportieren möchten.
ibmcloud is image-export-job-create IMAGE [--name NEW_NAME] [--format qcow2 | vhd] --bucket BUCKET
Im folgenden Beispiel wird ein angepasstes Image mit der ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 exportiert. Der Exportjob hat den Namen my-export-job. Das Dateiformat für den Export des Image ist qcow2.
Das Bucket IBM Cloud Object Storage, in dem das exportierte Image den Namen my-bucket hat.
ibmcloud is image-export-job-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-export-job --format qcow2 --bucket my-bucket
Weitere Informationen finden Sie unter ibmcloud is image-export-job-create auf der Referenzseite der VPC-CLI.
Angepasstes Bild mit der API exportieren
Sie können ein angepasstes IBM Cloud VPC-Image mithilfe der Anwendungsprogrammierschnittstelle (API) in IBM Cloud Object Storage exportieren.
Wenn Sie ein angepasstes Image mithilfe der API exportieren möchten, verwenden Sie Imageexportjob erstellen.
Geben Sie für die Variable $image_id die ID des angepassten Image an, das Sie exportieren möchten. Sie können optional eine aussagekräftige name für den Imageexportjob angeben. In diesem Beispiel lautet der Exportjobname
my-image-export. Geben Sie für die Untereigenschaft storage_bucket name den Namen des Buckets IBM Cloud Object Storage an, in das Sie das angepasste Image exportieren möchten. In diesem Beispiel lautet
der Bucketname bucket-27200-lwx4cfvcue. Alternativ können Sie die Untereigenschaft crn verwenden, um den CRN des Buckets anzugeben.
curl -X POST \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-image-export",
"storage_bucket": {
"name": "bucket-27200-lwx4cfvcue"
}
}'
Angepassten Imageexportverlauf anzeigen und verwalten
Sie können den benutzerdefinierten Imageexportverlauf anzeigen, um Details wie den Namen des Exportjobs, den Status, das Zielbucket in IBM Cloud Object Storage, den zugeordneten Objektnamen IBM Cloud Object Storage, das Datum, an dem der Exportjob gestartet wurde, und, wenn der Exportjob abgeschlossen ist, das Fertigstellungsdatum anzuzeigen.
Sie können auch einen abgeschlossenen Imageexportjob löschen. Sie können auch einen in Bearbeitung befindlichen Imageexportjob löschen (und abbrechen), wenn Sie über eine IAM-Rolle verfügen, die die Aktion is.image.image.export enthält.
Wenn Sie einen Imageexportjob löschen, wird er nur aus dem Exportprotokoll entfernt. Die exportierte Bilddatei wird nicht aus dem IBM Cloud Object Storage Bucket entfernt. Sie müssen Dateien, die in IBM Cloud Object Storage gespeichert sind, über die Schnittstellen IBM Cloud Object Storage verwalten.
Schließlich können Sie einen Imageexportjob umbenennen. Durch das Umbenennen des Imageexportjobs wird der Name des Objekts, das in IBM Cloud Object Storageerstellt wird, nicht geändert.
Grenzwerte für Imageexportjobs
Für Imageexportjobs gelten die folgenden Grenzwerte:
- Fünf aktive Exportjobanforderungen pro Image
- Insgesamt zehn Exportjobs pro Image
- Zwanzig aktive Exportjobs pro Konto und Region
Angepasstes Imageexportprotokoll über die Benutzerschnittstelle anzeigen
Führen Sie die folgenden Schritte aus, um den Exportverlauf eines angepassten Image anzuzeigen:
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
>
VPC > Compute > Images.
- Klicken Sie auf der Registerkarte Benutzerdefinierte Images auf den Namen eines benutzerdefinierten Images, um Details zu diesem Image anzuzeigen.
- Klicken Sie auf der Seite Imagedetails auf die Registerkarte Exportprotokoll.
Imageexportjob über die Benutzerschnittstelle löschen oder abbrechen
Führen Sie die folgenden Schritte aus, um einen abgeschlossenen Imageexportjob zu löschen oder einen in Bearbeitung befindlichen Imageexportjob abzubrechen (und zu löschen).
- Klicken Sie auf der Seite mit den Bilddetails auf die Registerkarte Exportprotokoll.
- Klicken Sie für den Exportjob, den Sie löschen oder abbrechen möchten, auf das Aktionssymbol
und wählen Sie Löschen aus.
Imageexportjob über die Benutzerschnittstelle umbenennen
Führen Sie die folgenden Schritte aus, um einen Imageexportjob umzubenennen.
- Klicken Sie auf der Seite mit den Bilddetails auf die Registerkarte Exportprotokoll.
- Klicken Sie für den Exportjob, den Sie umbenennen möchten, auf das Aktionssymbol
und wählen Sie Umbenennen aus.
Angepasstes Imageexportprotokoll über die Befehlszeilenschnittstelle anzeigen
Um den Exportverlauf eines bestimmten angepassten Image über die Befehlszeilenschnittstelle anzuzeigen, verwenden Sie den Befehl ibmcloud is image-export-jobs. Geben Sie den Namen oder die ID des angepassten Image an, das
mit der Variablen IMAGE exportiert wurde.
ibmcloud is image-export-jobs IMAGE
Das folgende Beispiel zeigt den Exportjobverlauf für ein angepasstes Image mit der ID 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479.
ibmcloud is image-export-jobs 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
Weitere Informationen finden Sie unter ibmcloud is image-export-jobs auf der Referenzseite zur VPC-CLI.
Details zum Imageexportjob über die Befehlszeilenschnittstelle anzeigen
Verwenden Sie den Befehl ibmcloud is image-export-job, um die Details eines bestimmten Imageexportjobs über die Befehlszeilenschnittstelle anzuzeigen. Geben Sie den Namen oder die ID des angepassten Image an,
das mit der Variablen IMAGE exportiert wurde. Geben Sie den Namen oder die ID des Imageexportjobs mit der Variablen JOB an.
ibmcloud is image-export-job IMAGE JOB
Weitere Informationen finden Sie unter ibmcloud is image-export-job auf der VPC-CLI-Referenzseite.
Imageexportjob über die Befehlszeilenschnittstelle löschen oder abbrechen
Verwenden Sie den Befehl ibmcloud is image-export-job-delete, um einen abgeschlossenen Imageexportjob zu löschen oder einen in Bearbeitung befindlichen Imageexportjob abzubrechen (und zu löschen). Geben Sie den
Namen oder die ID des angepassten Image an, das mit der Variablen IMAGE exportiert wurde. Geben Sie den Namen oder die ID des Imageexportjobs mit der Variablen JOB an.
ibmcloud is image-export-job-delete IMAGE JOB
Weitere Informationen finden Sie unter ibmcloud is image-export-job-delete auf der Referenzseite der VPC-CLI.
Imageexportjob über die Befehlszeilenschnittstelle umbenennen
Verwenden Sie den Befehl ibmcloud is image-export-job-update, um einen angepassten Imageexportjob über die Befehlszeilenschnittstelle umzubenennen. Geben Sie den Namen oder die ID des angepassten Image an, das
mit der Variablen IMAGE exportiert wurde. Geben Sie den Namen oder die ID des Imageexportjobs mit der Variablen JOB an. Geben Sie mit der Variablen NAME den neuen Namen an, den Sie dem Imageexportjob
zuordnen möchten.
ibmcloud is image-export-job-update IMAGE JOB --name NAME
Weitere Informationen finden Sie unter ibmcloud is image-export-job-update auf der VPC-CLI-Referenzseite.
Angepasstes Imageexportprotokoll über die API anzeigen
Um den Exportverlauf eines bestimmten angepassten Image mithilfe der API anzuzeigen, verwenden Sie Alle Imageexportjobs auflisten.
Geben Sie für die Variable $image_id die ID des angepassten Images an, für das Sie Exportjobs anzeigen wollen.
curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Details eines Imageexportjobs über die API anzeigen
Zum Anzeigen der Details eines bestimmten Imageexportjobs mithilfe der API verwenden Sie Imageexportjob abrufen.
Geben Sie für die Variable $image_id die ID des angepassten Image an, das exportiert wurde. Geben Sie für die Variable $export_job_id die ID des Imageexportjobs an, für den Sie Details abrufen wollen.
curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Imageexportjob über die API löschen oder abbrechen
Zum Löschen eines abgeschlossenen Imageexportjobs oder zum Abbrechen (und Löschen) eines in Bearbeitung befindlichen Imageexportjobs mithilfe der API verwenden Sie Imageexportjob löschen.
Geben Sie für die Variable $image_id die ID des angepassten Image an, für die Sie einen Exportjob löschen wollen. Geben Sie für die Variable $export_job_id die ID des Imageexportjobs an, den Sie löschen wollen.
curl -X DELETE \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Imageexportjob über die API umbenennen
Um einen angepassten Imageexportjob mithilfe der API umzubenennen, verwenden Sie Imageexportjob aktualisieren.
Geben Sie für die Variable $image_id die ID des angepassten Image an, für das Sie einen Exportjob umbenennen wollen. Geben Sie für die Variable $export_job_id die ID des Imageexportjobs an, den Sie umbenennen möchten.
Der neue Name, der dem Imageexportjob im folgenden Beispiel zugeordnet werden muss, lautet my-export-job-patched.
curl -X PATCH \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-export-job-patched"
}'
Angepasstes Image über die Benutzerschnittstelle mit einem privaten Katalog gemeinsam nutzen
Sie können ein vorhandenes angepasstes IBM Cloud VPC-Image für einen vorhandenen privaten Katalog freigeben. Wenn Sie noch keinen privaten Katalog haben, finden Sie weitere Informationen unter Onboarding eines virtuellen Server-Images für VPC.
Die Aktion Image im privaten Katalog teilen ist für die folgenden Images nicht verfügbar:
- Das Image wurde bereits in einem privaten Katalog freigegeben. Ein Image in einem privaten Katalog kann nur in einer Version innerhalb eines Produktangebots in einem privaten Katalog vorhanden sein. Sie müssen das Image aus der Version entfernen, in der es sich befindet, bevor es in einer anderen Version gemeinsam genutzt werden kann.
- Das Image ist verschlüsselt.
- Das Image ist kein x86-Image.
Führen Sie die folgenden Schritte aus, um ein angepasstes Image für einen privaten Katalog freizugeben.
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenü
>
VPC > Compute > Images.
- Klicken Sie auf der Registerkarte Angepasste Images auf das Symbol 'Aktionen'
und wählen Sie Im Katalog gemeinsam nutzen aus.
- Wählen Sie auf der Seite Image für privaten Katalog freigeben einen privaten Katalog aus der Liste der verfügbaren privaten Kataloge aus.
- Geben Sie eine Versionsnummer in Softwareversion ein.
- Klicken Sie auf Katalogangebot erstellen, um das Image für den privaten Katalog freizugeben.
- Nachdem das Image erstellt wurde, klicken Sie auf Image validieren.
Bei diesem Vorgang wird das benutzerdefinierte Bild nur für den privaten Katalog freigegeben. Der Validierungsprozess findet im privaten Katalog statt. Wenn Sie auf Image validieren klicken, wird eine neue Seite angezeigt. In dieser Anzeige können Sie mit Schritt 3: Image des virtuellen Servers im Onboarding eines Image eines virtuellen Servers für VPC validieren beginnen, um den Validierungsprozess abzuschließen.
Angepasstes Image über die Befehlszeilenschnittstelle für einen privaten Katalog freigeben
Sie können ein benutzerdefiniertes Bild nur über die Benutzeroberfläche in einem privaten Katalog von IBM Cloud VPC teilen. Weitere Informationen zum Onboarding in einen privaten Katalog mithilfe der CLI finden Sie unter Onboarding von Software in Ihr Konto.
Angepasstes Image mithilfe der API in einem privaten Katalog gemeinsam nutzen
Sie können ein benutzerdefiniertes Bild nur über die Benutzeroberfläche in einem privaten Katalog von IBM Cloud VPC teilen. Weitere Informationen zum Onboarding in einen privaten Katalog mithilfe der API finden Sie unter Onboarding von Software in Ihr Konto.
Angepasstes Image mit Terraform in einem privaten Katalog gemeinsam nutzen
Sie können ein benutzerdefiniertes Bild nur über die Benutzeroberfläche in einem privaten Katalog von IBM Cloud VPC teilen. Weitere Informationen zum Onboarding in einen privaten Katalog mithilfe von Terraform finden Sie unter Onboarding von Software in Ihr Konto.
Planen Sie eine benutzerdefinierte Änderung des Image-Lebenszyklusstatus in der Konsole
Sie können eine Änderung des Lebenszyklusstatus eines einzelnen Images oder die Statusänderungen für den gesamten Lebenszyklus des Image planen. Sie können eine sofortige Statusänderung nur vornehmen, wenn Sie keine zukünftige Statusänderung geplant haben.
Führen Sie die folgenden Schritte aus, um eine einzelne Statusänderung zu planen:
Sie können eine einzelne Statusänderung für ein Image planen.
- Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenüsymbol
> Infrastruktur-
> Compute > Images.
- Klicken Sie auf der Registerkarte Angepasste Images auf das Symbol 'Aktionen'
für ein bestimmtes Image und wählen Sie eine der verfügbaren Optionen aus.
- Wählen Sie Lebenszyklus planen aus.
- Wählen Sie unter Imagestatus die Statusänderung für das Image aus.
- Wählen Sie unter Details zu veralteten Features aus, ob der Status Sofort oder Datum in der Zukunft planen geändert werden soll.
- Wenn Sie "Termin in der Zukunft" gewählt haben, müssen Sie die folgenden Felder ausfüllen:
- Wählen Sie Nach Kalenderdatum oder Nach Anzahl der Tage aus.
- Wenn Sie Nach Kalenderdatum ausgewählt haben, geben Sie das Datum und die Uhrzeit ein. Dies ist der Zeitpunkt (Datum und Uhrzeit), zu dem die Statusänderung erfolgt.
- Wenn Sie Nach Anzahl der Tage ausgewählt haben, geben Sie an, wie viele Tage vergehen, bevor der Status geändert wird.
- Wählen Sie Nach Kalenderdatum oder Nach Anzahl der Tage aus.
- Klicken Sie auf Speichern.
Führen Sie die folgenden Schritte aus, um den gesamten Lebenszyklus des Image zu planen:
Sie können den vollständigen Lebenszyklus für das Image planen. Das Image ist zunächst veraltet und wird dann entsprechend dem von Ihnen definierten Zeitplan in veraltet geändert. Verwenden Sie die folgenden Schritte, um eine Lebenszyklusänderung zu planen.
-
Gehen Sie in der IBM Cloud-Konsole zum Navigationsmenüsymbol
> Infrastruktur-
> Compute > Images.
-
Klicken Sie auf der Registerkarte Angepasste Images auf das Symbol 'Aktionen'
für ein bestimmtes Image und wählen Sie eine der verfügbaren Optionen aus.
-
Wählen Sie Lebenszyklus planen aus.
-
Wählen Sie Kompletten Lebenszyklus planen.
- Wenn Sie Nach Kalenderdatum ausgewählt haben, geben Sie das Datum und die Uhrzeit für die Statusänderung ein.
- Wenn Sie Nach Anzahl von Tagen ausgewählt haben, geben Sie die Anzahl der Tage an, die vergehen sollen, bis der Status geändert wird.
Das veraltete Datum muss nach dem veralteten Datum liegen.
-
Klicken Sie auf Zeitplan.
Lebenszyklusstatus des angepassten Image über die Befehlszeilenschnittstelle ändern
Sie können den Lebenszyklusstatus eines angepassten IBM Cloud VPC-Image über die Befehlszeilenschnittstelle (CLI) ändern. Sie können eine sofortige Statusänderung vornehmen, indem Sie den Befehl ibmcloud is image-deprecate oder
ibmcloud is image-obsolete verwenden. Sie können diese Statusänderungen auch für einen späteren Zeitpunkt planen, indem Sie den Befehl ibmcloud is image-update verwenden. Geben Sie den Namen oder die ID des
angepassten Images mit der Variablen IMAGE an.
Verwenden Sie eines der folgenden Beispiele, um eine sofortige Statusänderung vorzunehmen.
Sie können eine sofortige Statusänderung nur vornehmen, wenn keine zukünftige Statusänderung geplant ist. Informationen zum Entfernen einer geplanten Statusänderung finden Sie unter Geplante Änderung des Lebenszyklusstatus eines angepassten Image über die Befehlszeilenschnittstelle entfernen. Nachdem Sie die geplante Statusänderung entfernt haben, können Sie eine sofortige Statusänderung vornehmen.
-
Ändern Sie den Lebenszyklusstatus des Images in
deprecate.ibmcloud is image-deprecate IMAGE -
Ändern Sie den Lebenszyklusstatus des Images in
obsolete.ibmcloud is image-obsolete IMAGE
Verwenden Sie das folgende Beispiel, um eine Statusänderung zu planen.
Geben Sie für die Option deprecate-at oder obsolete-at ein Datum im Datums-und Zeitformat nach ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) an.
YYYYist die vierstellige JahresangabeMMist die zweistellige MonatsangabeDDist die zweistellige TagesangabeTtrennt die Datums-und Zeitinformationenhhist die zweistellige Stundenangabemmist die zweistellige Minutenangabe+hh:mmoder-hh:mmist die UTC-Zeitzone.
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 sowohl das Datum deprecate-at als auch das Datum obsolete-at definieren, muss das Datum obsolete-at nach dem Datum deprecate-at liegen.
ibmcloud is image-update IMAGE [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]
Wenn Sie die Datums-und Zeiteinträge für deprecate-at und obsolete-at ändern möchten, können Sie diese Befehle erneut ausführen. Die vorherigen Datums-und Zeitangaben werden dann durch die neuen Datums-und Zeitangaben
ersetzt.
Zuvor geplante Änderung des Lebenszyklusstatus eines angepassten Images über die Befehlszeilenschnittstelle entfernen
Sie können eine geplante Statusänderung mithilfe der Optionen --reset-deprecate-at oder --reset-obsolete-at entfernen. Wenn Sie eine dieser Optionen mit dem Befehl ibmcloud is image-update verwenden,
werden Datum und Uhrzeit aus dem Image entfernt. Das Image ist nicht mehr für diese Statusänderung geplant.
ibmcloud is image-update IMAGE [--reset-deprecate-at] [--reset-obsolete-at]
Wenn Sie sowohl die Option --reset-deprecate-at als auch die Option --reset-obsolete-at verwenden, wird der Imagestatus an availablezurückgegeben.
Ändern Sie den Lebenszyklusstatus angepasster Images mithilfe der API.
Sie können den Lebenszyklusstatus eines angepassten IBM Cloud VPC-Image über die Anwendungsprogrammierschnittstelle (API) ändern. Sie können eine sofortige Statusänderung vornehmen oder eine Statusänderung für einen späteren Zeitpunkt planen.
Verwenden Sie eines der folgenden Beispiele, um eine sofortige Statusänderung vorzunehmen. Geben Sie für die Variable $image_id die ID des angepassten Image für die Statusänderung an.
Sie können eine sofortige Statusänderung nur vornehmen, wenn keine zukünftige Statusänderung geplant ist. Informationen zum Entfernen einer geplanten Statusänderung finden Sie unter Geplante Änderung des Lebenszyklusstatus eines angepassten Images mithilfe der API entfernen. Nachdem Sie die geplante Statusänderung entfernt haben, können Sie eine sofortige Statusänderung vornehmen.
-
Ändern Sie den Lebenszyklusstatus des Images in
deprecated.curl -X POST "$vpc_api_endpoint/v1/images/$image_id/deprecate?version=2023-02-21&generation=2" -H “Authorization: Bearer $iam_token” -
Ändern Sie den Lebenszyklusstatus des Images in
obsolete.curl -X POST "$vpc_api_endpoint/v1/images/$image_id/obsolete?version=2023-12-21&generation=2" -H “Authorization: Bearer $iam_token”
Verwenden Sie eines der folgenden Beispiele, um eine Statusänderung zu planen.
Geben Sie für die Eigenschaften deprecation_at oder obsolescence_at ein Datum im Datums-und Zeitformat nach ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) an.
YYYYist die vierstellige JahresangabeMMist die zweistellige MonatsangabeDDist die zweistellige TagesangabeTtrennt die Datums-und Zeitinformationenhhist die zweistellige Stundenangabemmist die zweistellige Minutenangabe+hh:mmoder-hh:mmist die UTC-Zeitzone.
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.
-
Planen Sie eine Statusänderung in
deprecated.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": "2023-03-01T06:11:28+05:30" }' -
Planen Sie eine Statusänderung in
obsolete.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": "2023-12-31T06:11:28+05:30" }'Wenn Sie die Datums-und Zeiteinträge für
deprecation_atundobsolescence_atändern möchten, können Sie diese Befehle erneut ausführen. Die vorherigen Datums-und Zeitangaben werden durch die neuen Datums-und Zeitangaben ersetzt.
Lebenszyklusstatus zuvor geplanter angepasster Images mithilfe der API entfernen
Stellen Sie eine PATCH /images -Anforderung zum Entfernen einer geplanten Statusänderung, indem Sie deprecation_at oder obsolescence_at auf nullaktualisieren. Diese Eigenschaftsänderung entfernt
das Datum und die Zeit aus dem Image und das Image wird nicht mehr für diese Statusänderung geplant.
-
Um ein Bild von
deprecatedinavailablezu ändern, ändern Sie die Eigenschaftdeprecation_atinnull.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null }' -
Um ein Image von
obsoletein den vorherigen Status zu ändern, ändern Sieobsolescence_atinnull. Wenn das Bild zuvor einen anderen Wert alsnullfürdeprecation_atenthielt, entfernt diese Eigenschaftsänderung den Statusobsoleteund ändert ihn wieder indeprecated. Wenn der vorherige Statusavailablewar, was bedeutet, dass das Image direkt vonavailablenachobsoleteverschoben wurde, wird diese Eigenschaftsänderung vonobsoletezurück nachavailableverschoben.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": null }' -
Wenn Sie ein Image ändern möchten, für das sowohl die Eigenschaft
deprecation_atals auch die Eigenschaftobsolescence_ataufavailablezurückgesetzt wurde, müssen Sie sowohl die Eigenschaftdeprecation_atals auch die Eigenschaftobsolescence_ataktualisieren.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null, “obsolescence_at": null }'
Ändern Sie den Lebenszyklusstatus des benutzerdefinierten Bildes mithilfe von Terraform
Um mithilfe von Terraform eine sofortige Statusänderung vorzunehmen, verwenden Sie die ibm_is_image_deprecate oder ibm_is_image_obsolete ressourcenbefehle. Verwenden Sie eines der folgenden Beispiele.
Geben Sie für die Variable name den Namen des angepassten Image für die Statusänderung an.
Sie können eine sofortige Statusänderung nur vornehmen, wenn eine zukünftige Statusänderung nicht geplant ist. Informationen zum Entfernen einer geplanten Statusänderung finden Sie unter Geplante Änderung des Lebenszyklusstatus eines angepassten Image mit Terraform entfernen. Nach dem Entfernen der geplanten Statusänderung können Sie eine sofortige Statusänderung vornehmen.
-
Ändern Sie den Lebenszyklusstatus des Images 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" encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0=" encryption_key = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx" } resource "ibm_is_image_deprecate" "example" { image = ibm_is_image.example.id } -
Ändern Sie den Lebenszyklusstatus des Images 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" encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0=" encryption_key = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx" } resource "ibm_is_image_obsolete" "example" { image = ibm_is_image.example.id }
Verwenden Sie eines der folgenden Beispiele, um eine Statusänderung zu planen.
Geben Sie für das Attribut deprecation_at oder obsolescence_at ein Datum im Datums-und Zeitformat nach ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) an.
YYYYist die vierstellige JahresangabeMMist die zweistellige MonatsangabeDDist die zweistellige TagesangabeTtrennt die Datums-und Zeitinformationenhhist die zweistellige Stundenangabemmist die zweistellige Minutenangabe+hh:mmoder-hh:mmist die Zeitzone der koordinierten Weltzeit
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 Datum und Uhrzeit festlegen, können Sie nicht Ihr aktuelles Datum und Ihre aktuelle Uhrzeit 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.
-
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" deprecation_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" }Wenn Sie die Datums-und Zeiteinträge für
deprecation_atundobsolescence_atändern möchten, können Sie diese Befehle erneut ausführen. Die vorherigen Datums-und Zeitangaben werden durch die neuen Datums-und Zeitangaben ersetzt.
Entfernen Sie zuvor geplante benutzerdefinierte Bild-Lebenszyklus-Status mithilfe von Terraform
Zum Entfernen einer geplanten Statusänderung aktualisieren Sie die Attribute deprecation_at oder obsolescence_at auf null. Diese Attributänderung entfernt das Datum und die Zeit aus dem Image und das Image
ist nicht mehr für diese Statusänderung geplant.
-
Um ein Bild von
deprecatedinavailablezu ändern, ändern Sie die Eigenschaftdeprecation_atinnull.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" deprecation_at = null } -
Um ein Image von
obsoletein den vorherigen Status zu ändern, ändern Sieobsolescence_atinnull. Wenn das Image zuvor einen anderen Wert alsnullfürdeprecation_atenthielt, entfernt diese Attributänderung denobsolete-Status und ändert ihn wieder indeprecated. Wenn der vorherige Statusavailablewar, was bedeutet, dass das Image direkt vonavailablenachobsoleteverschoben wurde, wird diese Attributänderung vonobsoletezurück nachavailableverschoben.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 = null } -
Wenn Sie ein Image ändern möchten, für das die Eigenschaften
deprecation_atoderobsolescence_ataufavailablezurückgesetzt wurden, müssen Sie sowohl das Attributdeprecation_atals auch das Attributobsolescence_ataktualisieren.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" deprecation_at = null obsolescence_at = null }