Aracılığıyla paylaş


Öğretici: ARM şablonu başvurusunu kullanma

Şablon şeması bilgilerini bulmayı ve bilgileri kullanarak Azure Resource Manager şablonları (ARM şablonları) oluşturmayı öğrenin.

Bu öğreticide, Azure Hızlı Başlangıç Şablonları'ndan bir temel şablon kullanacaksınız. Şablon başvuru belgelerini kullanarak şablonu doğrularsınız.

Resource Manager şablon başvurusu depolama hesabını dağıtma

Bu öğretici aşağıdaki görevleri kapsar:

  • Hızlı başlangıç şablonunu açma
  • Şablon biçimini anlama
  • Şablon başvurusunu bulma
  • Şablonu düzenleme
  • Şablonu dağıtma

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

Bu makaleyi tamamlamak için Visual Studio Code gerekir.

Hızlı başlangıç şablonunu açma

Azure Hızlı Başlangıç Şablonları , ARM şablonları için bir depodur. Sıfırdan bir şablon oluşturmak yerine örnek bir şablon bulabilir ve bunu özelleştirebilirsiniz. Bu hızlı başlangıçta kullanılan şablon Standart depolama hesabı oluşturma olarak adlandırılır. Şablon, Azure Depolama hesabı kaynağını tanımlar.

  1. Visual Studio Code’dan Dosya>Dosya Aç’ı seçin.

  2. Dosya adı’na şu URL’yi yapıştırın:

    https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
    
  3. Dosyayı açmak için ’ı seçin.

  4. Dosyayı yerel bilgisayarınıza azuredeploy.json olarak kaydetmek için >Farklı Kaydet’i seçin.

Şemayı anlama

  1. Visual Studio Code'da şablonu kök düzeyine daraltın. Aşağıdaki öğelere sahip çok basit bir yapı görürsünüz:

    Resource Manager şablonu basit yapısı

    • $schema: Şablon dilinin sürümünü açıklayan JSON şema dosyasının konumunu belirtin.
    • contentVersion: şablonunuzdaki önemli değişiklikleri belgeleyemek için bu öğenin herhangi bir değerini belirtin.
    • metadata: şablonun meta verilerini belirtin.
    • parameters: kaynak dağıtımını özelleştirmek için dağıtım yürütülürken sağlanan değerleri belirtin.
    • variables: şablon dili ifadelerini basitleştirmek için şablonda JSON parçaları olarak kullanılan değerleri belirtin. Bu şablon bu öğeyi içermiyor.
    • resources: bir kaynak grubunda dağıtılan veya güncelleştirilen kaynak türlerini belirtin.
    • outputs: dağıtımdan sonra döndürülen değerleri belirtin.
  2. öğesini genişletin resources. Tanımlanmış bir Microsoft.Storage/storageAccounts kaynak var. Önceki ekran görüntüsündeki API sürümü 2022-09-01 şeklindedir. SKU adı bir parametre değeri kullanır. parametresi olarak adlandırılır storageAccountType.

    Resource Manager şablonu depolama hesabı tanımı

  3. Nasıl parameters tanımlandığını görmek için genişletinstorageAccountType. parametresinin izin verilen sekiz değeri vardır. Resource Manager şablonu depolama hesabı kaynakları sku'ları

Şablon başvurusunu kullanarak en son API sürümünü kullanıp kullanmadığınızı ve parametre tanımının izin verilen tüm değerleri içerip içermediğini öğrenebilirsiniz.

Şablon başvurusunu bulma

  1. Azure Şablonu başvurusuna göz atın.

  2. Sol menüden Depolama'yı bulun, Depolama'yı genişletin ve ardından Depolama Hesapları'nı seçin

  3. ARM şablonu'nu seçin.

  4. Bir kaynak türü genellikle birkaç API sürümüne sahiptir. Bu sayfa varsayılan olarak en son şablon şeması sürümünü gösterir. Sürümleri görmek için En Son açılan kutusunu seçin. En son sürüm 2025-06-01'dir. En son sürümü görmek için En Son'un altındaki En Son veya sürümü seçin. Bu sürümün, şablonunuzdaki depolama hesabı kaynağı için kullanılan sürümle eşleştiğinden emin olun. API sürümünü güncelleştirirseniz kaynak tanımının şablon başvurusuyla eşleşip eşleşmediğini doğrulayın.

    Resource Manager şablonu başvuru depolama hesabı sürümleri

  5. Bu sayfada storageAccount kaynak türünün ayrıntıları listelenir. Örneğin, Sku nesnesi için izin verilen değerleri listeler. API sürüm 2025-06-01 için 14 SKU vardır.

    Resource Manager şablonu başvuru depolama hesabı sku'ları

Şablonu dağıtma

  1. Azure Cloud Shell'de oturum açın.

  2. Sol üst köşedeki PowerShell veya Bash (CLI için) seçeneğini belirleyerek tercih ettiğiniz ortamı seçin. Geçiş yaparken kabuğu yeniden başlatmanız gerekir.

    Azure portalı Cloud Shell karşıya yükleme dosyası

  3. Dosyaları karşıya yükle/indir'i seçin ve sonra da Karşıya Yükle'yi seçin. Önceki ekran görüntüsüne bakın. Önceki bölümde kaydettiğiniz dosyayı seçin. Dosyayı karşıya yükledikten sonra, dosyanın başarıyla karşıya yüklendiğini doğrulamak için komutunu ve ls komutunu kullanıncat.

  4. Cloud Shell'den aşağıdaki komutları çalıştırın. PowerShell kodunu veya CLI kodunu gösteren sekmeyi seçin.

    Şablonu dağıtırken parametresini storageAccountType yeni eklenen bir değerle (örneğin, Standard_RAGRS) belirtin. Standard_RAGRS izin verilen bir değer olmadığından özgün hızlı başlangıç şablonunu kullanırsanız dağıtım başarısız olur.

    echo "Enter a project name that is used to generate resource group name:" &&
    read projectName &&
    echo "Enter the location (i.e. centralus):" &&
    read location &&
    resourceGroupName="${projectName}rg" &&
    az group create --name $resourceGroupName --location "$location" &&
    az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'
    

Kaynakları temizleme

Artık Azure kaynakları gerekli değilse, kaynak grubunu silerek dağıttığınız kaynakları temizleyin.

  1. Azure portalda, sol menüden Kaynak grubu’nu seçin.
  2. Ada göre filtrele alanına kaynak grubu adını girin.
  3. Kaynak grubu adını seçin. Kaynak grubunda toplam altı kaynak görürsünüz.
  4. Üstteki menüden Kaynak grubunu sil’i seçin.

Sonraki adımlar

Bu öğreticide şablon başvurusunu kullanarak var olan bir şablonu özelleştirmeyi öğrendiniz. Birden çok depolama hesabı örneği oluşturmayı öğrenmek için, bkz: