Soluciona problemas de importación y exportación de imágenes
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Linux
Windows
En este documento, se describen los problemas comunes que puedes encontrar cuando importas imágenes a Compute Engine y cuando exportas imágenes a Cloud Storage.
Diagnostica problemas de importación y exportación de imágenes
Para diagnosticar la causa de los problemas de importación o exportación de imágenes, revisa los registros de Cloud Build y la salida del puerto en serie de las VMs temporales (o las VMs de trabajador).
Revisa los registros de Cloud Build
La herramienta de importación de imágenes usa la API de Cloud Build para importar y exportar imágenes.
Revisa los registros de Cloud Build para obtener el estado del proceso en ejecución.
Para ver los registros de Cloud Build, realiza una de las siguientes acciones:
Si importas o exportas imágenes con la consola de Google Cloud , consulta los registros en la página Imágenes en la consola de Google Cloud , en el Historial de importación de imágenes o en la pestaña Historial de exportación de imágenes.
Haz clic en el ID de Cloud Build para ver los registros.
Si importas o exportas imágenes mediante Google Cloud CLI, puedes ver la ubicación del registro de Cloud Build en el resultado estándar después de ejecutar el proceso.
Revisa la salida del puerto en serie
Revisar la salida del puerto en serie de las VMs de trabajador que se crean durante el proceso de importación o exportación de imágenes puede ser útil para solucionar problemas de entidades a nivel del sistema. Para obtener más información sobre estos registros, consulta Visualiza la salida del puerto en serie.
Errores comunes
Los siguientes son ejemplos de errores comunes que pueden surgir cuando importas o exportas imágenes.
Error ExportFailed cuando se exportan imágenes de más de 2 TB
El tamaño máximo de las imágenes en formato vmdk, vpc y vhd se limita a 2 TB. Por lo tanto, cuando exportas imágenes de más de 2 TB en estos formatos, es posible que veas un mensaje de error similar al siguiente en el registro:
Mensaje de error:
[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"
Solución:
Para resolver este problema, especifica el formato de imagen como vdi, vhdx o qcow2, y establece el valor de --timeout como 24h cuando ejecutes el comando gcloud compute images export.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
