Azure Stack Hub'da şablon doğrulama aracını kullanma

  • Makale

Şablon doğrulama aracıyla Azure Resource Manager şablonlarınızı denetleyin. Araç, şablonunuzun Azure Stack Hub'a dağıtılmaya hazır olup olmadığını denetler. Doğrulama aracını Azure Stack Hub araçları GitHub deposundan alabilirsiniz.

Not

Araç, Azure Stack'te desteklenen kaynak türleri ve API sürümleri için Azure Resource Manager şablonunu doğrular. Ancak araç, her kaynak türü için desteklenen özellikleri doğrulamaz.

Genel Bakış

Şablonu doğrulamak için önce bir bulut özellikleri dosyası oluşturmanız ve ardından doğrulama aracını çalıştırmanız gerekir. Azure Stack Hub araçlarından aşağıdaki PowerShell modüllerini kullanın:

  • CloudCapabilities klasöründe: Az.CloudCapabilities.psm1, Azure Stack Hub bulutundaki hizmetleri ve sürümleri temsil eden bir bulut özellikleri JSON dosyası oluşturur.
  • TemplateValidator klasöründe: Az.TemplateValidator.psm1, Azure Stack Hub'da dağıtım için şablonları test etmek üzere bir bulut özellikleri JSON dosyası kullanır.

Bulut özellikleri dosyasını oluşturma

Şablon doğrulayıcısını kullanmadan önce Az.CloudCapabilities PowerShell modülünü çalıştırarak bir JSON dosyası oluşturun.

Not

Tümleşik sisteminizi güncelleştirirseniz veya yeni hizmetler ya da sanal uzantılar eklerseniz bu modülü yeniden çalıştırmanız gerekir.

  1. Azure Stack Hub'a bağlantınız olduğundan emin olun. Bu adımlar Azure Stack Geliştirme Seti (ASDK) konağından yapılabilir veya iş istasyonunuzdan bağlanmak için vpn kullanabilirsiniz.

  2. Az.CloudCapabilities PowerShell modülünü içeri aktarın:

    Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1

  3. Hizmet sürümlerini almak ve bir bulut özellikleri JSON dosyası oluşturmak için Get-CloudCapabilities cmdlet'ini kullanın. belirtmezseniz -OutputPathAzureCloudCapabilities.json dosyası geçerli dizinde oluşturulur. Gerçek Azure konumunuzu kullanın:

Get-AzCloudCapability -Location <your location> -Verbose

Şablonları doğrulama

Az.TemplateValidator PowerShell modülünü kullanarak şablonları doğrulamak için bu adımları kullanın. Kendi şablonlarınızı veya Azure Stack Hub Hızlı Başlangıç şablonlarını kullanabilirsiniz.

  1. Az.TemplateValidator.psm1 PowerShell modülünü içeri aktarın:

    cd "c:\AzureStack-Tools-az\TemplateValidator"
Import-Module .\Az.TemplateValidator.psm1

  2. Şablon doğrulayıcısını çalıştırın:

Test-AzTemplate -TemplatePath <path to template.json or template folder> `
-CapabilitiesPath <path to cloudcapabilities.json> `
-Verbose

Doğrulayıcı, PowerShell konsolunda şablon doğrulama uyarılarını veya hatalarını görüntüler ve bunları kaynak dizindeki bir HTML dosyasına yazar. Aşağıdaki ekran görüntüsü bir doğrulama raporu örneğidir:

Şablon doğrulama raporu

Parametreler

Şablon doğrulayıcı cmdlet'i aşağıdaki parametreleri destekler.

Parametre Açıklama Gerekli
TemplatePath Azure Resource Manager şablonlarını yinelemeli olarak bulma yolunu belirtir. Yes
TemplatePattern Eşleşecek şablon dosyalarının adını belirtir. Hayır
CapabilitiesPath Bulut özellikleri JSON dosyasının yolunu belirtir. Yes
IncludeComputeCapabilities VM boyutları ve VM uzantıları gibi IaaS kaynaklarının değerlendirilmesini içerir. Hayır
IncludeStorageCapabilities SKU türleri gibi depolama kaynaklarının değerlendirilmesini içerir. Hayır
Report Oluşturulan HTML raporunun adını belirtir. Hayır
Verbose Hataları ve uyarıları konsola kaydeder. Hayır

Örnekler

Bu örnek, yerel depolama alanına indirilen tüm Azure Stack Hub Hızlı Başlangıç şablonlarını doğrular. Örnek ayrıca ASDK özelliklerine göre sanal makine (VM) boyutlarını ve uzantılarını doğrular.

test-AzTemplate -TemplatePath C:\AzureStack-Quickstart-Templates `
-CapabilitiesPath .\TemplateValidator\AzureStackCloudCapabilities_with_AddOns_20170627.json `
-TemplatePattern MyStandardTemplateName.json `
-IncludeComputeCapabilities `
-Report TemplateReport.html

Sonraki adımlar