如何通过部署作业定位 Azure YAML 管道中的环境?

Rem*_*men 6 continuous-integration yaml continuous-deployment azure-devops azure-pipelines

目标

使用部署作业通过 Azure YAML 将管道工件部署到环境中的 VM 资源。

YAML

这是我正在使用的完整 YAML 管道。使用这个 YAML 文件,我希望实现以下目标。

  1. 建造
  2. 测试
  3. 发布工件
  4. 将工件部署到 RO-TST 环境中的资源(本地虚拟机)

# CI/CD Pipeline
# https://docs.microsoft.com/azure/devops/pipelines/apps/windows/dot-net

trigger:
- master

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

stages:

- stage: BuildTestPublishArtifact
  displayName: Build - Test - Publish Artifact
  jobs:
  - job: Build
    steps:
    - task: NuGetToolInstaller@1
    - task: NuGetCommand@2
      inputs:
        restoreSolution: '$(solution)'
    - task: VSBuild@1
      inputs:
        solution: '$(solution)'
        platform: '$(buildPlatform)'
        configuration: '$(buildConfiguration)'
    - task: VSTest@2
      inputs:
        platform: '$(buildPlatform)'
        configuration: '$(buildConfiguration)'
    - task: PublishPipelineArtifact@1
      inputs:
        targetPath: '$(System.DefaultWorkingDirectory)\HelloWorld\HelloWorld\bin\$(buildConfiguration)'
        artifact: 'HelloWorld'
        publishLocation: 'pipeline'

- stage: DeployTst
  displayName: Deploy to TST
  jobs:
  - deployment: Deployment
    environment: RO-TST
    strategy:
      runOnce:
        deploy:
          steps:
          - task: CopyFiles@2
            inputs:
              SourceFolder: '$(Pipeline.Workspace)'
              Contents: '**'
              TargetFolder: 'D:\Application\'
Run Code Online (Sandbox Code Playgroud)

结果

步骤 1 到 3 工作得很好。在步骤 4(部署作业)中,复制文件任务未在 RO-TST 环境中注册的资源代理上运行。但是复制文件任务在托管代理上运行。

作业初始化:

Starting: Initialize job
Agent name: 'Hosted Agent'
Agent machine name: 'fv-az686'
Current agent version: '2.168.2'
Operating System
Virtual Environment
Current image version: '20200517.1'
Agent running as: 'VssAdministrator'
Prepare build directory.
Set build variables.
Download all required tasks.
Downloading task: DownloadPipelineArtifact (1.2.4)
Downloading task: CopyFiles (2.164.0)
Downloading task: CmdLine (2.164.0)
Checking job knob settings.
   Knob: AgentToolsDirectory = C:/hostedtoolcache/windows Source: ${AGENT_TOOLSDIRECTORY} 
   Knob: AgentPerflog = c:\vsts\perflog Source: ${VSTS_AGENT_PERFLOG} 
Finished checking job knob settings.
Start tracking orphan processes.
Finishing: Initialize job
Run Code Online (Sandbox Code Playgroud)

当我以环境中的特定资源 (RO-TST.APP1234) 为目标时,复制文件任务确实在资源代理上运行。这是通过将部署作业中的环境值更改为 RO-TST.APP1234 来完成的。

- stage: DeployTst
  displayName: Deploy to TST
  jobs:
  - deployment: Deployment
    environment: RO-TST.APP1234
    strategy:
      runOnce:
        deploy:
          steps:
          - task: CopyFiles@2
            inputs:
              SourceFolder: '$(Pipeline.Workspace)'
              Contents: '**'
              TargetFolder: 'D:\Application\'
Run Code Online (Sandbox Code Playgroud)

作业初始化:

Starting: Initialize job
Agent name: 'APP1234'
Agent machine name: 'APP1234'
Current agent version: '2.168.2'
Agent running as: 'APP1234$'
Prepare build directory.
Set build variables.
Download all required tasks.
Checking job knob settings.
Finished checking job knob settings.
Start tracking orphan processes.
Finishing: Initialize job
Run Code Online (Sandbox Code Playgroud)

我尝试过其他部署策略,如滚动和金丝雀,但它们不适用于环境范围的目标。在 Microsoft 有关部署作业的文档下方。

https://docs.microsoft.com/en-us/azure/devops/pipelines/process/deployment-jobs?view=azure-devops

我知道您可以通过“经典”方法使用部署组,通过 Azure DevOps 中的发布将 CI 通过 YAML 和 CD 分开。但我真的很想在一个 YAML 文件中拥有完整的 CI-CD 管道。那么我是否在部署作业的设置方式中遗漏了一些东西,或者是不可能通过环境在 YAML 中定位多个资源?

Rem*_*men 6

所以我终于找到了为什么我的 YAML 不能用于部署工作。感谢 VM 资源文档中给出的示例。

https://docs.microsoft.com/en-us/azure/devops/pipelines/process/environments-virtual-machines?view=azure-devops#reference-vm-resources-in-pipelines

这是修改后的 YAML,我在其中添加了属性名称、资源类型和标签。我的环境资源上已经有了标签,所以效果很好。运行管道后,工件通过标签控制台部署到 RO-TST 中的所有资源。

- stage: DeployTst
  displayName: Deploy to TST
  jobs:
  - deployment: Deployment
    environment: 
      name: RO-TST
      resourceType: VirtualMachine
      tags: Console
    strategy:
      runOnce:
        deploy:
          steps:
          - task: CopyFiles@2
            inputs:
              SourceFolder: '$(Pipeline.Workspace)'
              Contents: '**'
              TargetFolder: 'D:\Application\'
Run Code Online (Sandbox Code Playgroud)

  • @HughLin-MSFT,yaml 管道的文档质量需要提高。 (2认同)