Краткое руководство. Развертывание веб-приложения Linux в Azure с помощью шаблона ARM

Статья
07/20/2023

Azure DevOps Services

Начните работу с шаблонами Azure Resource Manager (шаблоны ARM), развернув веб-приложение Linux с помощью MySQL. Шаблоны ARM позволяют сохранить конфигурацию в коде. Использование шаблона ARM является примером инфраструктуры как кода и хорошей практикой DevOps.

Шаблон ARM является файлом нотации объектов JavaScript (JSON), определяющими инфраструктуру и конфигурацию вашего проекта. В шаблоне используется декларативный синтаксис. В декларативном синтаксисе вы можете описать предполагаемое развертывание без написания последовательности команд программирования для создания развертывания.

Для развертывания ресурсов Azure можно использовать синтаксис JSON или Bicep . Узнайте больше о различиях между JSON и Bicep для шаблонов.

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

Для этого потребуются следующие компоненты.

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно.
Активная организация Azure DevOps. Регистрация в Azure Pipelines
(Для развертываний Bicep) Существующая группа ресурсов. Создайте группу ресурсов с помощью портал Azure, Azure CLI или Azure PowerShell.

Получите код

Создание вилки этого репозитория на GitHub:

https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.web/webapp-linux-managed-mysql

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

Шаблон определяет несколько ресурсов:

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

Войдите в свою организацию Azure DevOps и откройте нужный проект. Создайте проект, если у вас его еще нет.
Перейдите в раздел Конвейеры и выберите Создать конвейер.
Выберите GitHub в качестве расположения исходного кода.

Примечание

Вы можете быть перенаправлены на GitHub для входа. Для этого введите учетные данные GitHub.
Когда появится список репозиториев, выберите yourname/azure-quickstart-templates/.

Примечание

Вы можете быть перенаправлены на сайт GitHub для установки приложения Azure Pipelines. В этом случае выберите Утвердить и установить.
Когда откроется вкладка Настройка, выберите Starter pipeline.
Замените содержимое конвейера следующим кодом:
```
trigger:
- none

pool:
  vmImage: 'ubuntu-latest'
```
Создайте три переменные: siteName, administratorLoginи adminPass. adminPass должен быть секретной переменной.
- Выберите элемент Variables (Переменные).
- + Используйте знак , чтобы добавить три переменные. При создании adminPassвыберите Сохранить это значение в секрете.
- После завершения настройки нажмите Сохранить .
Переменная Значение Секрет?

siteName mytestsite Нет

adminUser fabrikam Нет

adminPass Fqdn:5362! Да
Сопоставьте секретную переменную $(adminPass) , чтобы она была доступна в задаче развертывания группы ресурсов Azure. В верхней части файла YAML сопоставьте с $(adminPass)$(ARM_PASS).
```
variables:
  ARM_PASS: $(adminPass)

trigger:
- none

pool:
  vmImage: 'ubuntu-latest'
```
Добавьте задачу "Копировать файлы" в ФАЙЛ YAML. Вы будете 101-webapp-linux-managed-mysql использовать проект . Дополнительные сведения см. в статье Создание веб-приложения в Linux с помощью репозитория Базы данных Azure для MySQL .
```
variables:
  ARM_PASS: $(adminPass)

trigger:
- none

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: CopyFiles@2
  inputs:
    SourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'
    Contents: '**'
    TargetFolder: '$(Build.ArtifactStagingDirectory)'
```
Добавьте и настройте задачу развертывания группы ресурсов Azure .

Задача ссылается как на артефакт, созданный с помощью задачи Копирования файлов, так и на переменные конвейера. Задайте эти значения при настройке задачи.
- Область развертывания (deploymentScope): задайте для область развертывания значение Resource Group. Вы можете нацелить развертывание на группу управления, подписку Azure или группу ресурсов.
- Подключение azure Resource Manager (azureResourceManagerConnection): выберите подключение службы azure Resource Manager. Чтобы настроить новое подключение к службе, выберите подписку Azure из списка и щелкните Авторизовать. Дополнительные сведения см. в статье Подключение к Microsoft Azure .
- Подписка (subscriptionId): выберите подписку, в которой должно быть развернуто развертывание.
- Действие (действие): задайте значение Create or update resource group , чтобы создать новую группу ресурсов или обновить существующую.
- Группа ресурсов: задайте значение ,ARMPipelinesLAMP-rg чтобы присвоить имя новой группе ресурсов. Если это существующая группа ресурсов, она будет обновлена.
- Location(location): расположение для развертывания группы ресурсов. Задайте ближайшее расположение (например, западная часть США). Если группа ресурсов уже существует в вашей подписке, это значение будет игнорироваться.
- Расположение шаблона (templateLocation): задайте для Linked artifactзначение . Это расположение шаблона и файлов параметров.
- Шаблон (csmFile): задайте для $(Build.ArtifactStagingDirectory)/azuredeploy.jsonзначение . Это путь к шаблону ARM.
- Параметры шаблона (csmParametersFile): задайте для значение $(Build.ArtifactStagingDirectory)/azuredeploy.parameters.json. Это путь к файлу параметров для шаблона ARM.
- Переопределение параметров шаблона (overrideParameters): задайте значение для -siteName $(siteName) -administratorLogin $(adminUser) -administratorLoginPassword $(ARM_PASS) использования ранее созданных переменных. Эти значения заменят параметры, заданные в файле параметров шаблона.
- Режим развертывания (deploymentMode): способ развертывания ресурсов. Задайте значение Incremental. Добавочное сохранение ресурсов, не хранющихся в шаблоне ARM и выполняющихся быстрее , чем Complete. Validate Режим позволяет находить проблемы с шаблоном перед развертыванием.
```
variables:
  ARM_PASS: $(adminPass)

trigger:
- none

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: CopyFiles@2
  inputs:
    SourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'
    Contents: '**'
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

- task: AzureResourceManagerTemplateDeployment@3
  inputs:
    deploymentScope: 'Resource Group'
    azureResourceManagerConnection: '<your-resource-manager-connection>'
    subscriptionId: '<your-subscription-id>'
    action: 'Create Or Update Resource Group'
    resourceGroupName: 'ARMPipelinesLAMP-rg'
    location: '<your-closest-location>'
    templateLocation: 'Linked artifact'
    csmFile: '$(Build.ArtifactStagingDirectory)/azuredeploy.json'
    csmParametersFile: '$(Build.ArtifactStagingDirectory)/azuredeploy.parameters.json'
    overrideParameters: '-siteName $(siteName) -administratorLogin $(adminUser) -administratorLoginPassword $(ARM_PASS)'
    deploymentMode: 'Incremental'
```
Нажмите кнопку Сохранить и запустить , чтобы развернуть шаблон. Задание конвейера будет запущено, и через несколько минут, в зависимости от агента, в его состоянии должно быть указано Success.

Переменная	Значение	Секрет?
siteName	`mytestsite`	Нет
adminUser	`fabrikam`	Нет
adminPass	`Fqdn:5362!`	Да

Войдите в свою организацию Azure DevOps и откройте нужный проект. Создайте проект, если у вас его еще нет.
Перейдите в раздел Конвейеры и выберите Создать конвейер.
Выберите GitHub в качестве расположения исходного кода.

Примечание

Вы можете быть перенаправлены на GitHub для входа. Для этого введите учетные данные GitHub.
Когда появится список репозиториев, выберите yourname/azure-quickstart-templates/.

Примечание

Вы можете быть перенаправлены на сайт GitHub для установки приложения Azure Pipelines. В этом случае выберите Утвердить и установить.
Когда откроется вкладка Настройка, выберите Starter pipeline.
Замените содержимое конвейера следующим кодом:
```
trigger:
- none

pool:
  vmImage: $(vmImageName)
```
Создайте три переменные: siteName, administratorLoginи administratorLoginPassword. administratorLoginPassword должен быть секретной переменной.
- Выберите элемент Variables (Переменные).
- + Используйте знак , чтобы добавить три переменные. При создании adminPassвыберите Сохранить это значение в секрете.
- После завершения настройки нажмите Сохранить .
Переменная Значение Секрет?

siteName mytestsite Нет

administratorLogin fabrikam Нет

administratorLoginPassword Fqdn:5362! Да
В верхней части YAML-файла составьте значения для location и resourceGroupName. Ваше расположение должно быть расположением группы ресурсов. Группа ресурсов уже должна существовать.
```
variables:
  vmImageName: 'ubuntu-latest'
  resourceGroupName: '<resource-group-name>' # Needs to already exist
  location: '<your-closest-location>'
  templateFile: './main.bicep'
  sourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'
```
Если у вас еще нет подключения к службе Azure Resource Manager, создайте подключение к службе. Дополнительные сведения о подключении к Azure.
- Подключение службы будет находиться в той же группе ресурсов, что и .resourceGroupName

Переменная	Значение	Секрет?
siteName	`mytestsite`	Нет
administratorLogin	`fabrikam`	Нет
administratorLoginPassword	`Fqdn:5362!`	Да

Добавьте задачу Azure CLI для развертывания с помощью Bicep. Задача использует команду Azure CLI az deployment group create . Значения параметров и administratorLoginPassword будут передаваться administratorLogin в виде переменных.

Установите подключение azure Resource Manager к своей службе.
Тип скрипта — Оболочка.
Расположение скрипта — это встроенный скрипт.

variables:
  vmImageName: 'ubuntu-latest'
  resourceGroupName: '<resource-group-name>' # Needs to already exist
  location: '<your-closest-location>'
  templateFile: './main.bicep'
  sourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'

trigger:
- none

pool:
  vmImage: $(vmImageName)

name: Bicep deploy template

steps:
- task: AzureCLI@2
  inputs:
    azureSubscription: '<service-connection-name>'
    scriptType: bash
    scriptLocation: inlineScript
    inlineScript: |
      az deployment group create --resource-group $(resourceGroupName) --template-file $(sourceFolder)$(templateFile) \
      --parameters administratorLogin=$(administratorLogin) administratorLoginPassword=$(administratorLoginPassword)

Просмотр развернутых ресурсов

JSON
Bicep

Убедитесь, что ресурсы развернуты. Перейдите ARMPipelinesLAMP-rg к группе ресурсов в портал Azure и убедитесь, что отображаются ресурсы Служба приложений, план Служба приложений и сервер База данных Azure для MySQL.

Вы также можете проверить ресурсы с помощью Azure CLI.
```
az resource list --resource-group ARMPipelinesLAMP-rg --output table
```
Перейдите на новый сайт. Если задано значение siteNamearmpipelinetestsite, сайт находится по адресу https://armpipelinetestsite.azurewebsites.net/.

Убедитесь, что ресурсы развернуты. Перейдите в группу ресурсов в портал Azure и убедитесь, что отображаются ресурсы Служба приложений, план Служба приложений и сервер База данных Azure для MySQL.

Вы также можете проверить ресурсы с помощью Azure CLI.
```
az resource list --resource-group <resource-group-name> --output table
```
Перейдите на новый сайт. Если задано значение siteNamearmpipelinetestsite, сайт находится по адресу https://armpipelinetestsite.azurewebsites.net/.

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

JSON
Bicep

Вы также можете использовать шаблон ARM для удаления ресурсов. Измените action значение в задаче развертывания группы ресурсов Azure на DeleteRG. Можно также удалить входные данные для templateLocation, csmFile, csmParametersFile, overrideParametersи deploymentMode.

variables:
  ARM_PASS: $(adminPass)

trigger:
- none

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: CopyFiles@2
  inputs:
    SourceFolder: 'quickstarts/microsoft.web/webapp-linux-managed-mysql/'
    Contents: '**'
    TargetFolder: '$(Build.ArtifactStagingDirectory)'

- task: AzureResourceManagerTemplateDeployment@3
  inputs:
    deploymentScope: 'Resource Group'
    azureResourceManagerConnection: '<your-resource-manager-connection>'
    subscriptionId: '<your-subscription-id>'
    action: 'DeleteRG'
    resourceGroupName: 'ARMPipelinesLAMP-rg'
    location: ''<your-closest-location>'

Если развернутые ресурсы больше не нужны, удалите группу ресурсов.

az group delete -n  <resource-group-name>

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

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