Öğ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.

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 gerekenler:

• Visual Studio Code ve Resource Manager Araçları uzantısı. Bkz. Hızlı Başlangıç: Visual Studio Code ile ARM şablonları oluşturma.

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 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 Aç’ı seçin.

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

Şemayı anlama

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

   

   • $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ü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. Ekran görüntüsünde gösterilen API sürümü 2022-09-01'dir. SKU adı bir parametre değeri kullanır. parametresi olarak adlandırılır storageAccountType.

   

3. Nasıl storageAccountType tanımlandığını görmek için genişletinparameters. Parametresinin sekiz izin verilen değeri vardır.

Şablon başvurusunu kullanarak en son API sürümünü kullanıp kullanmadığını 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. Başlığa göre filtrele kutusuna depolama hesapları girin ve Başvuru > Depolama'nın altındaki ilk Depolama Hesapları'nı seçin.

   

3. ARM şablonu'mu seçin.

4. Bir kaynak türü genellikle birkaç API sürümüne sahiptir. Bu sayfada varsayılan olarak en son şablon şeması sürümü gösterilir. Sürümleri görmek için En Son açılan kutusunu seçin. Ekran görüntüsünde gösterilen en son sürüm 2022-09-01'dir. En son sürümü görmek için En Son veya en son'un hemen altındaki 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.

   

5. Bu sayfada storageAccount kaynak türünün ayrıntıları listelenir. Örneğin, Sku nesnesi için izin verilen değerleri listeler. Sekiz SKU vardır ve bunlar daha önce açtığınız hızlı başlangıç şablonunda listelenenlerle eşleşiyor.

   

Şablonu dağıtma

1. Azure Cloud Shell oturum açma

2. Sol üst köşedeki PowerShell veya Bash 'i (CLI için) seçerek tercih ettiğiniz ortamı seçin. Geçiş yaptığınızda kabuğun yeniden başlatılması gerekir.

   

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 cat komutunu kullanabilirsinizls.

4. Cloud Shell 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.

   CLI

   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'
   

   PowerShell

   $projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name"
   $location = Read-Host -Prompt "Enter the location (i.e. centralus)"
   $resourceGroupName = "${projectName}rg"
   
   New-AzResourceGroup -Name $resourceGroupName -Location "$location"
   New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile "$HOME/azuredeploy.json" -storageAccountType "Standard_RAGRS"
   

Kaynakları temizleme

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

1. Azure portal soldaki menüden Kaynak grubu'na tıklayın.
2. Ada göre filtrele alanına kaynak grubu adını girin.
3. Kaynak grubu adını seçin. Kaynak grubundaki toplam altı kaynak görüyor olmalısı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:

Birden çok örnek oluşturma