使用 Azure Pipelines 将自定义容器部署到 Azure 应用服务

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

使用 Azure Pipelines，可以生成、测试 Web 应用并将其自动部署到 Linux 上的 Azure 应用服务 Web 应用容器。 本文介绍如何使用 YAML 或经典管道来执行以下操作：

• 生成 Docker 映像并将其发布到 Azure 容器注册表
• 创建 Azure Web 应用
• 将容器部署到 Azure 应用服务
• 部署到部署槽位

先决条件

• 具有活动订阅的 Azure 帐户。 免费创建帐户。
• 一个 GitHub 帐户。 创建一个免费的 GitHub 帐户（如果没有）。
• Azure DevOps 组织。 如果你没有组织，请创建一个组织。
• Azure 容器注册表。 创建 Azure 容器注册表（如果还没有）。

获取代码

在 GitHub 创建以下示例应用的分支。

Java

https://github.com/spring-guides/gs-spring-boot-docker.git

JavaScript

https://github.com/MicrosoftDocs/pipelines-javascript-docker

Python

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

.NET Core

https://github.com/MicrosoftDocs/pipelines-dotnet-core-docker

生成 Docker 映像并将其发布到 Azure 容器注册表

要成功完成本部分，必须具有 Azure 容器注册表。 有关详细信息，请参阅先决条件部分。

1. 登录到 Azure DevOps 组织，并导航到你的项目。

2. 选择“管道”，然后“新建管道”。

3. 当系统提示输入源代码的位置时，选择“GitHub”，然后选择存储库。

4. 选择“Docker: 生成映像并将其推送到 Azure 容器注册表”管道模板。

   

5. 选择你的 Azure 订阅，然后选择“继续”。

6. 从下拉菜单中选择“容器注册表”，然后选择“验证和配置”。

   

7. 查看管道 YAML 模板，然后选择“保存并运行”以生成 Docker 映像并将其发布到 Azure 容器注册表。

   trigger:
   - main
   
   resources:
   - repo: self
   
   variables:
       # Container registry service connection established during pipeline creation
       dockerRegistryServiceConnection: '{{ containerRegistryConnection.Id }}'
       imageRepository: 'javascriptdocker'
       containerRegistry: 'sampleappcontainerregistry.azurecr.io'
       dockerfilePath: '$(Build.SourcesDirectory)/app/Dockerfile'
       tag: '$(Build.BuildId)'
   
       # Agent VM image name
       vmImageName: 'ubuntu-latest'
   
   stages:
   - stage: Build
       displayName: Build and push stage
       jobs:
       - job: Build
       displayName: Build
       pool:
           vmImage: $(vmImageName)
       steps:
       - task: Docker@2
           displayName: Build and push an image to container registry
           inputs:
           command: buildAndPush
           repository: $(imageRepository)
           dockerfile: $(dockerfilePath)
           containerRegistry: $(dockerRegistryServiceConnection)
           tags: |
               $(tag)
   

8. 要在管道运行完成后查看已发布的 Docker 映像，请在 Azure 门户中导航到容器注册表，然后选择“存储库”。

   

9. 要从容器注册表部署映像，必须启用管理员用户帐户。 在 Azure 门户中导航到容器注册表，然后选择“访问密钥”。 接下来，选择“启用管理员用户”的切换按钮。

   

创建 Web 应用

1. 导航到 Azure 门户。

2. 选择“创建资源”>“容器”，然后选择“用于容器的 Web 应用”。

   

3. 输入新 Web 应用的名称，并创建新的资源组。 选择“Linux”作为“操作系统”。

   

4. 在“定价计划”部分中，选择“F1 免费计划”。

5. 选择“查看并创建”。 查看配置，完成后选择“创建”。

部署到用于容器的 Web 应用

YAML

在此 YAML 中，将生成 Docker 映像并将其推送到容器注册表，然后将其部署到用于容器的 Azure Web 应用。 在“生成”阶段，将使用 Docker@2 任务生成 Docker 映像并将其推送到 Azure 容器注册表。 AzureWebAppContainer@1 任务可将映像部署到用于容器的 Web 应用。

trigger:
- main

resources:
- repo: self

variables: 
  ## Add this under variables section in the pipeline
  azureSubscription: <Name of the Azure subscription>
  appName: <Name of the Web App>
  containerRegistry: <Name of the Azure container registry>
  dockerRegistryServiceConnection: '4fa4efbc-59af-4c0b-8637-1d5bf7f268fc'
  imageRepository: <Name of image repository>
  dockerfilePath: '$(Build.SourcesDirectory)/Dockerfile'
  tag: '$(Build.BuildId)'

  vmImageName: 'ubuntu-latest'

stages:
- stage: Build
  displayName: Build and push stage
  jobs:
  - job: Build
    displayName: Build
    pool:
      vmImage: $(vmImageName)
    steps:
    - task: Docker@2
      displayName: Build and push an image to container registry
      inputs:
        command: buildAndPush
        repository: $(imageRepository)
        dockerfile: $(dockerfilePath)
        containerRegistry: $(dockerRegistryServiceConnection)
        tags: |
          $(tag)


    ## Add the below snippet at the end of your pipeline
    - task: AzureWebAppContainer@1
      displayName: 'Azure Web App on Container Deploy'
      inputs:
        azureSubscription: $(azureSubscription)
        appName: $(appName)
        containers: $(containerRegistry)/$(imageRepository):$(tag)

经典

1. 在项目中，选择“管道”，然后选择“发布”。

2. 选择“新建管道”以创建新的发布管道。

3. 选择“Azure 应用服务部署”模板

   

4. 选择“任务”，然后选择在“阶段 1”中选择“全部取消链接”以取消链接所有管道参数。

   

5. 选择“部署 Azure 应用服务任务”，并填写必填字段。 完成后，选择“保存”。

   

6. 选择“创建发布”，然后从下拉菜单中选择“阶段 1”。 完成后，选择“创建”。

   

7. 将鼠标悬停在管道中的“阶段 1”上，然后选择“部署”以排队并启动部署。

   

8. 管道日志应类似于下面的屏幕截图。

   

9. 导航到新部署的 Web 应用以验证部署。

   

部署到部署槽位

YAML

可将 Azure Web 应用容器配置为具有多个槽。 通过槽，你可以安全地部署应用并对其进行测试，然后再将其提供给客户。 有关更多详细信息，请参阅创建过渡环境。

以下 YAML 代码片段演示如何部署到过渡槽，然后交换到生产槽：

- task: AzureWebAppContainer@1
  inputs:
    azureSubscription: '<Azure service connection>'
    appName: '<Name of the web app>'
    containers: $(containerRegistry)/$(imageRepository):$(tag)
    deployToSlotOrASE: true
    resourceGroupName: '<Name of the resource group>'
    slotName: staging

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

经典

可将用于容器的 Azure Web 应用配置为具有多个槽位。 通过槽，你可以安全地部署应用并对其进行测试，然后再将其提供给客户。 使用“Azure Web 应用容器”任务中的“部署到槽”选项指定要部署到的槽。 可以使用“Azure 应用服务管理”任务来交换槽。

常见问题解答

问：如何查找 Docker 注册表凭据？

答：导航到 Azure 门户，然后选择用于容器的 Web 应用。 选择“配置”>“应用程序设置” ，然后单击以显示值。

相关文章

• 部署到 Azure
• 使用 ARM 模板
• 定义和目标环境