如何使Azure DevOps模板阶段的所有作业在Docker容器内运行

针对你需要让模板化阶段内所有作业在指定Docker容器运行的需求，以下是几种实用的实现方案：

方法1：阶段级别直接配置容器（最便捷） #

Azure DevOps支持在阶段层级定义container配置，该阶段下的所有作业会自动继承这个容器设置，无需修改内部模板（前提是模板作业未单独定义容器）。

示例修改后的主管道：

stages:
- template: stages/build-stage.yml  # 引用原阶段模板
  parameters:
    stageName: Build
    agentPool: 'Self-Hosted-VMSS-Pool'
  # 为整个阶段绑定容器配置
  container:
    image: 'your-acr-name.azurecr.io/your-image:tag'  # 私有ACR镜像地址
    endpoint: 'ACR-Service-Connection'  # 提前创建的ACR服务连接（用于镜像拉取认证）
    options: '--network host'  # 可选：Docker容器运行参数，如网络模式、挂载目录等

方法2：修改作业模板，通过参数传递容器配置 #

如果阶段模板内的作业是通过子模板引用的，可以给作业模板添加容器相关参数，实现统一配置。

步骤1：更新作业模板（如jobs/build-job.yml） #

parameters:
  jobName: ''
  containerImage: ''
  containerEndpoint: ''

jobs:
- job: ${{ parameters.jobName }}
  pool:
    name: 'Self-Hosted-VMSS-Pool'
  # 新增容器配置，通过参数注入
  container:
    image: ${{ parameters.containerImage }}
    endpoint: ${{ parameters.containerEndpoint }}
  steps:
  - script: echo "执行作业逻辑"

步骤2：更新阶段模板（如stages/build-stage.yml） #

parameters:
  stageName: ''
  containerImage: ''
  containerEndpoint: ''

stages:
- stage: ${{ parameters.stageName }}
  jobs:
  - template: ../jobs/build-job.yml
    parameters:
      jobName: BuildApp
      containerImage: ${{ parameters.containerImage }}
      containerEndpoint: ${{ parameters.containerEndpoint }}
  - template: ../jobs/build-job.yml
    parameters:
      jobName: RunTests
      containerImage: ${{ parameters.containerImage }}
      containerEndpoint: ${{ parameters.containerEndpoint }}

步骤3：主管道调用 #

stages:
- template: stages/build-stage.yml
  parameters:
    stageName: Build
    containerImage: 'your-acr-name.azurecr.io/your-image:tag'
    containerEndpoint: 'ACR-Service-Connection'

方法3：全局变量统一管理容器配置 #

若多个阶段需使用相同容器，可通过全局变量统一定义，避免重复配置。

主管道：

variables:
  containerImage: 'your-acr-name.azurecr.io/your-image:tag'
  containerEndpoint: 'ACR-Service-Connection'

stages:
- template: stages/build-stage.yml
  parameters:
    stageName: Build
    agentPool: 'Self-Hosted-VMSS-Pool'

阶段模板内的作业直接引用变量：

# stages/build-stage.yml
parameters:
  stageName: ''
  agentPool: ''

stages:
- stage: ${{ parameters.stageName }}
  jobs:
  - job: BuildApp
    pool:
      name: ${{ parameters.agentPool }}
    container:
      image: $(containerImage)
      endpoint: $(containerEndpoint)
    steps:
    - script: echo "构建应用"
  - job: RunTests
    pool:
      name: ${{ parameters.agentPool }}
    container:
      image: $(containerImage)
      endpoint: $(containerEndpoint)
    steps:
    - script: echo "运行测试"

关键注意事项 #

• ACR服务连接：必须提前在Azure DevOps中创建类型为Docker Registry的服务连接，配置私有ACR的认证凭据（服务主体或管理员账户），确保自托管代理能拉取私有镜像。
• 容器环境完整性：确保镜像包含作业所需的所有工具（如编译器、运行时等），若需挂载主机资源，可在options中添加-v /host/path:/container/path参数。
• 优先级规则：若模板内的作业单独定义了container配置，会覆盖阶段级或全局的配置，需确保模板作业未单独设置容器。

内容的提问来源于stack exchange，提问作者E. Erfan