Развертывание в Службе приложений с помощью 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.

   

   Кроме того, можно добавить задачу развертывания службы приложение 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. Сохраните конвейер выпуска и создайте выпуск, чтобы увидеть его в действии.

Чтобы развернуть веб-пакет .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. Если вы хотите развернуть в определенном виртуальном приложении, введите его имя в свойстве виртуального приложения задачи развертывания службы приложение 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.
• имя слота: имя слота, в котором по умолчанию используется productionзначение . Является обязательным, если параметр deployToSlotOrASE равен true.
• package: путь к файлу пакета или папке, содержащим содержимое службы приложений. Поддерживаются подстановочные знаки.
• SourceSlot: слот, отправляемый в рабочую среду, когда SwapWithProduction имеет значение true.
• 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'

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

В следующем фрагменте кода показан пример подстановки переменных с помощью задачи развертывания службы приложение 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 можно использовать один из следующих методов:

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

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

- 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. Сохраните конвейер выпуска.