ARM 템플릿(Azure Resource Manager 템플릿) 또는 Bicep 파일을 사용한 Azure 리소스 배포에 실패하면 오류 코드가 표시됩니다. 이 문서에서는 문제를 해결할 수 있도록 오류 코드를 찾는 방법에 대해 설명합니다. 오류 코드에 대한 자세한 내용은 일반적인 배포 오류를 참조하세요.
오류 형식
배포와 관련된 세 가지 유형의 오류가 있습니다.
검증 오류는 배포가 시작되기 전에 발생하며 파일의 구문 오류로 인해 발생합니다. Visual Studio Code와 같은 코드 편집기는 이러한 오류를 식별할 수 있습니다.
배포 명령이 실행되지만 리소스가 배포되지 않은 경우 실행 전 유효성 검사 오류가 발생합니다. 이러한 오류는 배포를 시작하지 않고 발견됩니다. 예를 들어 매개 변수 값이 잘못된 경우 실행 전 유효성 검사에서 오류가 발견됩니다.
배포 오류는 배포 프로세스 중에 발생하며 Azure 환경에서 배포 진행 상황을 평가해야만 찾을 수 있습니다.
모든 오류 유형에서 배포 문제를 해결하는 데 사용하는 오류 코드를 반환합니다. 유효성 검사 및 실행 전 오류는 활동 로그에 표시되지만 배포 기록에는 표시되지 않습니다. 구문 오류가 있는 Bicep 파일은 JSON으로 컴파일되지 않으며 활동 로그에 표시되지 않습니다.
출력에 템플릿 문제를 해결하고 수정하는 데 사용할 수 있는 InvalidTemplateDeployment 또는 AccountNameInvalid와 같은 오류 코드가 표시됩니다.
Bicep 파일의 경우 구문 유효성 검사 문제에 대한 출력에 매개 변수 오류가 표시됩니다.
Test-AzResourceGroupDeployment: Cannot retrieve the dynamic parameters for the cmdlet.
Cannot find path '/tmp/11111111-1111-1111-1111-111111111111/main.json' because it does not exist.
문제 해결 정보를 더 얻으려면 Bicep build 명령을 사용합니다. 출력에는 괄호 안에 각 오류의 줄과 열 번호가 있는 오류 메시지가 표시됩니다.
bicep build main.bicep
/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
unexpected new line character.
기타 범위
구독, 관리 그룹 및 테넌트 범위에 대한 배포 템플릿의 유효성을 검사하는 Azure PowerShell cmdlet이 있습니다.
az deployment group validate \
--resource-group examplegroup \
--template-file azuredeploy.json
출력에 템플릿 문제를 해결하고 수정하는 데 사용할 수 있는 InvalidTemplateDeployment 또는 AccountNameInvalid와 같은 오류 코드가 표시됩니다.
Bicep 파일의 경우 출력에는 괄호 안에 각 오류의 줄과 열 번호가 있는 오류 메시지가 표시됩니다.
az deployment group validate \
--resource-group examplegroup \
--template-file main.bicep
/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
unexpected new line character.
기타 범위
구독, 관리 그룹 및 테넌트 범위에 대한 배포 템플릿의 유효성을 검사하는 Azure CLI 명령이 있습니다.