잘못된 템플릿에 대한 오류 해결

이 문서에서는 Bicep 파일 및 ARM 템플릿(Azure Resource Manager 템플릿)에 대한 잘못된 템플릿 오류를 해결하는 방법을 설명합니다. 오류는 구문 오류, 잘못된 매개 변수 값 또는 순환 종속성과 같은 여러 가지 이유로 발생합니다.

증상

템플릿이 배포되면 다음을 나타내는 오류가 표시됩니다.

Code=InvalidTemplate
Message=<varies>

오류 메시지는 오류 유형에 따라 다릅니다.

원인

이 오류는 여러 가지 유형의 오류로 인해 발생할 수 있습니다. 일반적으로 템플릿의 구문 또는 구조적 오류와 관련이 있습니다.

해결 방법 1: 구문 오류

템플릿이 유효성 검사에 실패했음을 나타내는 오류 메시지가 표시되면 템플릿에 구문 문제가 있을 수 있습니다.

Code=InvalidTemplate
Message=Deployment template validation failed

구문 오류는 템플릿 표현식에 많은 요소가 있기 때문에 발생할 수 있습니다. 예를 들어 스토리지 계정에 대한 이름 할당에는 작은따옴표 또는 큰따옴표 쌍, 중괄호, 대괄호 및 괄호가 포함됩니다. 표현식에는 달러 기호, 쉼표 및 점과 같은 함수와 문자도 포함됩니다.

name: 'storage${uniqueString(resourceGroup().id)}'

"name": "[concat('storage', uniqueString(resourceGroup().id))]",

이러한 유형의 오류가 발생하면 표현식의 구문을 검토하십시오. 템플릿 오류를 식별하기 위해 최신 Bicep 확장 또는 Azure Resource Manager 도구 확장과 함께 Visual Studio Code를 사용할 수 있습니다.

해결 방법 2: 잘못된 세그먼트 길이

또 다른 잘못된 템플릿 오류는 리소스 이름이 올바른 형식이 아닐 때 발생합니다. 이 오류를 해결하려면 이름 및 형식 불일치에 대한 오류 해결을 참조하세요.

해결 방법 3: 매개 변수가 유효하지 않습니다.

템플릿에서 매개변수의 허용되는 값을 지정할 수 있습니다. 배포하는 동안 허용되지 않는 값을 제공하면 다음 오류와 유사한 메시지가 표시됩니다.

Code=InvalidTemplate;
Message=Deployment template validation failed: 'The provided value {parameter value}
for the template parameter {parameter name} is not valid. The parameter value is not
part of the allowed values

템플릿에서 매개 변수의 허용되는 값을 확인하고 배포하는 동안 허용되는 값을 사용합니다. 자세한 내용은 Bicep 또는 ARM 템플릿에 허용되는 값을 참조하세요.

해결 방법 4: 대상 리소스 그룹이 너무 많음

이전 배포에서는 단일 배포에서 5개의 대상 리소스 그룹으로 제한되었기 때문에 이 오류가 표시될 수 있습니다. 2020년 5월에는 이 제한이 800개의 리소스 그룹으로 증가했습니다. 자세한 내용은 Bicep 또는 ARM 템플릿에 대한 여러 리소스 그룹에 배포하는 방법을 참조하세요.

해결 방법 5: 순환 종속성이 감지됨

리소스가 배포를 시작하지 못하게 하는 방식으로 서로 의존하는 경우 이 오류가 발생합니다. 상호 종속성의 조합은 두 개 이상의 리소스가 대기 중인 다른 리소스를 기다리게 합니다. 예를 들어, resource1 에 따라 resource3, resource2 에 종속 resource1및 resource3 에 따라 resource2달라집니다. 일반적으로 불필요한 종속성을 제거하여 이 문제를 해결할 수 있습니다.

Bicep은 한 리소스가 다른 리소스의 기호 이름을 사용할 때 암시적 종속성을 만듭니다. 일반적으로 명시적 종속성 using dependsOn 은 필요하지 않습니다. 자세한 내용은 Bicep 종속성을 참조하세요.

순환 종속성을 해결하려면:

1. 템플릿에서 순환 종속성에서 식별된 리소스를 찾습니다.
2. 해당 리소스의 dependsOn 경우 속성과 or reference 함수의 사용을 resourceId 검사하여 어떤 리소스가 종속되는지 확인합니다.
3. 이러한 리소스를 검사하여 어떤 리소스에 의존하는지 확인합니다. 원래 리소스에 의존하는 리소스를 발견할 때까지 종속성을 따릅니다.
4. 순환 종속성과 관련된 리소스의 경우 속성의 모든 사용을 dependsOn 주의 깊게 검사하여 필요하지 않은 종속성을 식별합니다. 배포 문제를 해결하려면 순환 종속성을 제거합니다. 코드를 삭제하는 대신 주석을 사용하여 다음 배포 중에 코드가 실행되지 않도록 할 수 있습니다. // 또는 /* ... */ 파일에서 한 줄 주석() 또는 여러 줄 주석()을 사용할 수 있습니다.
5. 템플릿을 다시 배포합니다.

속성에서 dependsOn 값을 제거하면 템플릿을 배포할 때 오류가 발생할 수 있습니다. 오류가 발생하면 종속성을 템플릿에 다시 추가합니다. 템플릿을 무시하기 위해 주석을 사용한 경우 주석을 제거하여 코드를 복원할 수 있습니다.

이 방법으로 순환 종속성이 해결되지 않으면 배포 논리의 일부를 자식 리소스(예: 확장 또는 구성 설정)로 이동하는 것이 좋습니다. 해당 자식 리소스를 circular dependency와 관련된 리소스 뒤에 배포하도록 구성합니다. 예를 들어 두 개의 가상 머신을 배포하지만 각 컴퓨터에 서로를 참조하는 속성을 설정해야 한다고 가정합니다. 이런 경우 다음과 같은 순서로 배포할 수 있습니다.

1. VM1
2. VM2
3. vm1의 확장은 vm1 및 vm2에 종속됩니다. 이 확장은 vm2에서 얻은 값을 vm1에 설정합니다.
4. vm2의 확장은 vm1 및 vm2에 종속됩니다. 이 확장은 vm1에서 얻은 값을 vm2에 설정합니다.

App Service 앱에도 동일한 방법이 적용됩니다. 구성 값을 app 리소스의 자식 리소스로 이동하는 것이 좋습니다. 다음 순서로 두 개의 웹앱을 배포할 수 있습니다.

1. 웹앱1
2. 웹앱2
3. webapp1에 대한 구성은 webapp1 및 webapp2에 따라 달라집니다. 여기에는 webapp2의 값이 있는 앱 설정이 포함되어 있습니다.
4. webapp2에 대한 구성은 webapp1 및 webapp2에 따라 다릅니다. 여기에는 webapp1의 값이 있는 앱 설정이 포함되어 있습니다.

해결 방법 6: 내보낸 템플릿에 대한 구문 유효성 검사

Azure에서 리소스를 배포한 후 ARM 템플릿 JSON을 내보내고 다른 배포를 위해 수정할 수 있습니다. 내보낸 템플릿을 사용하여 리소스를 배포하기 전에 구문이 올바른지 확인해야 합니다.

포털, Azure CLI 또는 Azure PowerShell에서 템플릿을 내보낼 수 있습니다. 템플릿을 리소스 또는 리소스 그룹에서 내보냈는지 또는 배포 기록에서 내보냈는지 여부에 대한 권장 사항이 있습니다.