A sablonérvényesítési eszköz használata az Azure Stack Hubban
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.
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.
Importálja az Az.CloudCapabilities PowerShell-modult:
Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1
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.
Importálja az Az.TemplateValidator.psm1 PowerShell-modult:
cd "c:\AzureStack-Tools-az\TemplateValidator" Import-Module .\Az.TemplateValidator.psm1
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ó:
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