Развертывание в Службе приложений с помощью Azure Pipelines

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

Примечание.

Начиная с 1 июня 2024 г. все созданные Служба приложений приложения будут иметь возможность создать уникальное имя узла по умолчанию с помощью соглашения <app-name>-<random-hash>.<region>.azurewebsites.netоб именовании. Существующие имена приложений останутся неизменными.

Пример: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Дополнительные сведения см. в разделе "Уникальное имя узла по умолчанию" для ресурса Служба приложений.

Используйте Azure Pipelines для автоматического развертывания веб-приложения для Службы приложений Azure при каждой успешной сборке. Azure Pipelines позволяет создавать, тестировать и развертывать ресурсы с использованием технологий непрерывной интеграции (CI) и непрерывной поставки (CD) в Azure DevOps.

Конвейеры YAML определяются с помощью YAML-файла в репозитории. Шаг является наименьшим стандартным блоком конвейера и может быть скриптом или задачей (предварительно упакованым скриптом). Узнайте о ключевых понятиях и компонентах, составляющих конвейер.

Вы будете использовать задачу веб-приложения Azure (AzureWebApp) для развертывания в службе приложение Azure в конвейере. Для более сложных сценариев, таких как использование XML-параметров в развертывании, можно использовать задачу развертывания службы приложение Azure (AzureRmWebAppDeployment).

Необходимые компоненты

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Организация Azure DevOps. Создайте ее бесплатно.
• Возможность запуска конвейеров на размещенных агентах Майкрософт. Вы можете приобрести параллельное задание или запросить уровень "Бесплатный".
• Работающее приложение Службы приложений Azure с кодом, размещенным на GitHub или в Azure Repos.
  • .NET: Создание веб-приложения ASP.NET Core в Azure.
  • ASP.NET: Создание веб-приложения ASP.NET Framework в Azure.
  • JavaScript: Создание веб-приложения Node.js в Службе приложений Azure.
  • Java: Создание приложения Java в Службе приложений Azure.
  • Python: Создание приложения Python в Службе приложений Azure.

1. Создание конвейера для стека

В примерах кода в этом разделе предполагается, что вы развертываете веб-приложение ASP.NET. Инструкции можно адаптировать для других платформ.

Узнайте больше о поддержке экосистемы Azure Pipelines.

YAML

1. Войдите в свою организацию Azure DevOps и откройте нужный проект.

2. Выберите Конвейеры, а затем — Новый конвейер.

3. При появлении запроса выберите расположение исходного кода: Azure Repos Git или GitHub.

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

4. Когда появится список репозиториев, выберите свой репозиторий.

5. Вы можете перенаправиться на GitHub, чтобы установить приложение Azure Pipelines. В этом случае выберите " Утвердить" и "Установить".

6. Когда появится вкладка Настройка, выберите на ней ASP.NET Core.

7. Когда появится новый конвейер, просмотрите YAML, чтобы узнать функциональность. Когда будете готовы, выберите Сохранить и запустить.

Классическое

Чтобы начать работу:

1. Создайте конвейер и выберите шаблон ASP.NET Core. При этом будут автоматически добавлены задачи, необходимые для сборки кода в примере репозитория.

2. Сохраните конвейер и добавьте сборку в очередь, чтобы увидеть ее в действии.

   Шаблон конвейера ASP.NET Core публикует ZIP-файл развертывания в качестве артефакта Azure для задачи развертывания позже.

2. Добавление задачи развертывания

YAML

1. Щелкните конец ФАЙЛА YAML, а затем выберите "Показать помощник".

2. Используйте помощник по задачам, чтобы добавить задачу веб-приложения Azure.

   

   Кроме того, можно добавить задачу развертывания службы приложение Azure (AzureRmWebAppDeployment).

3. Выберите подписку Azure. Обязательно авторизуйте подключение. Авторизация создает необходимое подключение к службе.

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

   variables:
     buildConfiguration: 'Release'
   
   steps:
   - task: DotNetCoreCLI@2
     inputs:
       command: 'publish'
       publishWebProjects: true
   - task: AzureWebApp@1
     inputs:
       azureSubscription: '<service-connection-name>'
       appType: 'webAppLinux'
       appName: '<app-name>'
       package: '$(System.DefaultWorkingDirectory)/**/*.zip'
   

   • azureSubscription: имя авторизованного подключения службы к подписке Azure.
   • appName: имя существующего приложения.
   • пакет: путь к пакету или папке, содержащей содержимое службы приложений. Поддерживаются подстановочные знаки.

Классическое

Чтобы начать работу:

1. Создайте конвейер выпуска, выбрав "Выпуски" в меню слева и выбрав "Создать конвейер".

2. Выберите шаблон развертывания службы приложение Azure для этапа. Необходимые задачи будут добавлены автоматически.

   Примечание.

   Если вы развертываете приложение Node.js для Служба приложений в Windows, выберите шаблон "Развернуть Node.js приложение для приложение Azure службы". Единственное различие между этими шаблонами заключается в том, что шаблон Node.js настраивает задачу для создания файла web.config, содержащего параметр, который запускает службу iisnode.

3. Чтобы связать этот конвейер выпуска с артефактом Azure на предыдущем шаге, выберите "Добавить сборку артефакта>".

4. В исходном (конвейере сборки) выберите конвейер сборки, созданный в предыдущем разделе, а затем нажмите кнопку "Добавить".

5. Сохраните конвейер выпуска и создайте выпуск, чтобы увидеть его в действии.

Пример. Развертывание приложения .NET

YAML

Чтобы развернуть веб-пакет .zip (например, из веб-приложения ASP.NET) в веб-приложении Azure, используйте следующий фрагмент кода для развертывания сборки в приложении.

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: 'webAppLinux'
    appName: '<app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'

• azureSubscription: ваша подписка Azure.
• appType: ваш тип веб-приложения.
• appName: имя существующей службы приложений.
• package: путь к файлу пакета или папке, содержащим содержимое службы приложений. Поддерживаются подстановочные знаки.

Классическое

Для классических конвейеров проще всего определить этапы сборки и выпуска на отдельных страницах (конвейеры и выпуски соответственно). Как правило, вы:

• На странице "Конвейеры" создайте и протестируйте приложение с помощью выбранного шаблона, например ASP.NET Core, Node.js с Grunt, Maven или другие, и опубликуйте артефакт.
• На странице выпуска используйте универсальный шаблон развертывания службы приложение Azure для развертывания артефакта.

Можно выбрать шаблоны для определенных языков программирования.

Пример: развертывание в виртуальном приложении

YAML

По умолчанию развертывание выполняется в корневое приложение в веб-приложении Azure. Вы можете развернуть в определенном виртуальном приложении с помощью VirtualApplication свойства задачи развертывания службы приложение Azure (AzureRmWebAppDeployment):

- task: AzureRmWebAppDeployment@4
  inputs:
    VirtualApplication: '<name of virtual application>'

• VirtualApplication: имя виртуального приложения, настроенного в портал Azure. Дополнительные сведения см. в разделе "Настройка приложения Служба приложений" в портал Azure.

Классическое

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

Пример. Развертывание в слоте

YAML

В примере ниже показано, как выполнить развертывание в промежуточном слоте, а затем переключиться на рабочий слот:

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: webAppLinux
    appName: '<app-name>'
    deployToSlotOrASE: true
    resourceGroupName: '<name of resource group>'
    slotName: staging
    package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: webAppLinux
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscription: ваша подписка Azure.
• appType: (необязательно) использовать webAppLinux для развертывания в веб-приложении в Linux.
• appName: имя существующей службы приложений.
• deployToSlotOrASE: логическое значение. Развертывание в существующем слоте развертывания или в среде Службы приложений Azure.
• resourceGroupName: имя группы ресурсов. Является обязательным, если параметр deployToSlotOrASE равен true.
• имя слота: имя слота, в котором по умолчанию используется productionзначение . Является обязательным, если параметр deployToSlotOrASE равен true.
• package: путь к файлу пакета или папке, содержащим содержимое службы приложений. Поддерживаются подстановочные знаки.
• SourceSlot: слот, отправляемый в рабочую среду, когда SwapWithProduction имеет значение true.
• SwapWithProduction: логическое значение. Переключить трафик исходного слота на рабочую среду.

Классическое

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

Пример. Развертывание в нескольких веб-приложениях

YAML

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

jobs:
- job: buildandtest
  pool:
    vmImage: ubuntu-latest
 
  steps:
  # publish an artifact called drop
  - task: PublishPipelineArtifact@1
    inputs:
      targetPath: '$(Build.ArtifactStagingDirectory)' 
      artifactName: drop
  
  # deploy to Azure Web App staging
  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<staging-app-name>'
      deployToSlotOrASE: true
      resourceGroupName: <group-name>
      slotName: 'staging'
      package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- job: deploy
  dependsOn: buildandtest
  condition: succeeded()

  pool: 
    vmImage: ubuntu-latest  
  
  steps:
    # download the artifact drop from the previous job
  - task: DownloadPipelineArtifact@2
    inputs:
      source: 'current'
      artifact: 'drop'
      path: '$(Pipeline.Workspace)'

  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<production-app-name>'
      resourceGroupName: <group-name>
      package: '$(Pipeline.Workspace)/**/*.zip'

Классическое

Если вы хотите выполнить развертывание в нескольких веб-приложениях, добавьте этапы в конвейер выпуска. Вы можете управлять порядком развертывания. Дополнительные сведения см. в статье Этапы.

Пример. Создание подстановок переменных

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

Но есть и другие причины, по которым вы хотите сделать подстановки переменных в конфигурацию Web.config. В этом примере файл конфигурации Web.config содержит строка подключения с именемconnectionString. Перед развертыванием в каждом веб-приложении можно изменить его значение. Это можно сделать, применив преобразование Web.config или заменив переменные в файле Web.config.

YAML

В следующем фрагменте кода показан пример подстановки переменных с помощью задачи развертывания службы приложение Azure (AzureRmWebAppDeployment).

jobs:
- job: test
  variables:
    connectionString: <test-stage connection string>
  steps:
  - task: AzureRmWebAppDeployment@4
    inputs:
      azureSubscription: '<Test stage Azure service connection>'
      WebAppName: '<name of test stage web app>'
      enableXmlVariableSubstitution: true

- job: prod
  dependsOn: test
  variables:
    connectionString: <prod-stage connection string>
  steps:
  - task: AzureRmWebAppDeployment@4
    inputs:
      azureSubscription: '<Prod stage Azure service connection>'
      WebAppName: '<name of prod stage web app>'
      enableXmlVariableSubstitution: true

Классическое

Чтобы изменить connectionString с помощью подстановки переменных:

1. Создайте конвейер выпуска с двумя этапами.
2. Свяжите артефакт выпуска со сборкой, которая создает веб-пакет.
3. Определите connectionString как переменную на каждом этапе. Задайте для соответствующее значение.
4. Выберите параметр подстановку переменных XML в разделе Преобразования файлов и параметры подстановки переменных для задачи развертывания Службы приложений Azure.

Пример: условное развертывание

YAML

Для этого в YAML можно использовать один из следующих методов:

• Выделите шаги развертывания в отдельное задание и добавьте условие в это задание.
• Добавьте условие к этапу.

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

- task: AzureWebApp@1
  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
  inputs:
    azureSubscription: '<service-connection-name>'
    appName: '<app-name>'

Дополнительные сведения об условиях приведены в статье Задание условий.

Классическое

В конвейере выпуска можно реализовать различные проверки и условия для управления развертыванием:

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

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

Пример: развертывание с помощью веб-развертывания

Задача развертывания службы приложение Azure (AzureRmWebAppDeployment) может развертываться для Служба приложений с помощью веб-развертывания.

YAML

trigger:
- main

pool:
  vmImage: windows-latest

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true
- task: AzureRmWebAppDeployment@4
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

Классическое

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

1. Перейдите на вкладку "Задачи", а затем выберите "Развернуть приложение Azure службу". Это AzureRmWebAppDeployment задача.

2. В диалоговом окне убедитесь, что для типа подключения задано значение Azure Resource Manager.

3. В диалоговом окне разверните узел "Дополнительные параметры развертывания" и выберите "Выбрать метод развертывания". Убедитесь, что веб-развертывание выбрано в качестве метода развертывания.

4. Сохраните конвейер выпуска.

Примечание.

AzureRmWebAppDeployment@3 При использовании и AzureRmWebAppDeployment@4 задач следует использовать тип подключения Azure Resource Manager или AzureRMпри развертывании с помощью веб-развертывания. В нем используются профили публикации для развертывания, если для приложения включена базовая проверка подлинности, но она использует более безопасную проверку подлинности идентификатора Записи при отключении базовой проверки подлинности.

Часто задаваемые вопросы

Какова разница между AzureWebApp задачами и AzureRmWebAppDeployment задачами?

Задача веб-приложения Azure (AzureWebApp) — это самый простой способ развертывания в веб-приложении Azure. По умолчанию развертывание выполняется в корневое приложение в веб-приложении Azure.

Задача развертывания службы приложение Azure (AzureRmWebAppDeployment) может обрабатывать дополнительные пользовательские сценарии, например:

• Измените параметры конфигурации в веб-пакетах и XML-файлах параметров.
• Развертывание с помощью веб-развертывания, если вы используете процесс развертывания IIS.
• Развертывание в виртуальных приложениях.
• Развертывание в других типах приложений, таких как приложения-контейнеры, приложения-функции, веб-задания или API и мобильные приложения.

Примечание.

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

Я получаю сообщение "Недопустимый Служба приложений пакет или путь к папке предоставлен".

В конвейерах YAML в зависимости от конвейера может возникнуть несоответствие между местом сохранения созданного веб-пакета и местом поиска задачи развертывания. Например, AzureWebApp задача выбирает веб-пакет для развертывания. Например, задача AzureWebApp выглядит в $(System.DefaultWorkingDirectory)/**/*.zip. Если веб-пакет помещается в другое место, измените значение package.

Я получаю сообщение "Публикация с помощью параметров webdeploy поддерживается только при использовании агента Windows".

Эта ошибка возникает в задаче AzureRmWebAppDeployment при настройке задачи для развертывания с помощью веб-развертывания, но агент не работает под управлением Windows. Убедитесь, что в YAML есть что-то подобное следующему коду:

pool:
  vmImage: windows-latest

Веб-развертывание не работает при отключении базовой проверки подлинности

Сведения об устранении неполадок при проверке подлинности идентификатора Microsoft Entra для работы с AzureRmWebAppDeployment задачей см. в статье "Не удается выполнить веб-развертывание в службе приложение Azure" с помощью проверки подлинности идентификатора Microsoft Entra из моего агента Windows

Следующие шаги

• Настройте конвейер Azure DevOps.