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

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 для задачи развертывания на следующем этапе.

1. Выберите конец YAML-файла и выберите "Показать помощник".

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

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

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: имя существующего приложения.
   • package: путь к пакету или папке, содержащей содержимое службы приложений. Поддерживаются подстановочные знаки.

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

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

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

   Примечание.

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

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

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

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

Чтобы развернуть веб-пакет .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, чтобы развернуть артефакт.

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

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

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

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

По умолчанию развертывание происходит с корневым приложением в веб-приложении Azure. Если вы хотите развернуть в определенное виртуальное приложение, введите его имя в свойство Виртуальное приложение задачи развертывания службы App Service 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>'
    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.
• slotName: имя слота, для которого используется значение productionпо умолчанию. Является обязательным, если параметр deployToSlotOrASE равен true.
• 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@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. Сохраните конвейер выпуска.