Öğretici: ARM şablonu başvurularını kullanma

Şablon şeması bilgilerini bulma ve bu bilgileri kullanarak şablon şablonlarını (ARM Azure Resource Manager) oluşturma hakkında bilgi edinebilirsiniz.

Bu öğreticide, Azure Hızlı Başlangıç Şablonları'nın temel şablonunu kullanacağız. Şablon başvurusu belgelerini kullanarak şablonu özelleştirebilirsiniz.

Resource Manager şablonu başvurusu depolama hesabı 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 gerekenler:

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

  4. Dosyayı yerel > bilgisayarınıza farklı bir dosyaazuredeploy.js Dosya Farklı Kaydet'i seçin.

Şemayı anlama

  1. Bu Visual Studio Code, şablonu kök düzeyine daraltabilirsiniz. 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: Şablonda önemli değişiklikleri belgeley etmek için bu öğe için herhangi bir değer 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.
    • 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. 'i resources genişletin. Tanımlanmış bir Microsoft.Storage/storageAccounts kaynak var. SKU adı bir parametre değeri kullanır. parametresi olarak storageAccountType çağrılır.

    Resource Manager şablonu depolama hesabı tanımı

  3. Nasıl parameters tanımlandığı görmek storageAccountType için genişletin. parametresine dört izin verilen değer vardır. İzin verilen diğer değerleri bulur ve ardından parametre tanımını düzeltirsiniz.

    Resource Manager şablonu depolama hesabı kaynakları sku'ları

Şablon başvurusunu bulma

  1. Azure Şablonu başvurusuna gidin.

  2. Baş alana göre filtrele kutusuna depolama hesapları yazın ve Başvuru alanı depolama alanına ilk Depolama Hesaplarını > seçin.

    Resource Manager şablon başvurusu depolama hesabı

    Kaynak sağlayıcısının genellikle birkaç API sürümü vardır:

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

  3. Sol bölmeden Depolama'nın altında Tüm kaynaklar'ı seçin. Bu sayfada depolama kaynak sağlayıcısının kaynak türleri ve sürümleri listeledik. Şablonunda tanımlanan kaynak türleri için en son API sürümlerinin kullanılması önerilir.

    Resource Manager şablonu başvurusu depolama hesabı türleri sürümleri

  4. Kaynak türünün en son storageAccount sürümünü seçin. Bu makale yazıldığı zaman en son sürüm 2019-06-01'tir. Bu sürümün, şablonunda depolama hesabı kaynağı için kullanılan sürümle eş olduğundan emin olun. API sürümünü güncelleştirin, kaynak tanımının şablon başvurusuyla eş olduğunu doğrulayın.

  5. Bu sayfada storageAccount kaynak türünün ayrıntıları listeledik. Örneğin, Sku nesnesi için izin verilen değerleri listeler. Daha önce açtığımız hızlı başlangıç şablonunda listelenenden daha fazla SKUS vardır. Hızlı başlangıç şablonunu tüm kullanılabilir depolama türlerini içerecek şekilde özelleştirebilirsiniz.

    Resource Manager başvuru depolama hesabı SKU'ları

Şablonu düzenleme

Aşağıdaki Visual Studio Code aşağıdaki ekran görüntüsünde gösterildiği gibi ek depolama hesabı türlerini ekleyin:

Resource Manager şablonu depolama hesabı kaynakları

Şablonu dağıtma

  1. Oturum açma Azure Cloud Shell

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

    Azure portal Cloud Shell karşıya yükleme

  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 komutunu ve komutunu ls kullanarak cat dosyanın başarıyla karşıya yük olduğunu doğruabilirsiniz.

  4. Komut 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 yeni storageAccountType eklenen bir değerle belirtin; örneğin, Standard_RAGRS. Özgün hızlı başlangıç şablonunu kullandıysanız dağıtım başarısız olur çünkü Standard_RAGRS izin verilen bir değer değildi.

    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. Sol Azure portal Kaynak grubu'nda öğesini seçin.
  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. Üst 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: