Images importieren/exportieren

Mit dem Imageimport/-export können Sie benutzerdefinierte Images mandanten- und regionsübergreifend freigeben.

Wichtig

Um benutzerdefinierte Images aus Object Storage-Buckets zu importieren oder exportieren, müssen föderierte Benutzer und Benutzer, die sich mit an eine dynamische Gruppe gebundenen Instanz-Principals authentifizieren, eine vorab authentifizierte Anforderung erstellen. Weitere Informationen finden Sie unter dem bekannten Problem Fehlermeldung über ungültigen bucketName beim Importieren oder Exportieren eines benutzerdefinierten Images.

Plattformimages, Marketplace-Images und benutzerdefinierte Images, die aus Marketplace-Images erstellt wurden, können nicht exportiert werden.

Linux-basierte Betriebssysteme

Die folgenden Betriebssysteme unterstützen den Import/Export von Images:

  • Oracle Linux 6.x
  • Oracle Linux 7.x
  • Oracle Linux 8.x
  • Oracle Linux 9.x
  • Oracle Linux Cloud Developer 8.x
  • CentOS 7
  • CentOS Stream 8
  • Ubuntu 18.04
  • Ubuntu 20.04
  • Ubuntu 22.04

Windows-basierte Betriebssysteme

Die folgenden Windows-Versionen unterstützen den Import/Export von Images:

  • Windows Server 2012 Standard, Datacenter
  • Windows Server 2012 R2 Standard, Datacenter
  • Windows Server 2016 Standard, Datacenter
  • Windows Server 2019 Standard, Datacenter
  • Windows Server 2022 Standard, Datacenter
Wichtig

Beim Exportieren von Windows-basierten Images sind Sie für die Einhaltung der Microsoft-Produktbedingungen und aller Produktnutzungsbedingungen sowie für die Überprüfung der Compliance mit Microsoft verantwortlich.

Weitere Informationen über die Lizenzanforderungen für Windows-Images finden Sie unter Microsoft-Lizenzen in Oracle Cloud Infrastructure.

Ihr Windows-Betriebssystem prüfen

Achten Sie beim Import von benutzerdefinierten Windows-Images darauf, dass die ausgewählte Version mit dem importierten Windows-Image übereinstimmt. Wenn Sie nicht die korrekten Versions- und SKU-Informationen angeben, kann dies eine Verletzung Ihres Microsoft-Lizenzvertrags darstellen.

Windows-Systemzeitproblem auf benutzerdefinierten Windows-Instanzen

Wenn Sie die Standardeinstellung für die Zeitzone auf Windows-VM-Instanzen ändern und die Instanz neu gestartet oder mit der Hardwareuhr synchronisiert wird, wird die Systemzeit auf die Zeit der Standardzeitzone zurückgesetzt. Für die Zeitzoneneinstellung bleibt jedoch die neue Zeitzone festgelegt, sodass die Systemuhr falsch geht. Sie können dieses Problem beheben, indem Sie den Registrierungsschlüssel HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation auf 1 setzen.

Für Windows-Plattformimages ist bereits standardmäßig der Registrierungsschlüssel RealTimeIsUniversal festgelegt. Sie müssen diesen jedoch für alle benutzerdefinierten Windows-Images festlegen, die Sie importieren.

So beheben Sie dieses Problem für benutzerdefinierte Windows-Images:

  1. Öffnen Sie den Windows Registrierungs-Editor, und navigieren Sie zum Registrierungsschlüssel HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation.
  2. Erstellen Sie unter DWORD einen neuen Schlüssel mit dem Namen RealTimeIsUniversal, und setzen Sie den Wert auf 1.
  3. Starten Sie die Instanz neu.
  4. Setzen Sie die Zeit und die Zeitzone manuell zurück.

Bring Your Own Image-Szenarios

Mit dem Import/Export von Images können Sie auch in Bring Your Own Image-(BYOI-)Szenarios benutzerdefinierte Images in allen Mandanten und Regionen freigeben, um die Images nicht in jeder Region manuell neu erstellen zu müssen. Sie müssen die erforderlichen Schritte ausführen, um das Image manuell in einer der Regionen zu erstellen. Danach können Sie das Image jedoch exportieren, sodass es für den Import in weiteren Mandanten und Regionen verfügbar ist. Exportieren Sie das Image im .oci-Format, einem Dateiformat, das eine QCOW2-Imagedatei und spezifische Metadaten von Oracle Cloud Infrastructure enthält.

Best Practices zum Replizieren eines Images in allen Regionen

Sie können ein Image mit der Konsole oder der API von einer Region in eine andere replizieren. Allgemeiner Prozess:

  1. Exportieren Sie das Image in einen Object Storage-Bucket in derselben Region wie das Image.
  2. Kopieren Sie das Image in einen Object Storage-Bucket in der Zielregion.
  3. Rufen Sie den URL-Pfad zum Imageobjekt ab.
  4. Importieren Sie das Image in die Zielregion. Verwenden Sie den URL-Pfad als Object Storage-URL.

Best Practices zum Freigeben eines Images in allen Mandanten

Sie können ein Image mit der Konsole oder der API von einem Mandanten in einen anderen replizieren. Allgemeiner Prozess:

  1. Exportieren Sie das Image in einen Object Storage-Bucket in derselben Region wie das Image.
  2. Mit vorab authentifizierten Anforderungen arbeiten mit schreibgeschütztem Zugriff für das Image in der Zielregion.

  3. Importieren Sie das Image in den Zielmandanten. Verwenden Sie die URL der vorab authentifizierten Anforderung als Object Storage-URL.

Objektspeicher-URLs

Wenn Sie benutzerdefinierte Images mit der Konsole importieren oder exportieren, müssen Sie möglicherweise die Object Storage-URL angeben. Diese verweist auf das Verzeichnis, in das Sie das Image importieren oder aus dem Sie es exportieren möchten. Object Storage-URLs sind wie folgt strukturiert:

https://<host_name>/n/<namespace_name>/b/<bucket_name>/o/<object_name>

Beispiel:

https://objectstorage.us-phoenix-1.oraclecloud.com/n/MyNamespace/b/MyBucket/o/MyCustomImage.qcow2

Vorab authentifizierte Anforderungen

Wenn Sie mandantenübergreifend importieren/exportieren, müssen Sie eine vorab authentifizierte Object Storage-Anforderung verwenden. Die Schritte zum Erstellen einer vorab authentifizierten Anforderung finden Sie unter Mit vorab authentifizierten Anforderungen arbeiten. Wenn Sie diese Schritte ausführen und auf Vorab authentifizierte Anforderung erstellen klicken, wird das Dialogfeld Details der vorab authentifizierten Anforderung geöffnet. Sie müssen eine Kopie der hier angezeigten URL der vorab authentifizierten Anforderung erstellen, weil diese URL nur an dieser Stelle angezeigt wird. Dies ist die Object Storage-URL, die Sie für den Import/Export angeben.

Hinweis

Vorab authentifizierte Anforderungen für einen Bucket

Wenn Sie beim Imageexport die vorab authentifizierte Anforderung für einen Bucket erstellen, müssen Sie den Objektnamen an die generierte URL anhängen. Beispiel:

/o/MyCustomImage.qcow2

Images exportieren

Sie können Images mit der Konsole oder der API exportieren. Die exportierten Images werden im Oracle Cloud Infrastructure Object Storage gespeichert. Für den Export eines Images benötigen Sie Schreibzugriff auf den Object Storage-Bucket für das Image. Weitere Informationen finden Sie unter Überblick über Object Storage und Schreiben von Objekten in Objektspeicher-Buckets durch Benutzer zulassen.

So exportieren Sie ein Image mit der Konsole

  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Benutzerdefinierte Images.
  2. Klicken Sie auf das gewünschte benutzerdefinierte Image.
  3. Klicken Sie auf Exportieren.
  4. Geben Sie den Object Storage-Speicherort an, in den das Image exportiert werden soll:

    • Export in einen Object Storage-Bucket: Wählen Sie einen Bucket aus. Geben Sie anschließend einen Namen für das exportierte Image ein. Vermeiden Sie die Eingabe von vertraulichen Informationen.
    • In Object Storage-URL exportieren: Geben Sie die Object Storage-URL ein.
  5. Wählen Sie in der Liste Imageformat das Format aus, in das Sie das Image exportieren möchten. Die folgenden Formate sind verfügbar:

    • Oracle Cloud Infrastructure-Datei mit QCOW2-Image und OCI-Metadaten (.oci) Verwenden Sie dieses Format, um ein benutzerdefiniertes Image zu exportieren, das Sie in andere Mandanten oder Regionen importieren möchten.
    • QEMU Copy On Write (.qcow2)
    • Virtual Disk Image (.vdi) für Oracle VM VirtualBox
    • Virtual Hard Disk (.vhd) für Hyper-V
    • Virtual Machine Disk (.vmdk)
  6. Klicken Sie auf Image exportieren.

Nachdem Sie auf Image exportieren geklickt haben, wechselt der Imagestatus zu Wird exportiert. Images sind eine Kopie des VM- oder BM-Instanz-Boot-Volumes und der Metadaten, die beim Erstellen des Images angefertigt wird und den aktuellen Status der Instanz erfasst. Wenn Sie ein benutzerdefiniertes Image exportieren, werden die Daten in den angegebenen Object Storage-Speicherort kopiert. Während des Exportvorgangs können Sie weiterhin Instanzen starten. Das Image kann jedoch erst gelöscht werden, wenn der Export abgeschlossen ist. Um den Fortschritt des Vorgangs zu verfolgen und Fehler zu beheben, die bei der Instanzerstellung auftreten, verwenden Sie die zugehörige Arbeitsanforderung.

Wenn der Export abgeschlossen ist, wechselt der Imagestatus zu Verfügbar. Wenn der Imagestatus zu Verfügbar wechselt, aber das exportierte Image nicht im angegebenen Object Storage-Speicherort angezeigt wird, war der Export nicht erfolgreich. In diesem Fall müssen Sie die Schritte erneut ausführen, um das Image zu exportieren.

Images importieren

Sie können exportierte Images aus dem Object Storage mit der Konsole oder der API importieren. Für den Import eines Images benötigen Sie Lesezugriff auf das Object Storage-Objekt mit dem Image. Weitere Informationen finden Sie unter Herunterladen von Objekten aus Objektspeicher-Buckets durch Benutzer zulassen.

So importieren Sie ein Image mit der Konsole

  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Benutzerdefinierte Images.
  2. Klicken Sie auf Image importieren.
  3. Wählen Sie in der Liste Erstellen in Compartment das Compartment aus, in das Sie das Image importieren möchten.
  4. Geben Sie einen Namen für das Image ein. Vermeiden Sie die Eingabe von vertraulichen Informationen.
  5. Wählen Sie das Betriebssystem aus:

    • Wählen Sie für Linux-Images die Option Linux aus.
    • Wählen Sie für Windows-Images die Option Windows aus. Wählen Sie die Betriebssystemversion aus. Bestätigen Sie, dass das ausgewählte Betriebssystem den Microsoft-Lizenzverträgen entspricht.
  6. Geben Sie den Object Storage-Speicherort an, aus dem das Image importiert werden soll:

    • Aus Object Storage-Bucket importieren: Wählen Sie den Bucket aus, der das Image enthält. Wählen Sie in der Liste Objektname die Imagedatei aus.
    • Aus Object Storage-URL importieren: Geben Sie die Object Storage-URL des Images ein. Beim mandantenübergreifenden Importieren müssen Sie eine URL einer vorab authentifizierten Anforderung angeben.
  7. Wählen Sie im Abschnitt Imagetyp das Format des Images aus. Die folgenden Formate sind verfügbar:

    • VMDK: Virtual Machine Disk (.vmdk)
    • QCOW2: QEMU Copy On Write (.qcow2)
    • OCI: Oracle Cloud Infrastructure-Datei mit QCOW2-Image und OCI-Metadaten (.oci). Verwenden Sie dieses Format, wenn Sie ein benutzerdefiniertes Image importieren, das aus einem anderen Mandanten oder einer anderen Region exportiert wurde.
  8. Wählen Sie den Startmodus aus:

    • Bei benutzerdefinierten Images mit dem Imagetyp .oci ist der Startmodus deaktiviert. Oracle Cloud Infrastructure wählt den geeigneten Startmodus basierend auf dem Startmodus für das Quellimage aus.

    • Wählen Sie für benutzerdefinierte Images, die aus Oracle Cloud Infrastructure exportiert wurden und den Imagetyp QCOW2 aufweisen, die Option Nativer Modus aus.

    • Um andere benutzerdefinierte Images zu importieren, wählen Sie Paravirtualisierter Modus oder Emulierter Modus aus. Weitere Informationen finden Sie unter Bring Your Own Image.

  9. Taggingoptionen anzeigen: Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiformtags auf diese Ressource anzuwenden. Um ein definiertes Tag anzuwenden, benötigen Sie die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
  10. Klicken Sie auf Image importieren.

Wenn Sie auf Image importieren klicken, wird das importierte Image in der Liste Benutzerdefinierte Images für das Compartment mit dem Status Wird importiert angezeigt. Um den Fortschritt des Vorgangs zu verfolgen und Fehler zu beheben, die bei der Instanzerstellung auftreten, verwenden Sie die zugehörige Arbeitsanforderung.

Wenn der Import erfolgreich abgeschlossen ist, wechselt der Status zu Verfügbar. Wenn der Status sich nicht ändert oder in der Liste Benutzerdefinierte Images kein Eintrag angezeigt wird, war der Import nicht erfolgreich. Wenn der Import nicht erfolgreich war, stellen Sie sicher, dass Sie Lesezugriff auf das Object Storage-Objekt haben und das Objekt ein unterstütztes Image enthält.

Tags für Images verwalten

Wenden Sie Tags auf Ihre Ressourcen an, um diese entsprechend Ihren Geschäftsanforderungen zu organisieren. Wenden Sie Tags beim Erstellen einer Ressource an, oder aktualisieren Sie die Ressource später mit den gewünschten Tags. Allgemeine Informationen über das Anwenden von Tags finden Sie unter Ressourcentags.

So verwalten Sie Tags für ein Image
  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Benutzerdefinierte Images.
  2. Klicken Sie auf das gewünschte Image.

  3. Klicken Sie auf die Registerkarte Tags, um die vorhandenen Tags anzuzeigen oder zu bearbeiten. Sie können auch auf Weitere Aktionen und dann auf Tags hinzufügen klicken, um neue Tags hinzuzufügen.

API verwenden

Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-API-Dokumentation und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter SDKs und die CLI.

Mit den folgenden API-Vorgängen können Sie benutzerdefinierte Images importieren/exportieren:

X5- und X7-Kompatibilität für Imageimport/-export

Oracle X5-, X6- und X7-Server verfügen über unterschiedliche Hosthardware. Die Verwendung eines X5- oder X6-Images auf einer X7-Bare-Metal- oder VM-Instanz funktioniert daher möglicherweise nicht ohne weitere Änderungen. Für X7-Hosts empfiehlt Oracle, dass Sie die Plattformimages für X7 verwenden. Weitere Informationen zu den Images, die X7 unterstützen, finden Sie in den Versionshinweisen zu Images. Diese Images wurden explizit mit X7-Hardware erstellt und getestet.

Wenn Sie versuchen, ein vorhandenes X5-Image auf einer X7-Hardware zu verwenden, beachten Sie Folgendes:

  • Keine Windows-Versionen sind miteinander kompatibel.
  • Oracle Autonomous Linux 7 und Oracle Linux 8 sind miteinander kompatibel.
  • Oracle Linux 6, Oracle Linux 7, Oracle Linux 8, Oracle Linux 9, Ubuntu 18.04, Ubuntu 20.04, Ubuntu 22.04, CentOS 7 und CentOS Stream 8 sind miteinander kompatibel. Möglicherweise müssen Sie den Kernel auf die neueste Version aktualisieren, um die neuesten Gerätetreiber zu installieren. Um den Kernel zu aktualisieren, führen Sie einen der folgenden Befehle über eine Terminalsession aus:
    • Oracle Linux
      yum update
    • CentOS 7, CentOS Stream 8
      yum update
    • Ubuntu 18.04, Ubuntu 20.04, Ubuntu 22.04
      apt-get update
                                  apt-get dist-upgrade

Wenn Sie versuchen, ein X6-Image auf Nicht-X6-Hardware zu verwenden, beachten Sie Folgendes:

  • Oracle Linux 6, alle CentOS-Versionen und alle Windows-Versionen sind nicht miteinander kompatibel.
  • Oracle Autonomous Linux 7 und Oracle Linux 8 sind miteinander kompatibel.
  • Oracle Linux 7, Ubuntu 22.04, Ubuntu 20.04 und Ubuntu 18.04 sind miteinander kompatibel. Verwenden Sie die Plattformimages für X6.

Die folgenden primären Gerätetreiber unterscheiden sich zwischen X5-, X6- und X7-Hosts:

  • Netzwerkgerätetreiber
  • NVMe-Laufwerkgerätetreiber
  • GPU-Gerätetreiber

Je nachdem, wie Sie das Image angepasst haben, sind möglicherweise weitere Aktualisierungen erforderlich.