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

  • Статья

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

Примечание

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

Обзор

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

  • В папке CloudCapabilitiesAz.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-файл в исходном каталоге. На снимке экрана ниже показан пример отчета о проверке.

Пример отчета о проверке шаблона

Параметры

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

Параметр Описание Обязательно
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

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