A sablonérvényesítési eszköz használata az Azure Stack Hubban

  • Cikk

Ellenőrizze az Azure Resource Manager-sablonokat a sablonérvényesítési eszközzel. Az eszköz ellenőrzi, hogy a sablon készen áll-e az Azure Stack Hubon való üzembe helyezésre. Az érvényesítési eszközt az Azure Stack Hub-eszközök GitHub-adattárából szerezheti be.

Megjegyzés

Az eszköz ellenőrzi az Azure Resource Manager sablont az Azure Stack támogatott erőforrástípusaihoz és API-verzióihoz. Az eszköz azonban nem ellenőrzi az egyes erőforrástípusokhoz támogatott tulajdonságokat.

Áttekintés

A sablon érvényesítéséhez először létre kell készítenie egy felhőalapú képességfájlt, majd futtatnia kell az érvényesítő eszközt. Használja a következő PowerShell-modulokat az Azure Stack Hub-eszközökből:

  • A CloudCapabilities mappában: Az.CloudCapabilities.psm1 létrehoz egy felhőbeli képességek JSON-fájlt, amely az Azure Stack Hub-felhő szolgáltatásainak és verzióinak jelölője.
  • A TemplateValidator mappában: Az Az.TemplateValidator.psm1 egy felhőbeli JSON-fájllal teszteli a sablonokat az Azure Stack Hubban való üzembe helyezéshez.

A felhőképességek fájljának létrehozása

A sablon-érvényesítő használata előtt futtassa az Az.CloudCapabilities PowerShell-modult egy JSON-fájl létrehozásához.

Megjegyzés

Ha frissíti az integrált rendszert, vagy új szolgáltatásokat vagy virtuális bővítményeket ad hozzá, futtassa újra ezt a modult.

  1. Győződjön meg arról, hogy rendelkezik kapcsolattal az Azure Stack Hubbal. Ezek a lépések elvégezhetők az Azure Stack Development Kit (ASDK) gazdagépéről, vagy VPN használatával is csatlakozhat a munkaállomásról.

  2. Importálja az Az.CloudCapabilities PowerShell-modult:

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

  3. A Get-CloudCapabilities parancsmaggal lekérheti a szolgáltatásverziókat, és létrehozhat egy felhőbeli képességek JSON-fájlját. Ha nem adja meg a értéket -OutputPath, az AzureCloudCapabilities.json fájl az aktuális könyvtárban jön létre. Használja a tényleges Azure-helyet:

Get-AzCloudCapability -Location <your location> -Verbose

Sablonok ellenőrzése

Ezekkel a lépésekkel érvényesítheti a sablonokat az Az.TemplateValidator PowerShell-modul használatával. Használhatja saját sablonjait, vagy használhatja az Azure Stack Hub gyorsindítási sablonjait.

  1. Importálja az Az.TemplateValidator.psm1 PowerShell-modult:

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

  2. Futtassa a sablon-érvényesítőt:

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

Az érvényesítő sablonérvényesítési figyelmeztetéseket vagy hibákat jelenít meg a PowerShell-konzolon, és egy HTML-fájlba írja őket a forráskönyvtárban. Az alábbi képernyőképen egy ellenőrzési jelentés látható:

Sablonérvényesítési jelentés

Paraméterek

A sablon-érvényesítő parancsmag a következő paramétereket támogatja.

Paraméter Leírás Kötelező
TemplatePath Megadja az Azure Resource Manager-sablonok rekurzív keresésének elérési útját. Yes
TemplatePattern Megadja az egyező sablonfájlok nevét. No
CapabilitiesPath Megadja a felhőbeli képességek JSON-fájljának elérési útját. Yes
IncludeComputeCapabilities Magában foglalja az IaaS-erőforrások, például a virtuálisgép-méretek és a virtuálisgép-bővítmények kiértékelését. No
IncludeStorageCapabilities Magában foglalja a tárolási erőforrások, például a termékváltozatok kiértékelését. No
Report A létrehozott HTML-jelentés nevét adja meg. No
Verbose Naplózza a hibákat és figyelmeztetéseket a konzolon. No

Példák

Ez a példa ellenőrzi a helyi tárolóba letöltött összes Azure Stack Hub gyorsindítási sablont . A példa a virtuális gépek méretét és bővítményeit is ellenőrzi az ASDK-képességek alapján.

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

Következő lépések