Aracılığıyla paylaş

Hızlı Başlangıç: Şablon oluşturma ve dağıtma belirtimi

Bu hızlı başlangıçta bir Azure Resource Manager şablonunu (ARM şablonu) şablon belirtimine nasıl paketlediğiniz gösterilmektedir. Ardından bu şablon belirtimlerini dağıtırsınız. Şablon belirtiminiz, depolama hesabı dağıtan bir ARM şablonu içerir.

Tip

ARM şablonlarıyla aynı özellikleri sunduğundan ve söz diziminin kullanımı daha kolay olduğundan Bicep önerilir. Daha fazla bilgi edinmek için bkz . Hızlı Başlangıç: Bicep ile şablon belirtimi oluşturma ve dağıtma.

Prerequisites

Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.

Note

Şablon belirtimlerini Azure PowerShell ile kullanmak için 5.0.0 veya sonraki bir sürümü yüklemeniz gerekir. Azure CLI ile kullanmak için 2.14.2 veya sonraki bir sürümü kullanın.

Şablon oluşturma

ARM şablonundan bir şablon belirtimi oluşturursunuz. Aşağıdaki şablonu kopyalayın ve C:\Templates\createStorageV1.js olarak kaydedin.

{
  "$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-06-01",
      "name": "[parameters('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "accessTier": "Hot"
      }
    }
  ]
}

Şablon belirtimi oluşturma

Şablon belirtimi adlı Microsoft.Resources/templateSpecsbir kaynak türüdür. Şablon belirtimi oluşturmak için PowerShell, Azure CLI, Azure portalı veya ARM şablonu kullanın.

  1. Şablon belirtimini içerecek yeni bir kaynak grubu oluşturun.

    New-AzResourceGroup `
  -Name templateSpecRG `
  -Location westus2

  2. Bu kaynak grubunda şablon belirtimini oluşturun. Yeni şablona storageSpec adını verin.

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

Şablon belirtimlerini dağıtma

Şablon belirtimini dağıtmak için, şablon dağıtmak için kullandığınız dağıtım komutlarının aynısını kullanın. Dağıtılacak şablon belirtiminin kaynak kimliğini geçirin.

  1. Yeni depolama hesabını içerecek bir kaynak grubu oluşturun.

    New-AzResourceGroup `
  -Name storageRG `
  -Location westus2

  2. Şablon belirtiminin kaynak kimliğini alın.

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

  3. Şablon belirtimini dağıtın.

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

  4. Arm şablonu için yaptığınız parametreleri tam olarak sağlayın. Şablon belirtimini depolama hesabı türü için bir parametreyle yeniden dağıtın.

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

Erişim izni ver

Kuruluşunuzdaki diğer kullanıcıların şablon belirtiminizi dağıtmasına izin vermek için onlara okuma erişimi verin. Okuyucu rolünü, paylaşmak istediğiniz şablon belirtimlerini içeren kaynak grubu için bir Microsoft Entra grubuna atayın. Daha fazla bilgi için bkz . Öğretici: Azure PowerShell kullanarak Azure kaynaklarına grup erişimi verme.

Şablonu güncelleştirme

Şablon belirtiminizde şablonda değişiklik yapmak için şablonu düzeltin. Aşağıdaki şablon, depolama hesabı adı için bir ön ek eklemesi dışında önceki şablonunuzla benzerdir. Aşağıdaki şablonu kopyalayın ve createStorageV2.json dosyası olarak kaydedin.

{
  "$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-06-01",
      "name": "[parameters('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "accessTier": "Hot"
      }
    }
  ]
}

Şablon belirtim sürümünü güncelleştirme

Düzeltilen şablon için yeni bir şablon belirtimi oluşturmak yerine mevcut şablon belirtimine adlı 2.0 yeni bir sürüm ekleyin. Her iki sürümü de dağıtabilirsiniz.

  1. Şablon belirtimi için yeni bir sürüm oluşturun.

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

  2. Yeni sürümü dağıtmak için 2.0 sürümün kaynak kimliğini alın.

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

  3. Bu sürümü dağıtın. Depolama hesabı adı için bir ön ek sağlayın.

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

Kaynakları temizleme

Bu hızlı başlangıçta dağıttığınız kaynağı temizlemek için oluşturduğunuz her iki kaynak grubunu da silin.

  1. Azure portalında sol menüden Kaynak grubu’nu seçin.
  2. Ada göre filtrele alanına kaynak grubu adını (templateSpecRG ve storageRG) girin.
  3. Kaynak grubu adını seçin.
  4. Üstteki menüden Kaynak grubunu sil’i seçin.

Sonraki Adımlar

Bağlantılı şablonlar içeren bir şablon belirtimi oluşturma hakkında bilgi edinmek için bkz. Bağlantılı şablonun şablon belirtimini oluşturma.

  • Last updated on