Google Cloud CLI를 사용하여 이미지를 가져오거나 내보내는 경우 프로세스를 실행한 후 표준 출력에서 Cloud Build 로그 위치를 볼 수 있습니다.
직렬 포트 출력 검토
이미지 가져오기 또는 내보내기 프로세스 중에 생성되는 작업자 VM의 직렬 포트 출력을 검토하면 시스템 수준 항목의 문제를 해결하는 데 유용할 수 있습니다. 이러한 로그에 대한 자세한 내용은 직렬 포트 출력 보기를 참조하세요.
일반적인 실수
다음은 이미지를 가져오거나 내보낼 때 발생할 수 있는 일반적인 오류의 예시입니다.
2TB보다 큰 이미지를 내보낼 때 ExportFailed 오류 발생
vmdk, vpc, vhd 형식의 최대 이미지 크기는 2TB로 제한됩니다. 따라서 2TB보다 큰 이미지를 이러한 형식으로 내보내면 로그에 다음과 유사한 오류 메시지가 표시될 수 있습니다.
오류 메시지:
[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"
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-04-21(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."]]
