Risolvi i problemi relativi all'importazione e all'esportazione delle immagini
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Linux
Windows
Questo documento descrive i problemi comuni che potresti riscontrare quando
esegui l'importazione e l'esportazione di immagini rispettivamente in Compute Engine
e in Cloud Storage.
Diagnostica dei problemi di importazione ed esportazione delle immagini
Scopri la causa dei problemi di importazione o esportazione delle immagini esaminando
i log di Cloud Build e l'output della porta seriale delle VM
temporanee (o VM worker).
Esamina i log di Cloud Build
Lo strumento di importazione delle immagini utilizza l'API Cloud Build per importare ed esportare immagini.
Esamina i log di Cloud Build per ottenere lo stato del processo in esecuzione.
Per visualizzare i log di Cloud Build, esegui una delle seguenti operazioni:
Se importi o esporti immagini utilizzando la console Google Cloud , visualizza i log nella pagina
Immagini della console Google Cloud , nella scheda Cronologia importazione immagini o Cronologia esportazione immagini.
Fai clic sull'ID Cloud Build per visualizzare i log.
Se importi o esporti immagini utilizzando Google Cloud CLI, dopo aver eseguito il processo, puoi visualizzare la posizione
del log di Cloud Build nell'output standard.
Esamina l'output della porta seriale
La revisione dell'output della porta seriale delle VM worker create durante il processo di importazione
o esportazione dell'immagine potrebbe essere utile per risolvere i problemi relativi alle entità a livello
di sistema. Per ulteriori informazioni su questi log,
consulta Visualizzazione dell'output della porta seriale.
Errori comuni
Di seguito sono riportati alcuni esempi di errori comuni che potresti riscontrare durante l'importazione
o l'esportazione di immagini.
Errore ExportFailed durante l'esportazione di immagini di dimensioni superiori a 2 TB
La dimensione massima per le immagini nei formati vmdk, vpc e vhd è limitata a
2 TB. Pertanto, quando esporti immagini di dimensioni superiori a 2 TB in questi formati, nel log
potresti visualizzare un messaggio di errore simile al seguente:
Messaggio di errore:
[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"
Risoluzione:
Per risolvere il problema, specifica il formato dell'immagine come vdi, vhdx o qcow2 e
imposta il valore --timeout su 24h quando esegui il
comando gcloud compute images export.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-04 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."]]
