Azure Blueprints를 사용하여 오류 문제 해결

Important

2026년 7월 11일에 청사진(미리 보기)이 사용 중단됩니다. 기존 청사진 정의와 할당을 템플릿 사양배포 스택으로 마이그레이션하세요. 청사진 아티팩트는 배포 스택을 정의하는 데 사용되는 ARM JSON 템플릿 또는 Bicep 파일로 변환됩니다. 아티팩트를 ARM 리소스로 작성하는 방법을 알아보려면 다음을 참조하세요.

청사진을 만들거나 할당할 때 오류가 발생할 수 있습니다. 이 문서에서는 발생할 수 있는 다양한 오류와 이러한 오류를 해결하는 방법에 대해 설명합니다.

오류 세부 정보 찾기

대부분의 오류는 청사진을 범위에 할당한 결과입니다. 할당이 실패하면 청사진에서 실패한 배포에 대한 세부 정보를 제공합니다. 이 정보는 해결된 후에는 다음 배포가 성공할 수 있는 문제를 나타냅니다.

  1. 왼쪽 창에서 모든 서비스를 선택합니다. 청사진을 검색하고 선택합니다.

  2. 페이지의 왼쪽에서 할당된 청사진을 선택하고, 검색 상자를 통해 청사진 할당을 필터링하여 실패한 할당을 찾습니다. 실패한 모든 할당을 그룹화하여 표시하도록 프로비전 상태 열을 기준으로 할당 테이블을 정렬할 수도 있습니다.

  3. 실패 상태인 청사진을 선택하거나, 마우스 오른쪽 단추를 클릭하여 할당 세부 정보 보기를 선택합니다.

  4. 청사진 할당 페이지의 위쪽에는 실패한 할당임을 알려주는 경고의 빨간색 배너가 있습니다. 배너의 아무 곳이나 클릭하여 세부 정보를 볼 수 있습니다.

일반적으로 청사진 전체가 아니라 아티팩트로 인해 오류가 발생합니다. 아티팩트가 Key Vault를 만들고 Azure Policy가 Key Vault 생성을 방해하면 전체 할당이 실패합니다.

일반 오류

시나리오: 정책 위반

문제

정책 위반으로 인해 템플릿을 배포하지 못했습니다.

원인

정책은 다음과 같은 여러 가지 이유로 배포와 충돌할 수 있습니다.

  • 만드는 리소스는 정책(일반적으로 SKU 또는 위치 제한)으로 제한되어 있습니다.
  • 배포에서 정책(태그와 함께 사용)으로 구성된 필드를 설정하고 있습니다.

해결

청사진이 오류 세부 정보의 정책과 충돌하지 않도록 변경합니다. 이렇게 변경할 수 없으면 대체 옵션으로 정책 할당의 범위를 변경하여 청사진이 더 이상 정책과 충돌하지 않도록 합니다.

시나리오: 청사진 매개 변수가 함수임

문제

함수인 청사진 매개 변수는 아티팩트로 전달되기 전에 처리됩니다.

원인

[resourceGroup().tags.myTag] 등의 함수를 사용하는 청사진 매개 변수를 아티팩트로 전달하면 동적 함수가 아닌 아티팩트에 대해 함수의 처리된 결과가 설정됩니다.

해결

함수를 매개 변수로 전달하려면 청사진 매개 변수가 [[resourceGroup().tags.myTag]와 같이 표시되도록 [를 사용하여 전체 문자열을 이스케이프 처리합니다. 이스케이프 문자를 추가하면 청사진을 처리할 때 Blueprints에서 값을 문자열로 처리합니다. 그 후에 청사진 서비스는 함수를 아티팩트에 배치하여 함수가 예상대로 동적으로 설정됩니다. 자세한 내용은 Azure Resource Manager 템플릿의 구문 및 식을 참조하세요.

삭제 오류

시나리오: 할당 삭제 시간 제한

문제

청사진 할당 삭제가 완료되지 않았습니다.

원인

청사진 할당은 삭제 시 비 터미널 상태에서 중단될 수 있습니다. 이 상태는 청사진 할당을 통해 생성된 리소스가 여전히 삭제 보류 중이거나 Azure Blueprints로 상태 코드를 반환하지 않는 경우에 발생합니다.

해결

비 터미널 상태의 청사진 할당은 6시간 시간 제한 이후 자동으로 실패로 표시됩니다. 시간 제한이 청사진 할당의 상태를 조정한 후에는 삭제를 다시 시도할 수 있습니다.

다음 단계

문제가 표시되지 않거나 문제를 해결할 수 없는 경우 다음 채널 중 하나를 방문하여 추가 지원을 받으세요.

  • Azure 포럼을 통해 Azure 전문가로부터 답변을 얻습니다.
  • @AzureSupport와 연결 – Azure 커뮤니티를 적절한 리소스(답변, 지원, 전문가)에 연결하여 사용자 환경을 개선하기 위한 공식 Microsoft Azure 계정입니다.
  • 추가 지원이 필요한 경우, Azure 기술 지원 인시던트를 제출할 수 있습니다. Azure 지원 사이트 로 가서 지원 받기를 선택합니다.