Упражнение — определение ресурсов в шаблоне Bicep

  • 12 мин

Примечание.

Когда вы в первый раз активируете песочницу и принимаете условия, ваша учетная запись Майкрософт связывается с новым каталогом Azure с именем Microsoft Learn Sandbox. Вы также добавлены к специальной подписке под названием Concierge Subscription.

Для веб-сайта toy-launch вы решили сначала создать доказательство концепции, создав базовый шаблон Bicep. В этом упражнении вы создадите учетную запись хранения, план службы приложений Azure и приложение. Позже вы измените шаблон, чтобы сделать его более пригодным для повторного использования.

В процессе вы:

  • Создадите шаблон, определяющий единый ресурс учетной записи хранения, который включает жестко заданные значения.
  • Подготовьте инфраструктуру и проверьте результат.
  • Добавите в шаблон план службы приложений и приложение.
  • Снова подготовите инфраструктуру, чтобы увидеть новые ресурсы.

В этом упражнении используется расширение Bicep для Visual Studio Code. Убедитесь, что это расширение установлено в Visual Studio Code.

Создайте шаблон Bicep, содержащий учетную запись хранения

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

  2. Создайте файл с именем main.bicep.

  3. Сохраните пустой файл, куда Visual Studio Code загрузит средства Bicep.

    Можно выбрать Файл>Сохранить как или нажать клавиши CTRL+S в Windows (⌘+S в macOS). Обязательно запомните, где сохранен файл. Например, можно создать для сохранения файла папку templates (шаблоны).

  4. Добавьте в файл следующий код Bicep. Скоро вы развернете шаблон. Рекомендуется ввести код самостоятельно вместо копирования и вставки, чтобы увидеть, как инструмент помогает записывать файлы Bicep.

    resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: 'toylaunchstorage'
  location: 'eastus'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

    Совет

    В Bicep имеются строгие требования к разрывам строк, поэтому не ставьте разрывы как-то иначе, чем в примере выше.

    Обратите внимание, что Visual Studio Code автоматически предлагает имена свойств по мере ввода. Расширение Bicep для Visual Studio Code понимает ресурсы, которые вы определяете в своем шаблоне, и перечисляет доступные свойства и значения, которые вы можете использовать.

  5. Обновите имя учетной записи хранения до toylaunchstorage того, что, вероятно, будет уникальным, так как для каждой учетной записи хранения требуется глобально уникальное имя. Убедитесь, что имя равно 3–24 символам и включает только строчные буквы и цифры.

    Внимание

    Не пропускайте этот шаг. Если пропустить этот шаг, файл Bicep не будет успешно развернут.

  6. Сохраните изменения в файле.

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

Чтобы развернуть этот шаблон в Azure, необходимо войти в свою учетную запись Azure из терминала Visual Studio Code. У вас также должен быть установлен интерфейс Azure CLI, и необходимо войти под той же учетной записью, с которой вы активировали песочницу.

  1. В меню Терминал выберите Новый терминал. Окно терминала обычно открывается в нижней половине экрана.

  2. Если окно терминала отображает bash справа , это означает, что правильная оболочка уже открыта. Кроме того, если вы видите значок оболочки Bash справа, его можно выбрать для запуска оболочки.

    Снимок экрана: окно терминала Visual Studio Code с bash.

    Если появится оболочка, отличной от bash , выберите стрелку раскрывающегося списка оболочки и выберите Git Bash.

    Снимок экрана: окно терминала Visual Studio Code, где отображается раскрывающийся список оболочек терминала и выбран параметр

  3. Перейдите в терминале в каталог, где сохранили свой шаблон. Например, если вы сохранили его в папке templates, можно использовать следующую команду:

    cd templates

Установка Bicep

Выполните следующую команду, чтобы убедиться, что у вас установлена последняя версия Bicep:

az bicep install && az bicep upgrade

Вход в Azure

  1. В окне терминала Visual Studio Code войдите в Azure, выполнив следующую команду:

    az login

  2. В открывшемся браузере войдите в свою учетную запись Azure. Терминал Visual Studio Code отобразит список подписок, связанных с данной учетной записью. Выберите подписку с именем "Подписка Concierge".

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

    1. Получите идентификаторы подписок Concierge.

        az account list \
   --refresh \
   --query "[?contains(name, 'Concierge Subscription')].id" \
   --output table

    2. Задайте подписку по умолчанию, используя идентификатор подписки. Замените строку {your subscription ID} на идентификатор последней подписки Concierge.

      az account set --subscription {your subscription ID}

Установка группы ресурсов по умолчанию

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

az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"

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

Выполните следующую команду из терминала в Visual Studio Code, чтобы развернуть шаблон Bicep в Azure. Команда может занять минуту или два, а затем вы увидите успешное развертывание. Если вы видите предупреждение о расположении, закодированное жестко, его можно игнорировать. Вы исправите расположение позже в модуле. Это безопасно, и развертывание будет выполнено успешно.

az deployment group create --name main --template-file main.bicep

В окне терминала появится Running....

Чтобы развернуть этот шаблон в Azure, войдите в свою учетную запись Azure из терминала Visual Studio Code. Убедитесь, что вы установили Azure PowerShell, и войдите в ту же учетную запись, которая активировала песочницу.

  1. В меню Терминал выберите Новый терминал. Окно терминала обычно открывается в нижней половине экрана.

  2. Если окно терминала отображает pwsh или powershell справа, это означает, что правильная оболочка уже открыта. Кроме того, если вы видите значок оболочки PowerShell справа, его можно выбрать для запуска оболочки.

    Снимок экрана: окно терминала Visual Studio Code с параметром pwsh, отображаемым в раскрывающемся списке оболочки.

    Если появится оболочка, отличной от pwsh или PowerShell , выберите стрелку раскрывающегося списка оболочки и выберите PowerShell.

    Снимок экрана: окно терминала Visual Studio Code с раскрывающимся списком оболочки терминала и выбранным PowerShell.

  3. Перейдите в терминале в каталог, где сохранили свой шаблон. Например, если вы сохранили его в папке templates, можно использовать следующую команду:

    Set-Location -Path templates

Установите Bicep CLI

Чтобы использовать Bicep из Azure PowerShell, установите Bicep CLI.

Вход в Azure с помощью Azure PowerShell

  1. В окне терминала Visual Studio Code выполните следующую команду:

    Connect-AzAccount

    Откроется браузер, в котором вы можете выполнить вход в учетную запись Azure. Браузер может быть открыт в фоновом режиме.

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

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

    1. Получите идентификатор подписки. Следующая команда выдаст список ваших подписок с идентификаторами. Найдите Concierge Subscription, а затем скопируйте идентификатор из второго столбца. Оно будет выглядеть примерно так — aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e.

      Get-AzSubscription

    2. Измените активную подписку на подписку Concierge. Обязательно замените заполнитель {Your subscription ID} (Ваш идентификатор подписки) идентификатором, который вы скопировали.

      $context = Get-AzSubscription -SubscriptionId {Your subscription ID}
Set-AzContext $context

Установка группы ресурсов по умолчанию

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

Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>

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

Разверните шаблон в Azure, выполнив следующие команды Azure PowerShell в терминале. Команда может занять минуту или два, и вы увидите успешное развертывание. Если вы видите предупреждение о расположении, закодированное жестко, его можно игнорировать. Вы исправите расположение позже в модуле. Это безопасно, и развертывание будет выполнено успешно.

New-AzResourceGroupDeployment -Name main -TemplateFile main.bicep

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

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

  1. Перейдите на портал Azure и убедитесь, что вы находитесь в подписке песочницы:

    1. Выберите свой аватар в правом верхнем углу страницы.
    2. Выберите Переключить каталог. В списке выберите каталог Песочница Microsoft Learn.

  2. На левой панели выберите Группы ресурсов.

  3. Выберите "[имя группы ресурсов песочницы]"

  4. В разделе Обзор вы можете увидеть, что одно развертывание выполнено успешно. Чтобы увидеть развертывание, может потребоваться развернуть область Essentials .

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

  5. Щелкните ссылку 1 Succeeded (1 успешное), чтобы просмотреть сведения об этом развертывании.

    Снимок экрана интерфейса портала Azure для развертываний с указанным одним развертыванием и успешным статусом.

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

    Снимок экрана интерфейса портала Azure для конкретного развертывания с указанием одного ресурса учетной записи хранения.

  7. Оставьте эту страницу открытой в браузере. Позже развертывания потребуется проверить снова.

Вы также можете проверить развертывание из командной строки. Для этого выполните следующую команду Azure CLI:

az deployment group list --output table

Вы также можете проверить развертывание из командной строки. Для этого выполните следующую команду Azure PowerShell:

Get-AzResourceGroupDeployment -ResourceGroupName <rgn>[sandbox resource group name]</rgn> | Format-Table

Добавьте план службы приложений и приложение в свой шаблон Bicep

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

  1. В файле main.bicep в Visual Studio Code добавьте следующий код в конец файла:

    resource appServicePlan 'Microsoft.Web/serverfarms@2024-04-01' = {
  name: 'toy-product-launch-plan-starter'
  location: 'eastus'
  sku: {
    name: 'F1'
  }
}

resource appServiceApp 'Microsoft.Web/sites@2024-04-01' = {
  name: 'toy-product-launch-1'
  location: 'eastus'
  properties: {
    serverFarmId: appServicePlan.id
    httpsOnly: true
  }
}

  2. Обновите имя приложения службы приложений с toy-product-launch-1 до уникального. Убедитесь, что имя составляет от 2 до 60 символов с прописными и строчными буквами, цифрами и дефисами и не начинается или заканчивается дефисом.

  3. Сохраните изменения в файле.

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

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

az deployment group create --name main --template-file main.bicep

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

New-AzResourceGroupDeployment -Name main -TemplateFile main.bicep

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

  1. Вернитесь к портал Azure и перейдите в группу ресурсов. Вы увидите одно успешное развертывание, как и прежде, так как для этого развертывания использовалось то же имя, что и для первого.

  2. Выберите ссылку 1 Выполнено.

  3. Выберите развертывание с именем main, а затем нажмите Сведения о развертывании, чтобы развернуть список развернутых ресурсов.

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

  4. Обратите внимание, что был развернут план Служба приложений и приложение.