리소스 오류는 Deployment Manager로 관리하는 리소스의 기본 API에서 전파됩니다. 예를 들어 배포에 Compute Engine VM 인스턴스가 있고 인스턴스를 만드는 중에 오류가 발생하면 오류는 Deployment Manager의 리소스 오류로 표시됩니다.
Deployment Manager 응답의 message.ResourceErrorCode 및 message.ResourceErrorMessage 필드에서 기본 API의 오류가 표시됩니다.
유효성 검사 오류(코드: CONDITION_NOT_MET)
부울이 예상될 때 문자열 값을 사용하는 경우와 같이 구성의 필드에서 유효성 검사를 실패하면 유효성 검사 오류가 발생합니다.
종속성 루프(코드: CYCLIC_REFERENCES)
구성에 종속성 루프가 있음을 나타냅니다. 예를 들어 리소스 A가 리소스 B에 의존하고 B가 C에 의존하고 C가 A에 의존하는 경우입니다.
오류 메시지는 종속성 루프에 있는 리소스를 보여줍니다.
다음 시나리오에서 리소스의 종속 항목을 볼 수 있습니다.
다른 리소스의 속성에 대한 참조입니다. 예를 들어 배포에 동일한 배포의 인스턴스 템플릿을 사용하는 인스턴스 그룹 관리자가 있으면 인스턴스 그룹 관리자는 인스턴스 템플릿에 암시적으로 종속됩니다. Deployment Manager는 먼저 인스턴스 템플릿을 만든 후 인스턴스 그룹 관리자를 만듭니다.
현재 리소스를 나타내는 명시적 dependsOn 리소스는 의존하는 리소스 뒤에 생성되어야 합니다.
오류를 해결하려면 루프가 끊어지도록 참조 또는 dependsOn 속성을 변경합니다.
템플릿 확장 중에 발생한 오류
템플릿은 Deployment Manager가 템플릿을 단일 구성으로 확장하는 데 사용하는 시간과 리소스로 제한됩니다.
다음 오류 중 하나가 표시될 수 있습니다.
MANIFEST_EXPANSION_TOO_MUCH_CPU: 구성을 확장하는 데 CPU가 너무 많이 사용되었습니다.
MANIFEST_EXPANSION_TOO_MUCH_MEMORY: 구성을 확장하는 데 메모리가 너무 많이 사용되었습니다.
MANIFEST_EXPANSION_TOO_MUCH_WALL_TIME: 구성을 확장하는 데 시간이 너무 오래 걸렸습니다.
MANIFEST_EXPANSION_USER_ERROR: 구성 또는 템플릿 중 하나에 오류가 발생했습니다.
MANIFEST_EXPANSION_TOO_MUCH_CPU 및 MANIFEST_EXPANSION_TOO_MUCH_MEMORY는 템플릿에 재귀적으로 복잡한 구조가 있거나 루프가 너무 많이 있을 수 있음을 나타낼 수 있습니다.
이러한 오류를 해결하려면 템플릿을 더 작은 템플릿으로 분할하거나 템플릿을 단순화하는 것이 좋습니다.
[[["이해하기 쉬움","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-09-03(UTC)"],[[["\u003cp\u003eDeployment errors in Deployment Manager are typically formatted with an error code, location, and message, providing details about what went wrong.\u003c/p\u003e\n"],["\u003cp\u003eResource errors (\u003ccode\u003eRESOURCE_ERROR\u003c/code\u003e) originate from underlying APIs, reflecting issues during the creation or management of resources like Compute Engine VM instances.\u003c/p\u003e\n"],["\u003cp\u003eValidation errors (\u003ccode\u003eCONDITION_NOT_MET\u003c/code\u003e) occur when a field in the configuration fails validation, such as using the wrong data type.\u003c/p\u003e\n"],["\u003cp\u003eDependency loop errors (\u003ccode\u003eCYCLIC_REFERENCES\u003c/code\u003e) indicate a circular dependency between resources, requiring adjustments to references or \u003ccode\u003edependsOn\u003c/code\u003e properties to resolve.\u003c/p\u003e\n"],["\u003cp\u003eTemplate expansion errors, like \u003ccode\u003eMANIFEST_EXPANSION_TOO_MUCH_CPU\u003c/code\u003e, signal that the process of expanding templates exceeded allowed limits, often suggesting the need to simplify or split complex templates.\u003c/p\u003e\n"]]],[],null,["# Tips and troubleshooting\n\nThe following sections might help you if you run into problems while using\nDeployment Manager.\n\nCommon errors during deployments\n--------------------------------\n\nThe errors that you see in your deployments are in the following format: \n\n - code: ERROR_CODE\n location: /path/to/template\n message: \"{\"Error message\"}\"\n\nThe types of errors you might commonly see are described in the following\nsections.\n\n### Resource errors (code: `RESOURCE_ERROR`)\n\nResource errors are propagated from the underlying APIs for the resources\nthat you are managing with Deployment Manager. For example, if your\ndeployment has a Compute Engine VM instance, and there was an error\ncreating the instance, you see that error as a resource error in\nDeployment Manager.\n\nIn the Deployment Manager response, you can see the error from the\nunderlying API in the `message.ResourceErrorCode` and\n`message.ResourceErrorMessage` fields.\n\n### Validation errors (code: `CONDITION_NOT_MET`)\n\nYou get a validation error when a field in your configuration fails validation,\nsuch as if it uses a string value when a boolean is expected.\n\n### Dependency loops (code: `CYCLIC_REFERENCES`)\n\nIndicates that your configuration has a dependency loop. For example, if\nresource A depends on resource B, B depends on C, and C depends on A.\n\nThe error message shows the resources that are in the dependency loop.\n\nYou might see dependencies in resources in the following scenarios:\n\n- A reference to a property of another resource. For example, if your\n deployment has an instance group manager that uses an instance template from\n the same deployment, the instance group manager implicitly depends on\n the instance template. Deployment Manager creates the instance template\n first, then creates the instance group manager.\n\n- An explicit `dependsOn` property, which indicates that the current resource\n must be created after the resource it depends on.\n\nTo resolve the error, change the references or `dependsOn` properties so that\nthe loop is broken.\n\n### Errors while expanding your templates\n\nYour templates are limited in the amount of time and\nresources that Deployment Manager uses to expand the templates into a\nsingle configuration.\n\nYou might see one of the following errors:\n\n- `MANIFEST_EXPANSION_TOO_MUCH_CPU`: Expanding the configuration took too much CPU.\n- `MANIFEST_EXPANSION_TOO_MUCH_MEMORY`: Expanding the configuration took too much memory.\n- `MANIFEST_EXPANSION_TOO_MUCH_WALL_TIME`: Expanding the configuration took too much time.\n- `MANIFEST_EXPANSION_USER_ERROR`: There was an error in your configuration or one of your templates.\n\n`MANIFEST_EXPANSION_TOO_MUCH_CPU` and `MANIFEST_EXPANSION_TOO_MUCH_MEMORY` might\nindicate that your templates might have complex structures involving recursion,\nor too many loops.\n\nTo resolve these errors, consider splitting your templates into smaller\ntemplates, or simplifying your templates."]]
