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

Определите конвейер, создав azure-pipelines.yml YAML-файл в репозитории кода.

1. В меню навигации слева для проекта Azure DevOps выберите Pipelines.
2. На странице "Конвейеры" выберите "Создать конвейер" или "Создать конвейер ", если этот конвейер является первым в проекте.
3. На экране "Где находится код " выберите расположение исходного кода Azure Repos Git или GitHub. При необходимости войдите в GitHub.
4. На экране "Выбор репозитория" выберите репозиторий кода.
5. На экране "Настройка конвейера" выберите "Начальный конвейер".

Добавьте задачу .NET Core (DotNetCoreCLI@2) в конвейер и создайте и опубликуйте приложение.

1. На экране проверки конвейера YAML удалите весь код после steps: строки.
2. Выберите конец файла и нажмите кнопку "Показать помощника " справа.
3. В разделе "Задачи" выберите .NET Core.
4. На экране конфигурации .NET Core в разделе подключения Azure Resource Manager выберите подписку Azure, а затем нажмите кнопку "Авторизовать ", чтобы создать необходимое подключение к службе.
5. В разделе "Команда" выберите "Опубликовать".
6. Установите флажки " Опубликовать веб-проекты " и " Zip-опубликованные проекты " и нажмите кнопку "Добавить".
7. Задача появится в конвейере YAML. Просмотрите код YAML, чтобы узнать, что это делает. Когда вы будете готовы, нажмите кнопку "Сохранить и запустить", а затем нажмите кнопку "Сохранить и снова запустить ".
8. На экране "Сводка сборки" в разделе "Задания" выберите нужную ссылку "Разрешение ". На экране "Проверки " выберите "Разрешить" и снова нажмите кнопку "Разрешить ". Предоставление разрешения здесь позволяет использовать подключение службы, авторизованное для всех запусков этого конвейера.

1. В меню навигации слева для проекта Azure DevOps выберите Pipelines.
2. На странице "Конвейеры" выберите "Создать конвейер" или "Создать конвейер ", если этот конвейер является первым в проекте.
3. На экране " Где находится код " выберите " Использовать классический редактор", чтобы создать конвейер без YAML.
4. На экране "Выбор репозитория " выберите расположение исходного кода Azure Repos Git или GitHub, а затем выберите репозиторий кода и ветвь по умолчанию. Нажмите Продолжить.
5. На экране "Выбор шаблона " выберите ASP.NET Core и нажмите кнопку "Применить".
6. На новом экране конвейера в разделе Спецификация агента справа выберите спецификацию агента , например ubuntu-latest или windows-latest в зависимости от платформы и версии приложения.
7. Посмотрите на конвейер, чтобы узнать, что это делает. Когда вы будете готовы, нажмите кнопку "Сохранить" и "Сохранить".
8. Нажмите кнопку "Сохранить и снова" и на экране "Запуск конвейера " нажмите кнопку "Сохранить и запустить".

1. На экране запуска конвейера выберите значок "Дополнительные действия " в правом верхнем углу и нажмите кнопку "Изменить конвейер".
2. Выберите конец ФАЙЛА YAML и выберите "Показать помощник ", если список задач не отображается.
3. В списке задач найдите и выберите задачу веб-приложения Azure . Кроме того, можно использовать задачу развертывания службы приложений Azure .
4. На экране конфигурации веб-приложения Azure в подписке Azure выберите то же подключение службы, которое вы настроили для предыдущего шага. Вам не нужно повторно выполнять проверку подлинности этого подключения.
5. Для типа приложения выберите веб-приложение Azure в Linux или веб-приложении Azure в Windows в зависимости от кода.
6. В поле "Имя приложения" выберите или введите имя приложения службы приложений.
7. Нажмите кнопку "Добавить".
8. Выберите "Проверить и сохранить", а затем нажмите кнопку "Сохранить".
9. Нажмите кнопку "Выполнить", а затем снова нажмите кнопку "Выполнить ".

Полный конвейер YAML должен выглядеть следующим образом:

trigger:
- <branch-specification>

pool:
  vmImage: <agent-specification>

steps:
- task: DotNetCoreCLI@2
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    command: 'publish'
    publishWebProjects: true

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    appType: 'webApp'
    appName: '<your-app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    deploymentMethod: 'auto'  

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

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

1. В меню навигации слева для проекта выберите "Конвейеры выпусков>", а затем выберите новый конвейер, чтобы создать конвейер выпуска.

2. В разделе "Выбор шаблона" выберите шаблонразвертывания Службы приложений Azure и нажмите кнопку "Применить". Этот шаблон автоматически добавляет необходимые задачи.

   Примечание.

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

3. На странице "Создать конвейер выпуска" выберите вкладку "Задачи", выберите этап 1 и заполните следующие поля в разделе "Параметры".

   • Подписка Azure. Если у вас еще нет подключения к службе Azure, выберите подписку Azure и выберите "Авторизовать ", чтобы создать необходимое подключение к службе.
   • Тип приложения: выберите веб-приложение Azure в Linux или веб-приложении Azure в Windows, чтобы соответствовать спецификации кода и агента.
   • Имя службы приложений: выберите приложение службы приложений.

4. На вкладке конвейеранового конвейера выпуска рядом с артефактами нажмите кнопку "Добавить".

5. На экране "Добавление артефакта" убедитесь, что выбрана сборка и в разделе "Источник" (конвейер сборки) выберите конвейер, созданный в предыдущем разделе.

6. Нажмите кнопку "Добавить".

7. На странице конвейера нажмите кнопку "Сохранить в правом верхнем углу" и нажмите кнопку "ОК".

8. Чтобы запустить конвейер, на странице конвейера выберите "Создать выпуск" и нажмите кнопку "Создать".

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

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

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

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

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

- 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>'
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

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

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

Вы можете использовать задания в файле 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'

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

Чтобы выполнить условное развертывание в YAML, используйте один из следующих методов:

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

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

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

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

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

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

Дополнительные сведения см. в следующих статьях:

• Классические триггеры выпуска
• Управление развертыванием с помощью утверждений
• Основные понятия шлюзов развертывания

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@5
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

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

1. Перейдите на вкладку "Задачи " и выберите " Развернуть службу приложений Azure", задачу развертывания службы приложений Azure .
2. На экране конфигурации убедитесь, что для типа подключениязадано значение Azure Resource Manager.
3. Разверните дополнительные параметры развертывания и выберите "Выбрать метод развертывания". Убедитесь, что веб-развертывание выбрано в качестве метода развертывания.
4. Сохраните конвейер выпуска.