Azure Resource Manager 템플릿 구조 및 스키마 살펴보기

  • 6분

Azure Resource Manager 템플릿에는 구성을 쉽게 사용자 지정하도록 돕는 매개 변수 및 변수와 함께 하나 이상의 Azure 리소스에 대한 JSON 형식 정의가 포함되어 있습니다.

가장 간단한 구조의 템플릿에 포함되는 요소는 다음과 같습니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "",
  "apiProfile": "",
  "parameters": {  },
  "variables": {  },
  "functions": [  ],
  "resources": [  ],
  "outputs": {  }
}
요소 이름 Required 설명
$schema 예 템플릿 언어의 버전을 설명하는 JSON(JavaScript Object Notation) 스키마 파일의 위치입니다. 사용할 버전 번호는 배포 범위 및 JSON 편집기에 따라 다릅니다.

Azure Resource Manager 도구 확장과 함께 Visual Studio Code를 사용하는 경우, 최신 버전의 리소스 그룹 배포를 사용합니다.
https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#

다른 편집기(Visual Studio 포함)가 이 스키마를 처리하지 못할 수 있습니다. 이러한 편집기의 경우 다음을 사용합니다.
https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#

구독 배포의 경우 다음을 사용합니다.
https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#

관리 그룹 배포의 경우 다음을 사용합니다.
https://schema.management.azure.com/schemas/2019-08-01/managementGroupDeploymentTemplate.json#

테넌트 배포의 경우 다음을 사용합니다.
https://schema.management.azure.com/schemas/2019-08-01/tenantDeploymentTemplate.json#
contentVersion 예 템플릿의 버전입니다(예: 1.0.0.0). 이 요소에 값을 제공할 수 있습니다. 이 값을 사용하여 템플릿에서 중요한 변경 내용을 문서화할 수 있습니다. 템플릿을 사용하여 리소스를 배포할 때 이 값을 사용하면 정확한 템플릿이 사용되도록 할 수 있습니다.
apiProfile 예 리소스 종류에 대한 API 버전 컬렉션으로 사용되는 API 버전입니다. 이 값을 사용하면 템플릿에 있는 각 리소스의 API 버전을 지정하지 않아도 됩니다. API 프로필 버전을 지정하고 리소스 종류에 대한 API 버전을 지정하지 않으면 Resource Manager는 프로필에 정의된 해당 리소스 종류에 대해 API 버전을 사용합니다.

API 프로필 속성은 Azure Stack, 전역 Azure 등 다양한 환경에 템플릿을 배포할 때 특히 유용합니다. API 프로필 버전을 사용하여 템플릿이 두 환경에서 모두 지원되는 버전을 자동으로 사용하는지 확인합니다. 프로필에 정의된 현재 API 프로필 버전 및 리소스 API 버전 목록은 API 프로필을 참조하세요.

자세한 내용은 API 프로필을 사용하여 버전 추적을 참조하세요.
parameters 예 배포를 실행하여 리소스 배포를 사용자 지정할 때 제공되는 값입니다.
variables 예 템플릿에서 템플릿 언어 식을 단순화하는 JSON 조각으로 사용되는 값입니다.
functions 예 템플릿 내에서 사용할 수 있는 사용자 정의 함수입니다.
resources 예 리소스 그룹 또는 구독에 배포되거나 업데이트되는 리소스 종류입니다.
outputs 예 배포 후 반환되는 값입니다.

선택적 데모