Создание шаблонов ARM

ARM-шаблоны позволяют определять инфраструктуру Azure как код в формате JSON. Благодаря этому развертывания становятся воспроизводимыми и согласованными, а шаблоны можно хранить под контролем версий вместе с кодом приложения. Шаблоны идемпотентны: многократный запуск одного и того же шаблона даёт одинаковый результат, поэтому его безопасно применять повторно после внесения изменений.

Каждый ARM-шаблон начинается со свойства $schema, указывающего URL схемы шаблона, за которым следует строка contentVersion. Схема сообщает порталу Azure и расширениям редактора, как проверять шаблон и предоставлять IntelliSense. Далее следуют пять основных разделов: parameters, variables, functions, resources и outputs.

Параметры делают шаблоны повторно используемыми, принимая входные данные во время развертывания. У каждого параметра есть type (string, int, bool, object, array, secureString), необязательное defaultValue и необязательные allowedValues для проверки. Использование secureString для паролей гарантирует, что значение никогда не будет записано в журнал истории развертываний.

Переменные хранят значения, вычисленные на основе параметров или функций шаблона, уменьшая повторения и упрощая обслуживание шаблонов. Переменные вычисляются один раз и используются во всём разделе ресурсов с помощью выражения [variables('name')]. Распространённый шаблон — формирование имени ресурса путём объединения параметра с уникальным суффиксом.

Массив resources — это основа ARM-шаблона. Каждый элемент описывает один ресурс Azure и содержит обязательные поля: type, apiVersion, name и location. Поле apiVersion фиксирует версию схемы поставщика ресурсов. Всегда используйте последнюю стабильную версию, чтобы получить доступ к новейшим функциям и избежать устаревших свойств.

Выражения ARM-шаблонов заключаются в квадратные скобки [...] и поддерживают встроенные функции для строк, массивов, объектов и идентификаторов ресурсов. Распространённые функции включают concat(), resourceGroup(), resourceId(), uniqueString() и parameters(). ARM вычисляет эти функции на стороне сервера во время развертывания, а не локально.

Раздел outputs определяет значения, которые ARM возвращает после успешного развертывания. Выходные данные необходимы для связывания шаблонов: сначала Вы разворачиваете сетевой шаблон и получаете идентификатор ресурса подсети, а затем передаёте его как параметр шаблону VM. Выходные данные могут ссылаться на любое выражение, включая свойства ресурсов из развертывания.

Для сложных архитектур ARM поддерживает связанные шаблоны (ссылки на внешние URL-адреса шаблонов) и вложенные шаблоны (встраивание шаблона в массив ресурсов с использованием типа Microsoft.Resources/deployments). Это позволяет разделить крупное развертывание инфраструктуры на модульные, повторно используемые части, сохранив единый шаблон оркестрации в качестве точки входа.

Вместо передачи параметров в командной строке сохраните их в отдельном файле параметров — файле JSON с объектом parameters, содержащим пары имя-значение. Файлы параметров могут быть специфичными для окружения (например, dev.parameters.json, prod.parameters.json) и храниться в системе управления исходным кодом, а конфиденциальные значения можно указывать через ссылки на Azure Key Vault, а не в виде обычного текста.

Используйте команду Azure CLI az deployment group create, чтобы развернуть шаблон в группе ресурсов. Перед развертыванием в рабочей среде выполните az deployment group validate, чтобы обнаружить ошибки схемы и логики, а затем az deployment group what-if, чтобы просмотреть изменения ресурсов. Эти три команды образуют безопасный конвейер развертывания: проверка, предварительный просмотр, развертывание.

Следуйте этим рекомендациям по работе с ARM-шаблонами: используйте параметры для значений, зависящих от окружения, используйте переменные, чтобы избежать повторений, фиксируйте версии API на стабильных версиях, используйте secureString для паролей, добавляйте описания в метаданных параметров и разделяйте большие шаблоны на связанные модули. Храните шаблоны в репозитории Git и разворачивайте их через конвейер CI/CD для возможности аудита.

Проверьте своё понимание концепций Microsoft Azure Fundamentals (AZ-900), рассмотренных в этом уроке.

В этом уроке Вы узнали, что ARM-шаблоны — это документы JSON, декларативно определяющие инфраструктуру Azure, параметры и переменные делают шаблоны повторно используемыми и удобными для сопровождения, а рабочий процесс validate, what-if, deploy обеспечивает безопасные и воспроизводимые развертывания. Далее мы рассмотрим Bicep — современный уровень абстракции над ARM JSON.