다음을 통해 공유

빠른 시작: 템플릿 사양 만들기 및 배포

이 빠른 시작에서는 템플릿 사양에 ARM 템플릿(Azure Resource Manager 템플릿)을 패키지하는 방법을 보여 줍니다. 그런 다음, 해당 템플릿 사양을 배포합니다. 템플릿 사양에는 스토리지 계정을 배포하는 ARM 템플릿이 포함되어 있습니다.

Tip

Bicep 은 ARM 템플릿과 동일한 기능을 제공하며 구문을 더 쉽게 사용할 수 있으므로 권장됩니다. 자세한 내용은 빠른 시작: Bicep으로 템플릿 사양 만들기 및 배포를 참조하세요.

Prerequisites

활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.

Note

Azure PowerShell에서 템플릿 사양을 사용하려면 버전 5.0.0 이상을 설치해야 합니다. Azure CLI와 함께 사용하려면 버전 2.14.2 이상을 사용합니다.

템플릿 만들기

ARM 템플릿에서 템플릿 사양을 만듭니다. 다음 템플릿을 복사하고 C:\Templates\createStorageV1.js저장합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageAccountName": {
      "type": "string",
      "defaultValue": "[uniqueString(resourceGroup().id)]"
    },
    "___location": {
      "type": "string",
      "defaultValue": "[resourceGroup().___location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-01-01",
      "name": "[parameters('storageAccountName')]",
      "___location": "[parameters('___location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "accessTier": "Hot"
      }
    }
  ]
}

템플릿 사양 만들기

템플릿 사양은 Microsoft.Resources/templateSpecs라는 리소스 종류입니다. 템플릿 사양을 만들려면 PowerShell, Azure CLI, Azure Portal 또는 ARM 템플릿을 사용합니다.

  1. 템플릿 사양을 포함할 새 리소스 그룹을 만듭니다.

    New-AzResourceGroup `
  -Name templateSpecRG `
  -Location westus2

  2. 해당 리소스 그룹에서 템플릿 사양을 만듭니다. 새 템플릿 사양에 storageSpec라는 이름을 지정합니다.

    New-AzTemplateSpec `
  -Name storageSpec `
  -Version "1.0" `
  -ResourceGroupName templateSpecRG `
  -Location westus2 `
  -TemplateFile "C:\Templates\createStorageV1.json"

템플릿 사양 배포

템플릿 사양을 배포하려면 템플릿을 배포하는 데 사용하는 것과 동일한 배포 명령을 사용합니다. 배포할 템플릿 사양의 리소스 ID를 전달합니다.

  1. 새 스토리지 계정을 포함하는 리소스 그룹을 만듭니다.

    New-AzResourceGroup `
  -Name storageRG `
  -Location westus2

  2. 템플릿 사양의 리소스 ID를 가져옵니다.

    $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "1.0").Versions.Id

  3. 템플릿 사양을 배포합니다.

    New-AzResourceGroupDeployment `
  -TemplateSpecId $id `
  -ResourceGroupName storageRG

  4. ARM 템플릿과 정확히 동일한 매개 변수를 제공합니다. 스토리지 계정 유형에 대한 매개 변수를 사용하여 템플릿 사양을 다시 배포합니다.

    New-AzResourceGroupDeployment `
  -TemplateSpecId $id `
  -ResourceGroupName storageRG `
  -storageAccountType Standard_GRS

액세스 권한 부여

조직의 다른 사용자가 템플릿 사양을 배포할 수 있도록 하려면 읽기 권한을 부여합니다. 공유하려는 템플릿 사양이 포함된 리소스 그룹의 Microsoft Entra 그룹에 읽기 권한자 역할을 할당합니다. 자세한 내용은 자습서: Azure PowerShell을 사용하여 Azure 리소스에 대한 그룹 액세스 권한 부여를 참조하세요.

템플릿 업데이트

템플릿 사양에서 템플릿을 변경하려면 템플릿을 수정합니다. 다음 템플릿은 스토리지 계정 이름에 접두사를 추가하는 것을 제외하고 이전 템플릿과 비슷합니다. 다음 템플릿을 복사하여 createStorageV2.json 파일로 저장합니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageAccountName": {
      "type": "string",
      "defaultValue": "[format('store{0}', uniqueString(resourceGroup().id))]"
    },
    "___location": {
      "type": "string",
      "defaultValue": "[resourceGroup().___location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-01-01",
      "name": "[parameters('storageAccountName')]",
      "___location": "[parameters('___location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "accessTier": "Hot"
      }
    }
  ]
}

템플릿 사양 버전 업데이트

수정된 템플릿에 대한 새 템플릿 사양을 만드는 대신 기존 템플릿 사양에 명명된 2.0 새 버전을 추가합니다. 두 버전 중 하나를 배포할 수 있습니다.

  1. 템플릿 사양에 대한 새 버전을 만듭니다.

    New-AzTemplateSpec `
  -Name storageSpec `
  -Version "2.0" `
  -ResourceGroupName templateSpecRG `
  -Location westus2 `
  -TemplateFile "C:\Templates\createStorageV2.json"

  2. 새 버전을 배포하려면 2.0 버전에 대한 리소스 ID를 가져옵니다.

    $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "2.0").Versions.Id

  3. 해당 모델을 배포합니다. 스토리지 계정 이름의 접두사를 제공합니다.

    New-AzResourceGroupDeployment `
  -TemplateSpecId $id `
  -ResourceGroupName storageRG `
  -namePrefix "demoaccount"

리소스 정리

이 빠른 시작에서 배포한 리소스를 정리하려면 만든 리소스 그룹을 모두 삭제합니다.

  1. Azure Portal의 왼쪽 메뉴에서 리소스 그룹을 선택합니다.
  2. 이름으로 필터링 필드에 리소스 그룹 이름(templateSpecRG 및 storageRG)을 입력합니다.
  3. 해당 리소스 그룹 이름을 선택합니다.
  4. 위쪽 메뉴에서 리소스 그룹 삭제를 선택합니다.

다음 단계

연결된 템플릿을 포함하는 템플릿 사양을 만드는 방법에 대한 자세한 내용은 연결된 템플릿의 템플릿 사양을 만드는 방법을 참조하세요.