Aracılığıyla paylaş

Öğretici: Azure Resource Manager şablonunuza değişken ekleme

Bu öğreticide, Azure Resource Manager şablonunuza (ARM şablonu) değişken eklemeyi öğreneceksiniz. Değişkenler şablonlarınızı basitleştirir. Bir ifadeyi bir kez yazmanıza ve şablonun tamamında yeniden kullanmanıza olanak verir. Eğitimin tamamlanması 7 dakika sürer.

Önkoşullar

İşlevler hakkındaki öğreticiyi tamamlamanızı öneririz, ancak gerekli değildir.

Visual Studio Code'a ve Azure PowerShell'e veya Azure CLI'ya sahip olmanız gerekir. Daha fazla bilgi için bkz. şablon araçları.

Şablonu gözden geçirme

Önceki öğreticinin sonunda şablonunuz aşağıdaki JSON dosyasına sahipti:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 24
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[parameters('storageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

ARM şablonunuzu oluşturmaya kolayca devam etmek için Azure depolama hesabınızın adının benzersiz olması gerekir. Bu serinin önceki öğreticilerini tamamladıysanız, eşsiz bir isim bulmaktan sıkılmış olabilirsiniz. Depolama hesabınız için benzersiz bir ad oluşturan bir değişken ekleyerek bu sorunu çözebilirsiniz.

Değişken kullanma

Aşağıdaki örnekte, şablonunuza benzersiz bir depolama hesabı adı oluşturan bir değişken ekleme değişiklikleri gösterilmektedir. Dosyanın tamamını kopyalayın ve şablonunuzu içeriğiyle değiştirin:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

adlı uniqueStorageNamebir değişken içerdiğine dikkat edin. Bu değişken, dize değeri oluşturmak için dört işlev kullanır.

Parameters işlevini zaten biliyorsunuz, bu nedenle incelemeyeceğiz.

ResourceGroup işlevini de biliyorsunuz. Bu durumda, önceki öğreticide gösterildiği gibi id özelliği yerine location özelliğini alırsınız. id özelliği, abonelik kimliği ve kaynak grubu adı dahil olmak üzere kaynak grubunun tam tanımlayıcısını döndürür.

uniqueString işlevi 13 karakterlik bir karma değer oluşturur. Geçirdiğiniz parametreler döndürülen değeri belirler. Bu öğreticide, özet değerinin girişi olarak kaynak grubu kimliğini kullanırsınız. Bu, bu şablonu farklı kaynak gruplarına dağıtabileceğiniz ve farklı bir benzersiz dize değeri alabileceğiniz anlamına gelir. Ancak aynı kaynak grubuna dağıttığınızda aynı değeri alırsınız.

concat işlevi değerleri alır ve bunları birleştirir. Bu değişken için, parametreden aldığı dizeyi ve uniqueString fonksiyonundan aldığı dizeyi alır ve bunları tek bir dizede birleştirir.

parametresi, storagePrefix depolama hesaplarını tanımlamanıza yardımcı olan bir ön ek geçirmenize olanak tanır. Geniş bir kaynak listesinden dağıtımdan sonra depolama hesaplarını tanımlamayı kolaylaştıran kendi adlandırma kuralınızı oluşturabilirsiniz.

Son olarak, depolama hesabı adının artık parametre yerine değişken olarak ayarlandığına dikkat edin.

Şablonu dağıt

Şimdi şablonu dağıtalım. Yalnızca depolama hesabı adı için ön ek sağladığınız için bu şablonu dağıtmak önceki şablonlardan daha kolaydır.

Kaynak grubunu oluşturmadıysanız bkz. Kaynak grubu oluşturma. Örnekte, templateFile gösterildiği gibi şablon dosyasının yoluna ayarladığınız varsayılır.

New-AzResourceGroupDeployment `
  -Name addnamevariable `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

Uyarı

Dağıtım başarısız olursa, oluşturulmakta olan kaynaklar hakkında bilgi almak için verbose anahtarını kullanın. debug Hata ayıklama hakkında daha fazla bilgi edinmek için anahtarını kullanın.

Dağıtımı doğrulayın

Azure portalından kaynak grubunu keşfederek dağıtımı doğrulayabilirsiniz.

  1. Azure portalınaoturum açın.
  2. Soldaki menüden Kaynak grupları'nı seçin.
  3. Kaynak grubunuzu seçin.
  4. Dağıtılan depolama hesabı adınızın depo ve rastgele karakter dizesi olduğuna dikkat edin.

Kaynakları temizle

Sonraki öğreticiye geçiyorsanız kaynak grubunu silmeniz gerekmez.

Şimdi durduruyorsanız kaynak grubunu silmek isteyebilirsiniz.

  1. Azure portalından soldaki menüden Kaynak grupları'nı seçin.
  2. Herhangi bir alan için filtre uygula... metin alanına kaynak grubu adını yazın.
  3. myResourceGroup'un yanındaki kutuyu işaretleyin ve myResourceGroup veya kaynak grubunuzun adını seçin.
  4. Üstteki menüden Kaynak grubunu sil'i seçin.

Sonraki Adımlar

Bu öğreticide, benzersiz bir depolama hesabı adı oluşturan bir değişken ekleyeceksiniz. Sonraki öğreticide, dağıtılan depolama hesabından bir değer döndürebilirsiniz.

Çıkış ekleme

  • Last updated on