Bagikan melalui

Menggunakan alat validasi templat di Azure Stack Hub

  • Artikel

Periksa templat Azure Resource Manager Anda dengan alat validasi templat. Alat ini memeriksa apakah templat Anda siap untuk disebarkan ke Azure Stack Hub. Anda bisa mendapatkan alat validasi dari alat Azure Stack Hub repositori GitHub.

Catatan

Alat ini memvalidasi templat Azure Resource Manager untuk jenis sumber daya yang didukung dan versi API di Azure Stack. Namun, alat ini tidak memvalidasi properti yang didukung untuk setiap jenis sumber daya.

Gambaran Umum

Untuk memvalidasi templat, Anda harus membuat file kemampuan cloud terlebih dahulu, lalu menjalankan alat validasi. Gunakan modul PowerShell berikut dari alat Azure Stack Hub:

  • Dalam folder CloudCapabilities: Az.CloudCapabilities.psm1 membuat file JSON kemampuan cloud yang mewakili layanan dan versi di cloud Azure Stack Hub.
  • Dalam folder TemplateValidator: Az.TemplateValidator.psm1 menggunakan file JSON kemampuan cloud untuk menguji templat untuk penyebaran di Azure Stack Hub.

Membangun file kemampuan cloud

Sebelum Anda menggunakan validator templat, jalankan modul PowerShell Az.CloudCapabilities untuk membuat file JSON.

Catatan

Jika Anda memperbarui sistem terintegrasi Anda, atau menambahkan layanan baru atau ekstensi virtual, Anda harus menjalankan modul ini lagi.

  1. Pastikan Anda memiliki konektivitas ke Azure Stack Hub. Langkah-langkah ini dapat dilakukan dari host Azure Stack Development Kit (ASDK), atau Anda dapat menggunakan VPN untuk tersambung dari stasiun kerja Anda.

  2. Impor modul PowerShell Az.CloudCapabilities:

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

  3. Gunakan cmdlet Get-CloudCapabilities untuk mengambil versi layanan dan membuat file JSON kemampuan cloud. Jika Anda tidak menentukan -OutputPath, file AzureCloudCapabilities.json akan dibuat di direktori saat ini. Gunakan lokasi Azure Anda yang sebenarnya:

Get-AzCloudCapability -Location <your location> -Verbose

Memvalidasi templat

Gunakan langkah-langkah ini untuk memvalidasi templat menggunakan modul PowerShell Az.TemplateValidator. Anda dapat menggunakan templat Anda sendiri, atau menggunakan templat Mulai Cepat Azure Stack Hub.

  1. Impor modul PowerShell Az.TemplateValidator.psm1:

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

  2. Jalankan validator templat:

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

Validator menampilkan peringatan atau kesalahan validasi templat di konsol PowerShell dan menulisnya ke file HTML di direktori sumber. Tangkapan layar berikut adalah contoh laporan validasi:

Laporan validasi templat

Parameter

Cmdlet validator templat mendukung parameter berikut.

Parameter Deskripsi Diperlukan
TemplatePath Menentukan jalur untuk menemukan templat Azure Resource Manager secara rekursif. Ya
TemplatePattern Menentukan nama file templat yang akan dicocokkan. Tidak
CapabilitiesPath Menentukan jalur ke file JSON kemampuan cloud. Ya
IncludeComputeCapabilities Termasuk evaluasi sumber daya IaaS, seperti ukuran VM dan ekstensi VM. Tidak
IncludeStorageCapabilities Termasuk evaluasi sumber daya penyimpanan, seperti jenis SKU. Tidak
Report Menentukan nama laporan HTML yang dihasilkan. Tidak
Verbose Mencatat kesalahan dan peringatan ke konsol. Tidak

Contoh

Contoh ini memvalidasi semua templat Mulai Cepat Azure Stack Hub yang diunduh ke penyimpanan lokal. Contoh ini juga memvalidasi ukuran dan ekstensi mesin virtual (VM) terhadap kemampuan ASDK.

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

Langkah berikutnya