Руководство: Создание и развертывание первого шаблона ARM

В этом руководстве описаны шаблоны Azure Resource Manager (шаблоны ARM). В нем показано, как создать начальный шаблон и развернуть его в Azure. Здесь вы узнаете о структуре шаблона и средствах, необходимых для работы с шаблонами. Эта инструкция занимает 12 минут , но фактическое время окончания зависит от того, сколько средств необходимо установить.

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

Если вы хотите узнать о преимуществах использования шаблонов и о том, почему следует автоматизировать развертывание с помощью шаблонов, ознакомьтесь с обзором шаблона ARM. Сведения о шаблонах ARM с помощью управляемого набора модулей Learn см. в статье "Развертывание ресурсов и управление ими в Azure с помощью шаблонов ARM JSON".

Если у вас нет подписки Microsoft Azure, создайте бесплатную учетную запись перед началом работы.

Получить инструменты

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

Editor

Шаблоны — это файлы нотации объектов JavaScript (JSON). Для создания шаблонов можно использовать Visual Studio Code.

Развертывание из командной строки

Для развертывания шаблона также требуется Azure PowerShell или Интерфейс azure Command-Line (CLI). Если вы используете Azure CLI, необходимо иметь версию 2.37.0 или более позднюю. Ознакомьтесь с инструкциями по установке:

• Установка Azure PowerShell
• Установка Azure CLI в Windows
• Установка Azure CLI в Linux
• Установка Azure CLI в macOS

После установки Azure PowerShell или Azure CLI убедитесь, что вы войдите в систему впервые. Дополнительные сведения см. в статье о входе в PowerShell или входе в Azure CLI.

Хорошо, вы готовы приступить к изучению шаблонов.

Создание первого шаблона

1. Откройте Visual Studio Code.

2. В меню "Файл" выберите "Создать файл ", чтобы создать новый файл.

3. В меню "Файл" выберите "Сохранить как".

4. Назовите файл azuredeploy и выберите расширение json-файла . Полное имя файла — azuredeploy.json.

5. Сохраните файл на рабочей станции. Выберите путь, который легко помнить, так как вам нужно предоставить этот путь позже при развертывании шаблона.

6. Скопируйте и вставьте следующий код JSON в файл:

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "resources": []
   }
   

   Вот как выглядит среда Visual Studio Code:

   

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

   JSON-файл содержит следующие элементы:

   • $schema: указывает расположение файла схемы JSON. Файл схемы описывает свойства, доступные в шаблоне. Схема, например, определяет resources как одно из допустимых свойств для шаблона. Не беспокойтесь, что дата схемы — 2019-04-01. Эта версия схемы обновлена и включает все последние функции. Дата схемы не была изменена, так как с момента его внедрения не было критических изменений.
   • contentVersion: указывает версию шаблона, например 1.0.0.0.0. Можно указать любое значение для этого элемента. Используйте это значение для документирования существенных изменений в шаблоне. При развертывании ресурсов с помощью шаблона можно использовать это значение, чтобы убедиться, что вы используете правильный шаблон.
   • resources: содержит ресурсы, которые требуется развернуть или обновить. В настоящее время это пусто, но вы можете добавить ресурсы позже.

7. Сохраните файл.

Поздравляем, вы создали свой первый шаблон.

Вход в Azure

Чтобы начать работу с Azure PowerShell или Azure CLI, войдите с помощью учетных данных Azure.

Выберите вкладки в следующих разделах кода, чтобы выбрать между Azure PowerShell и Azure CLI. Примеры интерфейса командной строки в этой статье написаны для оболочки Bash.

Connect-AzAccount

az login

Если у вас несколько подписок Azure, выберите нужную подписку. Замените SubscriptionName своим именем подписки. Вы также можете использовать идентификатор подписки вместо имени подписки.

Set-AzContext SubscriptionName

az account set --subscription SubscriptionName

Создать группу ресурсов

При развертывании шаблона можно указать группу ресурсов для хранения ресурсов. Перед выполнением команды развертывания создайте группу ресурсов с помощью Azure CLI Bash или Azure PowerShell.

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

az group create \
  --name myResourceGroup \
  --location 'Central US'

Развертывание шаблона

Чтобы развернуть шаблон, используйте Azure CLI или Azure PowerShell. Используйте созданную группу ресурсов. Присвойте развертыванию имя, чтобы его можно было легко определить в журнале развертывания. Для удобства также создайте переменную, в которой хранится путь к файлу шаблона. Эта переменная упрощает выполнение команд развертывания, так как при каждом развертывании не требуется повторно вводить путь. Замените {provide-the-path-to-the-template-file} и фигурные скобки {} на путь к файлу вашего шаблона.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

templateFile="{provide-the-path-to-the-template-file}"
az deployment group create \
  --name blanktemplate \
  --resource-group myResourceGroup \
  --template-file $templateFile

Команда развертывания возвращает результаты. Посмотрите на ProvisioningState, чтобы убедиться, что развертывание прошло успешно.

Проверка развертывания

Развертывание можно проверить, просмотрев группу ресурсов на портале Azure.

1. Войдите на портал Azure.

2. В меню слева выберите группы ресурсов.

3. Установите флажок слева от myResourceGroup и выберите myResourceGroup.

4. Выберите группу ресурсов, созданную в предыдущей процедуре. Имя по умолчанию — myResourceGroup. У группы ресурсов пока нет ресурсов, так как вы развернули пустой шаблон.

5. Обратите внимание, что в середине обзора в разделе Essentials на странице отображается состояние развертывания рядом с развертываниями. Выберите 1 Успешно.

   

6. Вы видите историю развертываний для группы ресурсов. Установите флажок слева от blanktemplate и выберите blanktemplate.

   

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

   

Очистите ресурсы

Если вы переходите к следующему руководству, вам не нужно удалять группу ресурсов.

Если вы сейчас хотите остановиться, возможно, вы захотите удалить группу ресурсов.

1. На портале Azure выберите группы ресурсов в меню слева.

2. Введите имя группы ресурсов в поле текста фильтр для любого поля....

3. Установите флажок рядом с myResourceGroup и выберите myResourceGroup или имя группы ресурсов.

4. Выберите "Удалить группу ресурсов " в верхнем меню.

   

Дальнейшие шаги

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