Экспорт шаблона с помощью портала Azure

Статья
03/20/2024

Чтобы упростить создание шаблонов Azure Resource Manager, можно экспортировать шаблон из существующих ресурсов. Экспортированный шаблон помогает понять синтаксис и свойства JSON, которые развертывают ресурсы. Чтобы автоматизировать будущие развертывания, начните с изменения экспортированного шаблона для своего сценария. В процессе экспорта шаблона будет предпринята попытка создать пригодный для использования шаблон. Однако прежде чем экспортированные шаблоны можно будет использовать для развертывания ресурсов Azure, в них необходимо внести ряд изменений.

Диспетчер ресурсов позволяет выбрать один или несколько ресурсов для экспорта в шаблон. Вы можете выбрать именно те ресурсы, которые необходимы в шаблоне.

Эта статья содержит сведения о том, как экспортировать шаблоны на портале. Другие варианты см. в статьях:

Выбор правильного варианта экспорта

Шаблон можно экспортировать двумя способами:

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

В зависимости от выбранного варианта экспортированные шаблоны имеют разные качества.

Из группы ресурсов или ресурса	Из журнала
Шаблон создается автоматически. Вероятно, перед развертыванием потребуется оптимизировать код.	Шаблон создается в точном соответствии с ранее созданным шаблоном. Его можно будет развернуть без каких-либо изменений.
Шаблон — это моментальный снимок текущего состояния ресурсов. Он включает все изменения, внесенные вручную после развертывания.	В шаблоне отображаются только сведения о состоянии ресурсов во время развертывания. Изменения, внесенные вручную после развертывания, не включаются.
Вы можете выбрать из группы ресурсов ресурсы, которые необходимо экспортировать.	Включаются все ресурсы для определенного развертывания. Нельзя выбрать подмножество этих ресурсов или добавить ресурсы, которые были добавлены в другое время.
Шаблон включает все свойства ресурсов, в том числе некоторые свойства, которые обычно не задаются во время развертывания. Возможно, перед повторным использованием шаблона эти свойства потребуется удалить или очистить.	Шаблон включает только свойства, необходимые для развертывания. Он более лаконичен, и его легче считывать.
Возможно, шаблон включает не все параметры, необходимые для повторного использования. Большинство значений свойств жестко запрограммированы в шаблоне. Чтобы повторно развернуть шаблон в других средах, необходимо добавить параметры, повышающие возможность настройки ресурсов. Можно снять флажок Включить параметры, чтобы можно было создавать собственные параметры.	Шаблон включает параметры, которые упрощают повторное развертывание в разных средах.

Экспортируйте шаблон из группы ресурсов или ресурса, если:

необходимо захватить изменения, внесенные в ресурсы после исходного развертывания;
необходимо выбрать ресурсы для экспорта.
Ресурсы были созданы без помощи шаблона.

Экспортируйте шаблон из журнала, если:

необходим шаблон, при повторном использовании которого не возникнет трудностей;
не требуется включать изменения, внесенные после исходного развертывания.

Ограничения

Экспорт не гарантируется успешно. Экспорт не является надежным способом превратить существующие ресурсы в шаблоны, которые доступны для использования в рабочей среде. Лучше создавать ресурсы с нуля с помощью рукописного файла Bicep, шаблона ARM или terraform.

При экспорте из группы ресурсов или ресурса экспортированный шаблон создается из опубликованных схем для каждого типа ресурсов. Иногда схема не имеет последней версии для типа ресурса. Проверьте, включает ли экспортированный шаблон необходимые свойства. При необходимости измените экспортированный шаблон, чтобы использовать требуемую версию API.

В экспортированных паролях могут отсутствовать некоторые параметры пароля. Прежде чем использовать шаблоны для развертывания ресурсов, ознакомьтесь со справочником по шаблонам и добавьте эти параметры вручную.

Функция экспорта шаблона не поддерживает экспорт ресурсов службы "Фабрика данных Azure". Дополнительные сведения о том, как можно экспортировать ресурсы Фабрики данных, см. в статье Копирование или клонирование фабрики данных в службе "Фабрика данных Azure".

Чтобы экспортировать ресурсы, созданные с помощью классической модели развертывания, необходимо перенести их в модель развертывания Azure Resource Manager.

Если при экспорте шаблона появляется предупреждение о том, что тип ресурса не был экспортирован, свойства этого ресурса можно по-прежнему обнаружить. Свойства ресурсов см. в справочнике по шаблонам. Тип ресурса также можно найти в REST API Azure.

Группа ресурсов, для которой создается экспортированный шаблон, может содержать не более 200 ресурсов. При попытке экспортировать группу ресурсов, которая содержит более 200 ресурсов, появляется сообщение об ошибке Export template is not supported for resource groups more than 200 resources.

Экспорт шаблона из группы ресурсов

Чтобы экспортировать один или несколько ресурсов из группы ресурсов, выполните следующие действия.

Выберите группу ресурсов, содержащую ресурсы, которые необходимо экспортировать.
Выберите один или несколько ресурсов, установив флажки. Чтобы выбрать все ресурсы, установите флажок слева от имени. Пункт меню Экспортировать шаблон становится доступным после выбора по крайней мере одного ресурса.

На снимке экрана выбрана только учетная запись хранения.
Выберите Экспортировать шаблон.
Экспортированный шаблон отображается и доступен для скачивания и развертывания.

Флажок Включить параметры установлен по умолчанию. При выборе все параметры шаблона включаются при создании шаблона. Если вы хотите создать собственные параметры, снимите этот флажок, чтобы их не включать.

Экспорт шаблона из ресурса

Чтобы экспортировать один ресурс, выполните следующие действия.

Выберите группу ресурсов, содержащую ресурс, который необходимо экспортировать.
Выберите ресурс, который необходимо экспортировать, чтобы его открыть.
Для этого ресурса выберите Экспортировать шаблон на панели слева.
Экспортированный шаблон отображается и доступен для скачивания и развертывания. Шаблон содержит только один ресурс. Флажок Включить параметры установлен по умолчанию. При выборе все параметры шаблона включаются при создании шаблона. Если вы хотите создать собственные параметры, снимите этот флажок, чтобы их не включать.

Скачивание шаблона перед развертыванием

Портал позволяет скачать шаблон перед его развертыванием. Этот параметр недоступен в PowerShell или Azure CLI.

Выберите службу Azure, которую необходимо развернуть.
Введите значения для новой службы.
После прохождения проверки, но до начала развертывания выберите Скачать шаблон для службы автоматизации.
Шаблон отображается и доступен для скачивания и развертывания.

Экспорт шаблона после развертывания

Можно экспортировать шаблон, который использовался для развертывания существующих ресурсов. Вы получаете именно тот шаблон, который использовался для развертывания.

Выберите группу ресурсов, которую нужно экспортировать.
Щелкните ссылку в разделе Развертывания.
Выберите нужное развертывание из журнала развертывания.
Выберите Шаблон. Шаблон, использованный для этого развертывания, отображается и доступен для скачивания.

Следующие шаги

Узнайте, как экспортировать шаблоны с помощью Azure CLI, Azure PowerShell или REST API.
Сведения о синтаксисе шаблонов Azure Resource Manager см. в статье Описание структуры и синтаксиса шаблонов Azure Resource Manager.
Сведения о разработке шаблонов см. в пошаговых руководствах.