Azure Stack Hub에서 템플릿 유효성 검사 도구 사용

  • 아티클

템플릿 유효성 검사 도구를 사용하여 Azure Resource Manager 템플릿을 확인합니다. 도구는 템플릿이 Azure Stack Hub에 배포할 준비가 되었는지 확인합니다. Azure Stack Hub 도구 GitHub 리포지토리에서 유효성 검사 도구를 가져올 수 있습니다.

참고

이 도구는 Azure Stack에서 지원되는 리소스 종류 및 API 버전에 대한 Azure Resource Manager 템플릿의 유효성을 검사합니다. 그러나 도구는 각 리소스 종류에 대해 지원되는 속성의 유효성을 검사하지 않습니다.

개요

템플릿의 유효성을 검사하려면 먼저 클라우드 기능 파일을 빌드한 다음 유효성 검사 도구를 실행해야 합니다. Azure Stack Hub 도구에서 다음 PowerShell 모듈을 사용합니다.

  • CloudCapabilities 폴더: Az.CloudCapabilities.psm1은 Azure Stack Hub 클라우드의 서비스 및 버전을 나타내는 클라우드 기능 JSON 파일을 만듭니다.
  • TemplateValidator 폴더: Az.TemplateValidator.psm1은 클라우드 기능 JSON 파일을 사용하여 Azure Stack Hub에서 배포할 템플릿을 테스트합니다.

클라우드 기능 파일 빌드

템플릿 유효성 검사기를 사용하기 전에 Az.CloudCapabilities PowerShell 모듈을 실행하여 JSON 파일을 빌드합니다.

참고

통합 시스템을 업데이트하거나 새 서비스 또는 가상 확장을 추가하는 경우 이 모듈을 다시 실행해야 합니다.

  1. Azure Stack Hub에 연결되어 있는지 확인합니다. 이러한 단계는 ASDK(Azure Stack Development Kit) 호스트에서 수행하거나 VPN 을 사용하여 워크스테이션에서 연결할 수 있습니다.

  2. Az.CloudCapabilities PowerShell 모듈을 가져옵니다.

    Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1

  3. Get-CloudCapabilities cmdlet을 사용하여 서비스 버전을 검색하고 클라우드 기능 JSON 파일을 만듭니다. 를 지정 -OutputPath하지 않으면 AzureCloudCapabilities.json 파일이 현재 디렉터리에 만들어집니다. 실제 Azure 위치 사용:

Get-AzCloudCapability -Location <your location> -Verbose

템플릿 유효성 검사

Az.TemplateValidator PowerShell 모듈을 사용하여 템플릿의 유효성을 검사하려면 다음 단계를 사용합니다. 사용자 고유의 템플릿을 사용하거나 Azure Stack Hub 빠른 시작 템플릿을 사용할 수 있습니다.

  1. Az.TemplateValidator.psm1 PowerShell 모듈을 가져옵니다.

    cd "c:\AzureStack-Tools-az\TemplateValidator"
Import-Module .\Az.TemplateValidator.psm1

  2. 템플릿 유효성 검사기를 실행합니다.

Test-AzTemplate -TemplatePath <path to template.json or template folder> `
-CapabilitiesPath <path to cloudcapabilities.json> `
-Verbose

유효성 검사기는 PowerShell 콘솔에 템플릿 유효성 검사 경고 또는 오류를 표시하고 원본 디렉터리의 HTML 파일에 씁니다. 다음 스크린샷은 유효성 검사 보고서의 예입니다.

템플릿 유효성 검사 보고서

매개 변수

템플릿 유효성 검사기 cmdlet은 다음 매개 변수를 지원합니다.

매개 변수 Description 필수
TemplatePath Azure Resource Manager 템플릿을 재귀적으로 찾을 경로를 지정합니다. 예
TemplatePattern 일치시킬 템플릿 파일의 이름을 지정합니다. 예
CapabilitiesPath 클라우드 기능 JSON 파일의 경로를 지정합니다. 예
IncludeComputeCapabilities VM 크기 및 VM 확장과 같은 IaaS 리소스의 평가를 포함합니다. 예
IncludeStorageCapabilities SKU 유형과 같은 스토리지 리소스의 평가를 포함합니다. 예
Report 생성된 HTML 보고서의 이름을 지정합니다. 예
Verbose 콘솔에 오류 및 경고를 기록합니다. 예

예제

이 예제에서는 로컬 스토리지에 다운로드된 모든 Azure Stack Hub 빠른 시작 템플릿의 유효성을 검사합니다. 또한 이 예제에서는 ASDK 기능에 대해 VM(가상 머신) 크기 및 확장의 유효성을 검사합니다.

test-AzTemplate -TemplatePath C:\AzureStack-Quickstart-Templates `
-CapabilitiesPath .\TemplateValidator\AzureStackCloudCapabilities_with_AddOns_20170627.json `
-TemplatePattern MyStandardTemplateName.json `
-IncludeComputeCapabilities `
-Report TemplateReport.html

다음 단계