使用 Azure Pipelines 将应用程序部署到 Azure 应用服务

通过在代码存储库中创建 azure-pipelines.yml YAML 文件来定义管道。

1. 在 Azure DevOps 项目的左侧导航菜单中，选择“管道”。
2. 在“管道”页上，选择“新建管道”，如果此管道是项目中的第一个管道，则选择“创建管道”。
3. 在“代码位置”屏幕上，选择源代码的位置（Azure Repos Git 或 GitHub）。 如有必要，请登录到 GitHub。
4. 在“选择存储库”屏幕上，选择代码存储库。
5. 在 “配置管道 ”屏幕上，选择 “初学者管道”。

将 .NET Core (DotNetCoreCLI@2) 任务添加到管道，并生成和发布应用。

1. 在“查看管道 YAML”屏幕上，删除行 steps: 后的所有代码。
2. 选择文件的末尾，然后选择右侧的“显示助手”。
3. 在“任务”下，选择“.NET Core”。
4. 在 .NET Core 配置屏幕上的“Azure 资源管理器连接”下，选择 Azure 订阅，然后选择“授权”以创建所需的服务连接。
5. 在“命令”下，选择“发布”。
6. 确保选中“发布 Web 项目”和“压缩已发布项目”复选框，然后选择“添加”。
7. 任务将显示在 YAML 管道中。 查看 YAML 代码以查看其用途。 准备就绪后，选择“保存并运行”，然后再次选择“保存并运行”。
8. 在“生成摘要”屏幕上的“作业”下，选择“所需的权限”链接。 在“检查”屏幕上，选择“允许”，然后再次选择“允许”。 在此处授予权限允许使用为此管道的所有运行授权的服务连接。

1. 在 Azure DevOps 项目的左侧导航菜单中，选择“管道”。
2. 在“管道”页上，选择“新建管道”，如果此管道是项目中的第一个管道，则选择“创建管道”。
3. 在“代码位置”屏幕上，选择“在没有 YAML 的情况下使用经典编辑器创建管道”。
4. 在“选择存储库”屏幕上，选择源代码的位置（Azure Repos Git 或 GitHub），然后选择代码存储库和默认分支。 选择继续。
5. 在“选择模板”屏幕上，选择“ASP.NET Core”，然后选择“应用”。
6. 在新管道屏幕上，在右侧的“代理规范”下，根据应用平台和版本选择代理规范（例如 ubuntu-latest 或 windows-latest）。
7. 查看管道以了解其功能。 准备就绪后，选择“保存并排队”。
8. 再次选择“保存并排队”，然后在“运行管道”屏幕上，选择“保存并运行”。

1. 在管道运行“摘要”屏幕上，选择右上角的“更多操作”图标，然后选择“编辑管道”。
2. 选择 YAML 文件的末尾，如果未显示“任务”列表，则选择“显示助手”。
3. 在“任务”列表中，搜索并选择 Azure Web 应用任务。 或者，可以使用 Azure 应用服务部署任务。
4. 在 Azure Web 应用配置屏幕上的“Azure 订阅”下，选择为上一步设置的相同服务连接。 无需重新授权此连接。
5. 对于“应用类型”，请选择“Linux 上的 Azure Web 应用”或“Windows 上的 Azure Web 应用”，具体取决于代码。
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 应用服务”模板。 此模板配置任务以生成包含启动 iisnode 服务的参数的 web.config 文件。

3. 在“新建发布管道”页上，选择“任务”选项卡，选择“阶段 1”，然后在“参数”下完成以下字段：

   • Azure 订阅：如果还没有 Azure 服务连接，请选择 Azure 订阅，然后选择“授权”以创建所需的服务连接。
   • 应用类型：选择“Linux 上的 Azure Web 应用”或“Windows 上的 Azure Web 应用”，以匹配代码和代理规范。
   • 应用服务名称：选择应用服务应用。

4. 在“新建发布管道”屏幕的“管道”选项卡上，选择“项目”旁边的“添加”。

5. 在“添加项目”屏幕上，确保已选择“生成”，然后在“源(生成管道)”下，选择在上一部分中创建的管道。

6. 选择 并添加。

7. 在管道页上，选择右上角的“保存”，然后选择“确定”。

8. 要运行管道，请在管道页上选择“创建发布”，然后选择“创建”。

Azure Web 应用任务部署到 Azure Web 应用中的根应用程序。 可以使用 Azure 应用服务部署任务的 VirtualApplication 属性部署到特定虚拟应用程序。

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

VirtualApplication 是 Azure 门户中配置的虚拟应用程序的名称。 有关详细信息，请参阅在 Azure 门户中配置应用服务应用。

Azure Web 应用任务部署到 Azure Web 应用中的根应用程序。 要部署到特定虚拟应用程序，请在 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 上的 Web 应用。
• appName：现有应用的名称。
• deployToSlotOrASE：Boolean。 是部署到现有部署槽位还是应用服务环境。
• resourceGroupName：要部署到的资源组的名称（如果 deployToSlotOrASE 为 true 则是必需的）。
• slotName：要部署到的槽的名称（如果 deployToSlotOrASE 为 true 则是必需的）。 默认为 production。
• package：包含应用内容的包或文件夹的文件路径。 支持通配符。
• SourceSlot：当 SwapWithProduction 为 true 时发送到生产环节的槽。
• SwapWithProduction：Boolean。 是否将源槽的流量与生产交换。

使用“Azure Web 应用”任务中的选项“部署到槽或应用服务环境”来指定要部署到的槽。 要交换槽，请使用“Azure 应用服务管理”任务。

可以使用 YAML 文件中的作业来设置部署管道。 使用作业可以控制部署到多个 Web 应用时所遵循的顺序。

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 应用，请将阶段添加到发布管道。 可以控制部署顺序。 有关详细信息，请参阅阶段。

要在 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 应用服务部署”模板，请按照以下步骤部署到 Web 部署。

1. 选择“任务”选项卡，然后选择“部署 Azure 应用服务”和“Azure 应用服务部署”任务。
2. 在配置屏幕上，确保“连接类型”设置为“Azure 资源管理器”。
3. 展开“其他部署选项”，然后选择“选择部署方法”。 确保已选择“Web 部署”作为部署方法。
4. 保存发布管道。