使用 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 项目 ”和“ Zip 已发布项目 ”复选框，然后选择“ 添加”。
7. 任务将显示在 YAML 管道中。 查看 YAML 代码以查看其用途。 准备就绪后，选择“ 保存并运行”，然后选择“ 保存并再次运行 ”。
8. 在“生成 摘要” 屏幕上的 “作业”下，选择 “所需的权限” 链接。 在“ 检查 ”屏幕上，选择“ 许可证”，然后再次选择“ 允许 ”。 在此处授予权限允许使用此管道的所有运行授权的服务连接。

1. 在 Azure DevOps 项目的左侧导航菜单中，选择 “管道”。
2. 在 “管道 ”页上，选择“ 新建管道”，如果此管道是项目中的第一个管道，则 选择“创建管道 ”。
3. 在 代码的“位置 ”屏幕上，选择“ 使用经典编辑器创建没有 YAML 的管道”。
4. 在 “选择存储库 ”屏幕上，选择源代码的位置（ Azure Repos Git 或 GitHub），然后选择代码 存储库 和 默认分支。 选择继续。
5. 在“ 选择模板 ”屏幕上，选择 “ASP.NET 核心”，然后选择“ 应用”。
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. 保存发布管道。