Руководство по использованию справочной документации по шаблонам Resource Manager

  • Статья

Узнайте, как найти сведения о схеме шаблона и использовать их для создания шаблонов Azure Resource Manager.

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

Учетная запись хранения справочных материалов для развертывания шаблона Resource Manager

В рамках этого руководства рассматриваются следующие задачи:

  • Открытие шаблона быстрого запуска
  • Общие сведения о шаблоне
  • Поиск ссылки на шаблон
  • Изменение шаблона
  • Развертывание шаблона

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

Предварительные требования

Для работы с этой статьей необходимо иметь следующее.

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

Шаблоны быстрого запуска Azure — это репозиторий для шаблонов Resource Manager. Вместо создания шаблона с нуля можно найти пример шаблона и настроить его. Шаблон, используемый в этом кратком руководстве, называется Create a standard storage account (Создание стандартной учетной записи хранения). Шаблон определяет ресурс учетной записи службы хранилища Azure.

  1. В Visual Studio Code выберите Файл>Открыть файл.

  2. Скопируйте приведенный ниже URL-адрес и вставьте его в поле Имя файла.

    https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json

  3. Чтобы открыть файл, выберите Открыть.

  4. Выберите Файл>Сохранить как, чтобы сохранить файл в качестве azuredeploy.json на локальном компьютере.

Изучение схемы

  1. В VS Code сверните шаблон до корневого уровня. Имеется простейшая структура со следующими элементами.

    Простейшая структура шаблона Resource Manager

    • Параметр $schema указывает расположение файла схемы JSON, который описывает версию языка шаблона.
    • Параметр contentVersion задает этому элементу любое значение, чтобы документировать важные изменения в шаблоне.
    • Параметр metadata позволяет задать метаданные шаблона.
    • Параметр parameters указывает значения, которые предоставляются при выполнении развертывания для настройки развертывания ресурсов.
    • Параметр variables указывает значения, используемые в виде фрагментов JSON в шаблоне для упрощения выражений на языке шаблона. Этот шаблон не содержит данный элемент.
    • Параметр resources указывает типы ресурсов, которые развертываются или обновляются в группе ресурсов.
    • Параметр outputs указывает значения, возвращаемые после развертывания.

  2. Разверните раздел resources. Вы увидите определенный ресурс Microsoft.Storage/storageAccounts. На снимке экрана показана версия API 2022-09-01. В качестве имени SKU используется значение параметра. Имя параметра — storageAccountType.

    Определение учетной записи хранения в шаблоне Resource Manager

  3. Разверните раздел parameters, чтобы увидеть, как определен storageAccountType. Параметр имеет восемь допустимых значений. Номера SKU ресурсов учетной записи хранения в шаблоне Resource Manager

С помощью справочника по шаблону можно узнать, используется ли самая последняя версия API и включает ли определение параметра все допустимые значения.

Поиск ссылки на шаблон

  1. Перейти к справочнику по шаблонам Azure.

  2. В поле Фильтр по названию введите учетные записи хранения и выберите первый пункт Учетные записи хранения в разделе Справочные материалы > Хранилище.

    Учетная запись хранения ссылки на шаблон Resource Manager

  3. Выберите шаблон ARM.

  4. У типа ресурса обычно бывает несколько версий API. На этой странице по умолчанию отображается последняя версия схемы шаблона. Выберите раскрывающийся список Последняя, чтобы просмотреть версии. Последняя версия, показанная на снимку экрана: 01.09.2022. Выберите значение Последняя или версию, расположенную сразу под элементом Последняя, чтобы просмотреть последнюю версию. Убедитесь, что эта версия соответствует версии, используемой для ресурса учетной записи хранения в шаблоне. При обновлении версии API убедитесь, что определение ресурса соответствует, указанному в справочнике по шаблонам.

    Справочные материалы по шаблону Resource Manager: версии учетной записи хранения

  5. На этой странице приведены сведения о типе ресурса storageAccount. Например, на ней перечислены допустимые значения для объекта SKU. Существует восемь номеров SKU, и они соответствуют значениям в шаблоне быстрого запуска, который вы открыли ранее.

    Справочные материалы по шаблону Resource Manager: номера SKU учетной записи хранения

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

  1. Войдите в Azure Cloud Shell.

  2. В левом верхнем углу выберите используемую среду — PowerShell или Bash (для CLI). После переключения желательно перезагрузить оболочку.

    Файл отправки Cloud Shell на портале Azure

  3. Выберите Отправка и скачивание файлов, а затем Отправить. См. предыдущий снимок экрана. Выберите файл, сохраненный ранее. После отправки вы можете использовать команды ls и cat, чтобы проверить отправку файла.

  4. Выполните следующие команды в Cloud Shell. Выберите вкладку, чтобы отобразить код PowerShell или код CLI.

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

    echo "Enter a project name that is used to generate resource group name:" &&
read projectName &&
echo "Enter the location (i.e. centralus):" &&
read location &&
resourceGroupName="${projectName}rg" &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'

Очистка ресурсов

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

  1. На портале Azure в меню слева выберите Группа ресурсов.
  2. В поле Фильтровать по имени введите имя группы ресурсов.
  3. Выберите имя группы ресурсов. В группе ресурсов должно появится шесть ресурсов.
  4. В главном меню выберите Удалить группу ресурсов.

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

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

Развертывание нескольких экземпляров