Использование средства проверки шаблонов в Azure Stack Hub

  • Статья
  • Чтение занимает 2 мин

Проверьте шаблоны Azure Resource Manager с помощью средства проверки шаблонов. Средство проверяет, готов ли шаблон к развертыванию в Azure Stack Hub. Средство проверки можно получить из средств Azure Stack Hub GitHub репозитория.

Примечание

Средство проверяет шаблон Azure Resource Manager для поддерживаемых типов ресурсов и версий API в Azure Stack. Однако средство не проверяет свойства, поддерживаемые для каждого типа ресурса.

Обзор

Чтобы проверить шаблон, сначала нужно создать файл возможностей облака, а затем запустить средство проверки. Можно использовать приведенные ниже модули PowerShell из набора инструментов Azure Stack Hub.

  • В папке CloudCapabilities : Az.CloudCapabilities.psm1 создает JSON-файл облачных возможностей, представляющий службы и версии в облаке Azure Stack Hub.
  • В папке TemplateValidator : Az.TemplateValidator.psm1 использует JSON-файл облачных возможностей для тестирования шаблонов для развертывания в Azure Stack Hub.

Создание файла возможностей облака

Прежде чем использовать проверяющий элемент управления шаблоном, запустите модуль PowerShell Az.CloudCapabilities для создания JSON-файла.

Примечание

При обновлении интегрированной системы и добавлении новых служб или расширений виртуальной машины следует еще раз запустить этот модуль.

  1. Убедитесь, что у вас есть подключение к Azure Stack Hub. Эти шаги можно выполнить на узле Пакета средств разработки Azure Stack (ASDK) или на рабочей станции, подключенной через VPN.

  2. Импортируйте модуль PowerShell Az.CloudCapabilities :

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

  3. С помощью командлета Get-CloudCapabilities вы можете получить версии служб и создать JSON-файл облачных компонентов. Если не указать -OutputPath, файл AzureCloudCapabilities.json создается в текущем каталоге. Укажите фактическое расположение Azure.

Get-AzCloudCapability -Location <your location> -Verbose

Проверка шаблонов

Выполните следующие действия, чтобы проверить шаблоны с помощью модуля PowerShell Az.TemplateValidator . Вы можете использовать собственные шаблоны или шаблоны быстрого запуска Azure Stack Hub.

  1. Импортируйте модуль PowerShell Az.TemplateValidator.psm1 :

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

  2. Запустите средство проверки шаблонов:

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

Проверяющий элемент управления отображает предупреждения или ошибки проверки шаблона в консоли PowerShell и записывает их в HTML-файл в исходном каталоге. На снимке экрана ниже показан пример отчета о проверке.

Template validation report

Параметры

Командлет средства проверки шаблонов поддерживает следующие параметры.

Параметр Описание Обязательно
TemplatePath Указывает путь для рекурсивного поиска шаблонов Azure Resource Manager. Да
TemplatePattern Задает шаблон имени, по которому выбираются файлы. Нет
CapabilitiesPath Указывает путь к JSON-файлу возможностей облака. Да
IncludeComputeCapabilities Включает оценку ресурсов IaaS, например размеров и расширений виртуальных машин. Нет
IncludeStorageCapabilities Включает оценку ресурсов хранения, например типов SKU. Нет
Report Указывает имя создаваемого HTML-файла отчета. Нет
Verbose Выводит ошибки и предупреждения в консоль. Нет

Примеры

Этот пример проверяет все шаблоны быстрого запуска Azure Stack Hub, скачанные в локальное хранилище. В этом примере также проверяются размеры и расширения виртуальной машины в зависимости от возможностей ASDK.

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

Дальнейшие действия