Öğretici: ARM şablonunuza kaynak ekleme

  • Makale

Önceki öğreticide, ilk boş Azure Resource Manager şablonunuzu (ARM şablonu) oluşturmayı ve dağıtmayı öğrendin. Artık bu şablona gerçek bir kaynak dağıtmaya hazırsınız. Bu durumda, bir Azure depolama hesabı. Bu yönergenin tamamlanması 9 dakika sürer.

Önkoşullar

Şablonlar hakkında giriş niteliğindeki öğreticiyi tamamlamanızı öneririz, ancak gerekli değildir.

Azure Resource Manager Araçları uzantısı ve Azure PowerShell veya Azure Command-Line Arabirimi (CLI) ile Visual Studio Code yüklemeniz ve bu uzantıyla çalışmanız gerekir. Daha fazla bilgi için bkz. şablon araçları.

Kaynak ekle

Mevcut şablona azure depolama hesabı tanımı eklemek için aşağıdaki örnekte vurgulanan JSON dosyasına bakın. Şablonun bölümlerini kopyalamaya çalışmak yerine dosyanın tamamını kopyalayın ve şablonunuzu içeriğiyle değiştirin.

ve küme ayraçlarını {} benzersiz bir depolama hesabı adıyla değiştirin{provide-unique-name}.

Önemli

Depolama hesabı adının Azure genelinde benzersiz olması gerekir. Yalnızca küçük harfler veya sayılardır ve 24 karakter sınırı vardır. Ön ek olarak store1 gibi bir ad kullanabilir ve ardından adınızın baş harflerini ve bugünün tarihini ekleyebilirsiniz. Örneğin ad store1abc06132022 olabilir.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Depolama hesabı için benzersiz bir ad tahmin etmek kolay değildir ve büyük dağıtımları otomatikleştirmek için iyi çalışmaz. Bu öğretici serisinin ilerleyen bölümlerinde benzersiz bir ad oluşturmayı kolaylaştıran şablon özelliklerini kullanacaksınız.

Kaynak özellikleri

Her kaynak türü için kullanılacak özellikleri nasıl bulabileceğinizi merak ediyor olabilirsiniz. Dağıtmak istediğiniz kaynak türlerini bulmak için ARM şablonu başvuruyu kullanabilirsiniz.

Dağıttığınız her kaynağın en az aşağıdaki üç özelliği vardır:

  • type: Kaynağın türü. Bu değer, kaynak sağlayıcısının ad alanı ile gibi Microsoft.Storage/storageAccountskaynak türünün birleşimidir.
  • apiVersion: Kaynağı oluşturmak için kullanılacak REST API sürümü. Her kaynak sağlayıcısı kendi API sürümlerini yayımlar, bu nedenle bu değer türüne özgüdür.
  • name: Kaynağın adı.

Çoğu kaynağın, kaynağı dağıttığınız bölgeyi ayarlayan bir location özelliği de vardır.

Diğer özellikler kaynak türüne ve API sürümüne göre farklılık gösterir. API sürümüyle kullanılabilir özellikler arasındaki bağlantıyı anlamak önemlidir, bu nedenle daha ayrıntılı bilgi verelim.

Bu öğreticide, şablona bir depolama hesabı eklersiniz. Depolama hesabının API sürümünü storageAccounts 2021-09-01'de görebilirsiniz. Şablonunuza tüm özellikleri eklemediğinize dikkat edin. Özelliklerin çoğu isteğe bağlıdır. Kaynak Microsoft.Storage sağlayıcısı yeni bir API sürümü yayınlayabilir, ancak dağıttığınız sürümün değiştirilmesi gerekmez. Bu sürümü kullanmaya devam edebilir ve dağıtımınızın sonuçlarının tutarlı olduğunu bilirsiniz.

Eski bir API sürümünü görüntülediğinizde daha küçük bir özellik kümesinin kullanılabilir olduğunu görebilirsiniz.

Bir kaynağın API sürümünü değiştirmeye karar verirseniz, bu sürümün özelliklerini değerlendirdiğinizden ve şablonunuzu uygun şekilde ayarladığınızdan emin olun.

Şablon dağıtma

Depolama hesabını oluşturmak için şablonu dağıtabilirsiniz. Geçmişte kolayca bulabilmeniz için dağıtımınıza farklı bir ad verin.

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

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Not

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

Bu hatalar, karşılaşabileceğiniz iki olası dağıtım hatasıdır:

  • Error: Code=AccountNameInvalid; Message={provide-unique-name} geçerli bir depolama hesabı adı değil. Depolama hesabı adının 3 ila 24 karakter uzunluğunda olması ve yalnızca sayıları ve küçük harfleri kullanması gerekir.

    Şablonda değerini benzersiz bir depolama hesabı adıyla değiştirin {provide-unique-name} . Bkz. Kaynak ekleme.

  • Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 zaten alınmıştır.

    Şablonda farklı bir depolama hesabı adı deneyin.

Depolama hesabı oluşturduğunuz için bu dağıtım boş şablon dağıtımınızdan daha uzun sürer. Bir dakika kadar sürebilir.

Dağıtımı doğrulama

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

  1. Azure Portal’ında oturum açın.
  2. Soldaki menüden Kaynak grupları'nı seçin.
  3. myResourceGroup öğesinin sol kısmındaki kutuyu işaretleyin ve myResourceGroup öğesini seçin
  4. Dağıtılan kaynak grubunu seçin.
  5. Bir depolama hesabının dağıtıldığını görürsünüz.
  6. Dağıtım etiketinde şu ifadenin yer olduğuna dikkat edin: Dağıtımlar: 2 Başarılı.

Kaynakları temizleme

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

Şimdi durduruyorsanız, kaynak grubunu silerek dağıtmış olduğunuz kaynakları temizlemek isteyebilirsiniz.

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

Sonraki adımlar

Azure depolama hesabını dağıtmak için basit bir şablon oluşturdunuz. Sonraki öğreticilerde şablona parametre, değişken, kaynak ve çıkış eklemeyi öğreneceksiniz. Bu özellikler, çok daha karmaşık şablonlar için yapı taşlarıdır.

Parametreler ekleme