Udostępnij przez

Korzystanie z narzędzia do sprawdzania poprawności szablonu w usłudze Azure Stack Hub

Sprawdź szablony usługi Azure Resource Manager za pomocą narzędzia do sprawdzania poprawności szablonu. Narzędzie sprawdza, czy szablon jest gotowy do wdrożenia w usłudze Azure Stack Hub. Narzędzie do sprawdzania poprawności można pobrać z repozytorium GitHub narzędzi usługi Azure Stack Hub.

Uwaga / Notatka

Narzędzie weryfikuje szablon usługi Azure Resource Manager pod kątem obsługiwanych typów zasobów i wersji interfejsu API w usłudze Azure Stack. Jednak narzędzie nie weryfikuje właściwości obsługiwanych dla każdego typu zasobu.

Przegląd

Aby zweryfikować szablon, musisz najpierw utworzyć plik możliwości w chmurze, a następnie uruchomić narzędzie do sprawdzania poprawności. Użyj następujących modułów programu PowerShell z narzędzi usługi Azure Stack Hub:

  • W folderze CloudCapabilities : Az.CloudCapabilities.psm1 tworzy plik JSON możliwości chmury reprezentujący usługi i wersje w chmurze usługi Azure Stack Hub.
  • W folderze TemplateValidator : Az.TemplateValidator.psm1 używa pliku JSON możliwości w chmurze do testowania szablonów wdrożenia w usłudze Azure Stack Hub.

Tworzenie pliku możliwości chmury

Przed użyciem modułu sprawdzania poprawności szablonu uruchom moduł Az.CloudCapabilities programu PowerShell, aby skompilować plik JSON.

Uwaga / Notatka

W przypadku zaktualizowania zintegrowanego systemu lub dodania nowych usług lub rozszerzeń wirtualnych należy ponownie uruchomić ten moduł.

  1. Upewnij się, że masz łączność z usługą Azure Stack Hub. Te kroki można wykonać z sieci VPN, aby nawiązać połączenie ze stacji roboczej.

  2. Zaimportuj moduł Az.CloudCapabilities programu PowerShell:

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

  3. Użyj polecenia Get-CloudCapabilities cmdlet, aby pobrać wersje serwisowe i utworzyć plik JSON możliwości chmury. Jeśli nie określisz -OutputPathpliku, AzureCloudCapabilities.json zostanie utworzony w bieżącym katalogu. Użyj rzeczywistej lokalizacji platformy Azure:

    Get-AzCloudCapability -Location <your location> -Verbose

Weryfikowanie szablonów

Wykonaj następujące kroki, aby zweryfikować szablony przy użyciu modułu Az.TemplateValidator programu PowerShell. Możesz użyć własnych szablonów lub użyć szablonów Szybkiego startu usługi Azure Stack Hub.

  1. Zaimportuj moduł Az.TemplateValidator.psm1 programu PowerShell:

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

  2. Uruchom moduł sprawdzania poprawności szablonu:

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

Moduł sprawdzania poprawności wyświetla ostrzeżenia lub błędy walidacji szablonu w konsoli programu PowerShell i zapisuje je w pliku HTML w katalogu źródłowym. Poniższy zrzut ekranu przedstawia przykład raportu weryfikacji:

Raport weryfikacji szablonu

Parametry

Polecenie cmdlet sprawdzania poprawności szablonu obsługuje następujące parametry.

Parametr Opis Wymagane
TemplatePath Określa ścieżkę do cyklicznego znajdowania szablonów usługi Azure Resource Manager. Tak
TemplatePattern Określa nazwę plików szablonu, które mają być zgodne. Nie.
CapabilitiesPath Określa ścieżkę do pliku JSON funkcji chmury. Tak
IncludeComputeCapabilities Obejmuje ocenę zasobów IaaS, takich jak rozmiary maszyn wirtualnych i rozszerzenia maszyn wirtualnych. Nie.
IncludeStorageCapabilities Obejmuje ocenę zasobów magazynu, takich jak typy jednostek SKU. Nie.
Report Określa nazwę wygenerowanego raportu HTML. Nie.
Verbose Rejestruje błędy i ostrzeżenia w konsoli. Nie.

Przykłady

Ten przykład sprawdza poprawność wszystkich szablonów szybkiego startu usługi Azure Stack Hub pobranych do magazynu lokalnego.

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

Dalsze kroki

  • Last updated on