Öğretici: İlk ARM şablonlarınızı oluşturma ve dağıtma

  • Makale
  • Okumak için 4 dakika

Bu öğreticide, Azure Resource Manager (ARM şablonları) hakkında bilgi edinebilirsiniz. Başlangıç şablonu oluşturma ve Azure'a dağıtmayı gösterir. Şablonun yapısı ve şablonlarla çalışmak için ihtiyacınız olan araçlar hakkında bilgi edinebilirsiniz. Bu öğreticinin tamamlanması yaklaşık 12 dakika sürer, ancak gerçek süre, yüklemeniz gereken araç türüne göre değişiklik gösterir.

Bu öğretici, bir serinin ilk öğreticisidir. Seride ilerledikçe, ARM şablonunun tüm temel parçalarını keşfedene kadar başlangıç şablonunu adım adım değiştirirsiniz. Bu öğeler çok daha karmaşık şablonların yapı taşlarıdır. Serinin sonunda kendi şablonlarınızı oluşturma konusunda emin olduğunu ve dağıtımlarınızı şablonlarla otomatikleştirmeye hazır olduğunu umuyoruz.

Şablonları kullanmanın avantajları ve şablonlarla dağıtımı neden otomatikleştirmeniz gerektiği hakkında bilgi edinmek için bkz. ARM şablonuna genel bakış. Arm şablonları hakkında bilgi edinmek için bkz. MICROSOFT LEARN şablonları kullanarak Azure'da kaynakları dağıtma ve yönetme.

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

Araçları al

Şablon oluşturmak ve dağıtmak için ihtiyacınız olan araçlara sahip olduğundan emin olarak başlayalım. Bu araçları yerel makinenize yükleyin.

Düzenleyici

Şablonlar JSON dosyalarıdır. Şablon oluşturmak için iyi bir JSON düzenleyicisine ihtiyacınız vardır. Resource Manager Tools uzantısıyla Visual Studio Code öneririz. Bu araçları yüklemeniz gerekirse bkz. Hızlı Başlangıç: Visual Studio Code ile ARM şablonları oluşturma.

Komut satırı dağıtımı

Şablonu dağıtmak için Azure PowerShell Azure CLI veya Azure CLI de gerekir. Azure CLI kullanıyorsanız en son sürüme sahip olmak gerekir. Yükleme yönergeleri için bkz:

Azure CLI'Azure PowerShell veya Azure CLI'yi yükledikten sonra ilk kez oturum asanıza emin olun. Yardım için bkz. Oturum açma - PowerShell veya Oturum Açma - Azure CLI.

Önemli

Azure CLI kullanıyorsanız 2.6 veya sonraki bir sürüme sahip olduğundan emin olun. Bu öğreticide gösterilen komutlar, önceki sürümleri kullanıyorsanız çalışmaz. Yüklü sürümü kontrol etmek için kullanın: az --version .

Şablonlar hakkında bilgi öğrenmeye başlamaya hazırsınız.

İlk şablonunuzu oluşturma

  1. Visual Studio Code Tools uzantısının yüklü olduğu Resource Manager'i açın.

  2. Dosya menüsünden Yeni Dosya'ya seçerek yeni bir dosya oluşturun.

  3. Dosya menüsünden Farklı kaydet'i seçin.

  4. Dosyayı azuredeploy olarak adlandırın ve json dosya uzantısını seçin. Dosyanın tam adı azuredeploy.json'dır.

  5. Dosyayı iş istasyonuna kaydedin. Şablonu dağıtırken daha sonra bu yolu sağlaycazı için anımsanacak kolay bir yol seçin.

  6. Aşağıdaki JSON'u kopyalayıp dosyaya yapıştırın:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": []
}

    Ortam ortamınız Visual Studio Code şekildedir:

    ARM şablonu Visual Studio Code şablonu

    Bu şablon herhangi bir kaynak dağıtmaz. Boş bir şablonla başlıyoruz, böylece bir şablonu dağıtma adımlarını daha iyi anlayarak bir sorun olma ihtimalini en aza indirebilirsiniz.

    JSON dosyası şu öğelere sahiptir:

    • $schema: JSON şema dosyasının konumunu belirtir. Şema dosyası, bir şablon içinde kullanılabilen özellikleri açıklar. Örneğin, şema bir resources şablon için geçerli özelliklerden biri olarak tanımlar. Şema için tarihin 2019-04-01 olduğunu endişelenmeyin. Bu şema sürümü günceldir ve en son özelliklerin hepsini içerir. Şema tarihi, tanıtımından bu yana yeni bir değişiklik olmadığını için değişmemiştir.
    • contentVersion: Şablonun sürümünü belirtir (örneğin, 1.0.0.0). Bu öğe için herhangi bir değer sebilirsiniz. Şablonda yapılan önemli değişiklikleri belgeley için bu değeri kullanın. Şablonu kullanarak kaynakları dağıtırken bu değer, doğru şablonun kullanılıyor olduğundan emin olmak için kullanılabilir.
    • resources: Dağıtmak veya güncelleştirmek istediğiniz kaynakları içerir. Şu anda boştur, ancak daha sonra kaynak ekleyebilirsiniz.

  7. Dosyayı kaydedin.

Tebrikler, ilk şablonlarınızı oluşturduğunuza göre.

Azure'da oturum açma

Azure PowerShell/Azure CLI ile çalışmaya başlamak için Azure kimlik bilgilerinizle oturum açma.

Uygulama ve Azure CLI arasında seçim yapmak için aşağıdaki kod Azure PowerShell sekmeleri seçin. Bu makaledeki CLI örnekleri Bash kabuğu için yazılmıştır.

Connect-AzAccount

Birden çok Azure aboneliğiniz varsa kullanmak istediğiniz aboneliği seçin. yerine SubscriptionName aboneliğinizin adını yazın. Abonelik adı yerine abonelik kimliğini de kullanabilirsiniz.

Set-AzContext SubscriptionName

Kaynak grubu oluşturma

Bir şablon dağıtırken, kaynakları içeren bir kaynak grubu belirtirsiniz. Dağıtım komutunu çalıştırmadan önce Azure CLI veya Azure PowerShell ile kaynak grubunu oluşturun.

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

Şablon dağıtma

Şablonu dağıtmak için Azure CLI veya Azure PowerShell. Oluşturduğunuz kaynak grubunu kullanın. Dağıtım geçmişinde kolayca tanımlayabiliyor olmak için dağıtıma bir ad girin. Kolaylık sağlamak için şablon dosyasının yolunu depolar bir değişken de oluşturun. Her dağıtım yaptığınızda yolu yeniden yazmanız gerekmediğinden bu değişken, dağıtım komutlarını çalıştırmanızı kolaylaştırır. {provide-the-path-to-the-template-file}ve küme ayraçlarını {} şablon dosyanıza giden yol ile değiştirin.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Dağıtım komutu sonuçları döndürür. Dağıtımın ProvisioningState başarılı olup olmadığını görmek için bakın.

Not

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

Dağıtımı doğrulama

Kaynak grubunu Azure portal inceleyerek dağıtımı doğrulayabilirsiniz.

  1. Azure Portal oturum açın.

  2. Sol menüden kaynak grupları' nı seçin.

  3. Son yordamda kaynak grubu dağıtımını seçin. Varsayılan ad Myresourcegroup' dir. Kaynak grubu içinde dağıtılan bir kaynak görmezsiniz.

  4. Genel bakışın sağ üst köşesinde, dağıtımın durumunun görüntülendiğini görebilirsiniz. 1 başarılı' i seçin.

    Dağıtım durumunu görüntüle

  5. Kaynak grubu için bir dağıtım geçmişi görürsünüz. Blanktemplate' i seçin.

    Dağıtım seçin

  6. Dağıtımın bir özetini görürsünüz. Bu durumda, hiçbir kaynak dağıtılmadığından görmeniz çok fazla olmaz. Bu serinin ilerleyen kısımlarında, dağıtım geçmişindeki Özeti gözden geçirmeyi yararlı bulabilirsiniz. Sol tarafta, girdileri, çıkışları ve dağıtım sırasında kullanılan şablonu görüntüleyebilirsiniz.

    Dağıtım özetini görüntüle

Kaynakları temizleme

Bir sonraki öğreticiye geçiş yapıyorsanız, kaynak grubunu silmeniz gerekmez.

Şimdi duruyorsa, kaynak grubunu silmek isteyebilirsiniz.

  1. Azure portal, 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.
  4. Üstteki menüden kaynak grubunu sil ' i seçin.

Sonraki adımlar

Azure 'a dağıtmak için basit bir şablon oluşturdunuz. Sonraki öğreticide, şablona bir depolama hesabı ekleyecek ve bunu kaynak grubunuza dağıtacaksınız.

Kaynak Ekle