Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Linux
Windows
In diesem Dokument werden die häufigsten Probleme beschrieben, die beim Importieren von Bildern in Compute Engine und beim Exportieren von Bildern nach Cloud Storage auftreten können.
Probleme beim Import und Export von Bildern diagnostizieren
Sie können die Ursache für Probleme beim Importieren oder Exportieren von Bildern ermitteln, indem Sie die Cloud Build-Logs und die Ausgabe des seriellen Ports der temporären VMs (oder Worker-VMs) prüfen.
Logs von Cloud Build prüfen
Das Tool zum Importieren von Images verwendet die Cloud Build API, um Images zu importieren und zu exportieren.
Prüfen Sie die Cloud Build-Logs, um den Status des laufenden Prozesses abzurufen.
So rufen Sie Cloud Build-Logs auf:
Wenn Sie Images mithilfe der Google Cloud Console importieren oder exportieren, rufen Sie auf der Seite Images in der Google Cloud Console die Logs im Tab Image-Importverlauf oder Image-Exportverlauf auf.
Klicken Sie auf die Cloud Build-ID, um die Logs aufzurufen.
Wenn Sie Bilder mithilfe der Google Cloud CLI importieren oder exportieren, können Sie den Cloud Build-Log-Speicherort nach dem Ausführen des Prozesses in der Standardausgabe sehen.
Ausgabe des seriellen Ports prüfen
Die Ausgabe des seriellen Ports der Worker-VMs, die beim Image-Import oder -Export erstellt werden, kann hilfreich sein, um Probleme mit Entitäten auf Systemebene zu beheben. Weitere Informationen zu diesen Logs finden Sie unter Ausgabe des seriellen Ports ansehen.
Häufige Fehler
Im Folgenden finden Sie Beispiele für häufige Fehler, die beim Importieren oder Exportieren von Bildern auftreten können.
ExportFailed-Fehler beim Exportieren von Images, die größer als 2 TB sind
Die maximale Größe für Bilder in den Formaten vmdk, vpc und vhd ist auf 2 TB begrenzt. Wenn Sie in diese Formate Images mit mehr als 2 TB exportieren, erhalten Sie möglicherweise eine Fehlermeldung ähnlich der folgenden im Log:
Fehlermeldung:
[image -export]: 2022 - 01 - 27T16: 08: 24Z Error running workflow: step
"image-export-export-disk" run error: step "wait-for-inst-image-export-export-disk"
run error: WaitForInstancesSignal FailureMatch found for
"WORKER_VM_NAME--SUFFIX":
"ExportFailed: Failed to export disk source to DESTINATION_URI"
Lösung:
Geben Sie zur Behebung dieses Problems das Image-Format als vdi ,vhdx oder qcow2 an und legen Sie den --timeout-Wert als 24h fest, wenn Sie den
gcloud compute images export-Befehl ausführen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-03 (UTC)."],[[["\u003cp\u003eThis document provides guidance on diagnosing common issues encountered when importing images to Compute Engine or exporting images to Cloud Storage.\u003c/p\u003e\n"],["\u003cp\u003eCloud Build logs, accessible via the Google Cloud console or CLI, can be reviewed to track the status of image import and export processes.\u003c/p\u003e\n"],["\u003cp\u003eReviewing the serial port output of worker VMs can help in troubleshooting system-level issues during image import or export.\u003c/p\u003e\n"],["\u003cp\u003eExporting images larger than 2 TB in \u003ccode\u003evmdk\u003c/code\u003e, \u003ccode\u003evpc\u003c/code\u003e, or \u003ccode\u003evhd\u003c/code\u003e formats may result in an \u003ccode\u003eExportFailed\u003c/code\u003e error, and specifying \u003ccode\u003evdi\u003c/code\u003e, \u003ccode\u003evhdx\u003c/code\u003e, or \u003ccode\u003eqcow2\u003c/code\u003e as the format may resolve this.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting image import and export\n\nLinux Windows\n\n*** ** * ** ***\n\nThis document describes the common issues that you might encounter when you import images to Compute Engine and when you export images to Cloud Storage.\n\n\u003cbr /\u003e\n\nDiagnose image import and export issues\n---------------------------------------\n\nDiagnose the cause of image import or export issues by reviewing the\nCloud Build logs and the serial port output of the temporary\nVMs (or worker VMs).\n\n### Review Cloud Build logs\n\nThe image import tool uses the Cloud Build API to import and export images.\nReview the Cloud Build logs to get the status of the running process.\n\nTo view Cloud Build logs, do one of the following:\n\n- If you import or export images by using Google Cloud console, view logs on the\n **Images** page in the Google Cloud console, in the **Image import history** or **Image export history** tab.\n Click the Cloud Build ID to view the logs.\n\n [Go to Images](https://console.cloud.google.com/compute/images)\n- If you import or export images by using Google Cloud CLI, you can view the\n Cloud Build log location at the standard output after running the process.\n\n### Review serial port output\n\nReviewing the serial port output of the worker VMs that are created during the image\nimport or export process might be useful to troubleshoot issues with system-level\nentities. For more information about these logs,\nsee [Viewing serial port output](/compute/docs/troubleshooting/viewing-serial-port-output).\n\nCommon errors\n-------------\n\nThe following are examples of common errors you might encounter when you import\nor export images.\n\n### ExportFailed error when exporting images larger than 2 TB\n\nThe maximum size for images in `vmdk`, `vpc`, and `vhd` formats is limited to\n2 TB. Therefore, when you export images larger than 2 TB in these formats, you\nmight see an error message similar to the following in the log:\n\n**Error message**: \n\n```\n[image -export]: 2022 - 01 - 27T16: 08: 24Z Error running workflow: step\n\"image-export-export-disk\" run error: step \"wait-for-inst-image-export-export-disk\"\nrun error: WaitForInstancesSignal FailureMatch found for\n\"WORKER_VM_NAME--SUFFIX\":\n\"ExportFailed: Failed to export disk source to DESTINATION_URI\"\n```\n\n**Resolution**:\n\nTo resolve this issue, specify the image format as `vdi`, `vhdx`, or `qcow2` and\nset the `--timeout` value as `24h` when you run the\n[`gcloud compute images export` command](/sdk/gcloud/reference/compute/images/export).\n\nIf the issue persists, contact [Google Cloud Support](/support) for\nassistance."]]
