매개 변수 파일에 대한 테스트 사례

  • 아티클

이 문서에서는 매개 변수 파일에 대해 템플릿 테스트 도구 키트로 실행되는 테스트에 대해 설명합니다. 예를 들어 이름이 azuredeploy.parameters.json인 파일이 있습니다. 이 예제에는 테스트 이름과 테스트를 통과하거나 실패하는 코드 샘플이 포함됩니다. 테스트를 실행하는 방법 또는 특정 테스트를 실행하는 방법에 대한 자세한 내용은 테스트 매개 변수를 참조하세요.

이 도구 키트에는 ARM 템플릿(Azure Resource Manager 템플릿)에 대한 테스트 사례와 azuredeploy.json 또는 maintemplate.json이라는 기본 템플릿 파일이 포함되어 있습니다.

유효한 contentVersion 사용

테스트 이름: DeploymentParameters에 ContentVersion이 있어야 합니다.

contentVersion에는 1.0.0.0 형식의 문자열이 포함되어 있어야 하며 숫자만 사용해야 합니다.

다음 예제는 contentVersion이 없기 때문에 실패합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

다음 예제는 contentVersion이 문자열이 아니기 때문에 실패합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": {},
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

다음 예제는 통과합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

파일은 매개 변수를 포함해야 합니다.

테스트 이름: DeploymentParameters에 Parameters가 있어야 합니다.

매개 변수 파일은 parameters 섹션을 포함해야 합니다.

다음 예제는 실패합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
}

다음 예제는 통과합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

유효한 스키마 버전 사용

테스트 이름: DeploymentParameters에 Schema가 있어야 합니다.

매개 변수 파일은 유효한 스키마 버전을 포함해야 합니다.

매개 변수 파일에는 다음과 같은 두 가지 유효한 스키마 버전이 있습니다.

  • https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#
  • https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#

다음 예제는 실패합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2021-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

다음 예제는 통과합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

매개 변수는 값을 포함해야 합니다.

테스트 이름: DeploymentParameters에 Value가 있어야 합니다.

매개 변수는 value 또는 reference를 포함해야 합니다. 암호와 같은 비밀의 경우 키 자격 증명 모음은 매개 변수 파일에서 reference를 사용합니다. 자세한 내용은 Azure Key Vault를 사용하여 배포 중에 보안 매개 변수 값 전달을 참조하세요.

다음 예제는 stgAcctName에 value가 없기 때문에 실패합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {}
  }
}

다음 예제는 통과합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

다음 단계