Résoudre les problèmes d'importation et d'exportation d'images
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Linux
Windows
Ce document décrit les problèmes courants que vous pouvez rencontrer lors de l'importation d'images dans Compute Engine et lors de l'exportation d'images vers Cloud Storage.
Diagnostiquer les problèmes d'importation et d'exportation d'images
Pour identifier la cause des problèmes d'importation ou d'exportation d'images, consultez les journaux Cloud Build et la sortie du port série des VM temporaires (ou VM de nœud de calcul).
Consulter les journaux Cloud Build
L'outil d'importation d'images utilise l'API Cloud Build pour importer et exporter des images.
Consultez les journaux Cloud Build pour obtenir l'état du processus en cours d'exécution.
Pour afficher les journaux Cloud Build, effectuez l'une des opérations suivantes :
Si vous importez ou exportez des images à l'aide de la console Google Cloud , consultez les journaux sur la page Images de la console Google Cloud , dans l'onglet Historique des importations d'images ou Historique des exportations d'images.
Cliquez sur l'ID Cloud Build pour afficher les journaux.
Si vous importez ou exportez des images à l'aide de la Google Cloud CLI, vous pouvez afficher l'emplacement du journal Cloud Build dans la sortie standard après avoir exécuté le processus.
Vérifier la sortie du port série
L'examen des résultats du port série des VM de nœud de calcul créées lors du processus d'importation ou d'exportation d'image peut être utile pour résoudre les problèmes liés aux entités au niveau du système. Pour en savoir plus sur ces journaux, consultez la page Afficher la sortie du port série.
Erreurs fréquentes
Vous trouverez ci-dessous des exemples d'erreurs courantes que vous pouvez rencontrer lors de l'importation ou de l'exportation d'images.
Erreur ExportFailed lors de l'exportation d'images de plus de 2 To
La taille maximale des images aux formats vmdk, vpc et vhd est limitée à 2 To. Par conséquent, lorsque vous exportez des images de plus de 2 To dans ces formats, un message d'erreur semblable à celui-ci peut s'afficher dans le journal :
Message d'erreur :
[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"
Solution :
Pour résoudre ce problème, spécifiez le format d'image vdi, vhdx ou qcow2 et définissez la valeur --timeout sur 24h lorsque vous exécutez la commande gcloud compute images export.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
