다음을 통해 공유

배포 문제 해결이란?

  • 아티클

Bicep 파일 또는 ARM 템플릿(Azure Resource Manager 템플릿)을 사용하여 Azure 리소스를 배포하면 오류가 발생할 수 있습니다. 배포 전에 구문 오류를 해결할 수 있도록 하는 문제 해결 도구가 있습니다. Azure Portal, Azure PowerShell 및 Azure CLI에서 오류 코드 및 배포 오류에 대한 자세한 정보를 가져올 수 있습니다. 이 설명서는 오류 문제 해결을 위한 솔루션을 찾는 데 도움이 됩니다.

오류 형식

유효성 검사 오류는 배포가 시작되기 전에 발생하며 Visual Studio Code와 같은 코드 편집기에서 식별할 수 있는 잘못된 구문으로 인해 발생합니다. 예를 들어 철자가 잘못된 속성 이름이나 인수가 누락된 함수가 있습니다.

배포 명령이 실행되지만 Azure에서 리소스가 배포되지 않은 경우 실행 전 유효성 검사 오류가 발생합니다. 예를 들어 잘못된 매개 변수 값을 사용하면 배포 명령이 오류 메시지를 반환합니다.

배포 오류는 배포를 시도하고 Azure 환경과 상호 작용해야만 확인할 수 있습니다. 예를 들어 VM(가상 머신)에는 NIC(네트워크 인터페이스 카드)가 필요합니다. VM을 배포할 때 NIC가 없으면 배포 오류가 발생합니다.

문제 해결 도구

오류를 해결하는 데 사용할 수 있는 몇 가지 문제 해결 도구가 있습니다.

구문 오류

배포 전에 구문 오류를 식별하려면 최신 버전의 Visual Studio Code를 사용합니다. Bicep 또는 ARM 템플릿용 확장의 최신 버전을 설치합니다.

배포 템플릿 개발을 위한 모범 사례를 따르려면 다음 도구를 사용합니다.

리소스 공급자 및 API 버전

배포 문제를 해결하려면 리소스 공급자의 속성 또는 API 버전에 대해 알아보는 것이 좋습니다. 자세한 내용은 Bicep 및 ARM 템플릿을 사용하여 리소스 정의를 참조하세요.

오류 정보

배포할 때 리소스 그룹의 배포 또는 활동 로그에서 Azure Portal 오류의 원인을 찾을 수 있습니다. Azure PowerShell을 사용하는 경우 Get-AzResourceGroupDeploymentOperation 및 Get-AzActivityLog와 같은 명령을 사용합니다. Azure CLI의 경우 az deployment operation group 및 az monitor activity-log list와 같은 명령을 사용합니다.

다음 단계