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

Ellenőrizze a 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 Hub. Az érvényesítési eszközt az adatt Azure Stack Hub eszközből GitHub le.

Megjegyzés

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

Áttekintés

A sablonok érvényesítéséhez először létre kell hoznunk egy felhőképességek fájlját, majd futtatni kell az érvényesítési eszközt. Használja a következő PowerShell-modulokat Azure Stack Hub eszközökből:

  • A CloudCapabilities mappában: Az.CloudCapabilities.psm1 létrehoz egy felhőképességeket tartalmazó JSON-fájlt, amely egy felhőalapú felhőben Azure Stack Hub szolgáltatásokat és verziókat.
  • A TemplateValidator mappában: Az.TemplateValidator.psm1 egy felhőképességeket tartalmazó JSON-fájlt használ a sablonok üzembe helyezéséhez a Azure Stack Hub.

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

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

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 a Azure Stack Hub. Ezek a lépések az Azure Stack Development Kit (ASDK) gazdagépén, vagy VPN használatával is csatlakozhatnak a munkaállomásról.

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

    Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1
    
  3. A Get-CloudCapabilities parancsmag használatával lekéri a szolgáltatásverziókat, és létrehozhat egy felhőalapú képességeket létrehozására használható JSON-fájlt. Ha nem adja meg a értéket, -OutputPath az -OutputPath 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 ellenőrizheti a sablonokat az Az.TemplateValidator PowerShell-modullal. Használhatja a saját sablonját, vagy használhatja a Azure Stack Hub gyorsindítási sablonokat.

  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ő megjeleníti a sablonérvényesítési figyelmeztetéseket vagy hibákat a PowerShell-konzolon, és egy HTML-fájlba írja őket a forráskönyvtárban. Az alábbi képernyőkép egy érvényesítési jelentésre mutat példát:

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 a sablonok rekurzív keresésének Azure Resource Manager elérési útját. Yes
TemplatePattern Megadja az egyezni kívánt sablonfájlok nevét. No
CapabilitiesPath Megadja a felhőképességek JSON-fájl elérési útját. Yes
IncludeComputeCapabilities Ide tartozik 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ése. No
IncludeStorageCapabilities Tartalmazza a tárolási erőforrások, például a termékváltozat-típusok kiértékelése. No
Report A létrehozott HTML-jelentés nevét adja meg. No
Verbose Hibákat és figyelmeztetéseket naplóz a konzolon. No

Példák

Ez a példa a helyi tárolóba Azure Stack Hub összes gyorsindítási sablont ellenőrzi. A példa a virtuális gépek méretét és bővítményét is ellenőrzi az ASDK képességeivel szemben.

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