Solução de problemas na importação e exportação de imagens
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Linux
Windows
Neste documento, descrevemos os problemas comuns que você pode encontrar ao importar
imagens para o Compute Engine e ao exportar imagens para
o Cloud Storage.
Diagnosticar problemas de importação e exportação de imagem
Diagnostique a causa da importação de imagens ou problemas de exportação analisando os
registros do Cloud Build e a saída da porta serial das VMs temporárias
(ou VMs de worker).
Analisar os registros do Cloud Build
A ferramenta de importação de imagens usa a API Cloud Build para importar e exportar imagens.
Revise os registros do Cloud Build para ver o status do processo em execução.
Para ver os registros do Cloud Build, siga um destes procedimentos:
Se você importar ou exportar imagens usando o console Google Cloud , consulte os registros na página
Imagens no console Google Cloud , na guia Histórico de importação de imagens ou Histórico de exportação de imagens.
Clique no ID do Cloud Build para ver os registros.
Se você importar ou exportar imagens usando a Google Cloud CLI, será possível visualizar o
local do registro do Cloud Build na saída padrão depois de executar o processo.
Analisar a saída da porta serial
Analisar a saída da porta serial das VMs de worker criadas durante o processo de importação ou exportação de imagem pode ser útil para resolver problemas com entidades no nível do sistema. Para mais informações sobre esses registros, consulte Como visualizar a saída da porta serial.
Erros comuns
Veja a seguir exemplos de erros comuns que você pode encontrar ao importar
ou exportar imagens.
Erro "ExportFailed" ao exportar imagens maiores que 2 TB
O tamanho máximo das imagens nos formatos vmdk, vpc e vhd é limitado a
2 TB. Portanto, quando você exportar imagens maiores que 2 TB nesses formatos, poderá ver uma mensagem de erro semelhante a esta no registro:
Mensagem de erro:
[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"
Resolução:
Para resolver esse problema, especifique o formato da imagem como vdi, vhdx ou qcow2 e
defina o valor --timeout como 24h ao executar o
comando gcloud compute images export.
Se o problema persistir, entre em contato com o Google Cloud suporte para
receber ajuda.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]