Aracılığıyla paylaş

Öğretici: Azure Resource Manager şablonunuza kaynak ekleme

Önceki öğreticide, ilk boş Azure Resource Manager şablonunuzu (ARM şablonu) oluşturmayı ve dağıtmayı öğrendinsiniz. 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.

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ı.

Kaynak ekle

Mevcut şablona azure depolama hesabı tanımı eklemek için aşağıdaki örnekteki 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.

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

Ö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": "2025-06-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ı ve kaynak türü Microsoft.Storage/storageAccounts gibi unsurları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 kaynak, kaynağı dağıttığınız bölgeyi ayarlayan bir location özelliğe de sahiptir.

Diğer özellikler kaynak türüne ve API sürümüne göre farklılık gösterir. API sürümü ile 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ülerseniz 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.

Şablonu dağıt

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, templateFile gösterildiği gibi şablon dosyasının yoluna ayarladığınız varsayılır.

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

Uyarı

Dağıtım başarısız olursa, oluşturduğunuz 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.

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ğildir. Depolama hesabı adının 3 ila 24 karakter uzunluğunda olması ve yalnızca sayıları ve küçük harfleri kullanması gerekir.

    Şablonda {provide-unique-name} yerine benzersiz bir depolama hesabı adı yerleştirin. 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ğ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. 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 olduğuna dikkat edin: Dağıtımlar: 2 Başarılı.

Kaynakları temizle

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ından 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ı 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.

Parametre ekleme

  • Last updated on