rpindadoo/azure-devops-windows-agent-pipeline

Azure DevOps自托管Windows代理镜像

概述

本镜像用于在Azure DevOps中部署自托管Windows代理，允许用户在自有环境中运行Azure DevOps Pipeline任务。自托管代理适用于需要控制执行环境、满足特定网络隔离要求或依赖特定Windows软件的场景，提供更灵活的CI/CD任务执行能力。

核心功能与特性

• Windows环境支持：基于Windows操作系统，兼容Windows特定的构建、测试和部署工具链
• Azure DevOps集成：无缝对接Azure DevOps组织，支持Pipeline任务调度与执行
• 可定制配置：支持通过环境变量自定义代理名称、工作目录、标签等参数
• 多任务支持：兼容构建、测试、部署等各类Azure DevOps Pipeline任务
• 持久化执行：容器运行期间保持代理在线，支持长时间任务执行

使用场景与适用范围

• 企业内部网络环境：在企业防火墙内部署，避免公共代理的网络限制
• 特定软件依赖：需要使用未预安装在微软托管代理中的Windows软件或工具
• 数据安全合规：满足数据处理必须在本地环境执行的合规要求
• 自定义网络配置：需要访问内部资源或特定网络环境的部署任务
• 资源密集型任务：利用本地硬件资源执行高CPU/内存需求的构建或测试任务

使用方法

前置条件

1. 已安装支持Windows容器的Docker环境
2. 拥有Azure DevOps组织和项目访问权限
3. 已创建Azure DevOps个人访问令牌（PAT），需包含Agent Pools (Read & manage)权限

获取镜像

bash
docker pull mcr.microsoft.com/azure-pipelines/vsts-agent:windows-ltsc2022

运行容器

使用以下命令启动自托管Windows代理容器：

bash
docker run -d --name azure-devops-agent `
  -e AZP_URL="https://dev.azure.com/你的组织名称" `
  -e AZP_TOKEN="你的个人访问令牌" `
  -e AZP_AGENT_NAME="自定义代理名称" `
  -e AZP_POOL="代理池名称" `
  -v c:\agent\_work:c:\agent\_work `
  mcr.microsoft.com/azure-pipelines/vsts-agent:windows-ltsc2022

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  azure-devops-agent:
    image: mcr.microsoft.com/azure-pipelines/vsts-agent:windows-ltsc2022
    container_name: azure-devops-agent
    restart: always
    environment:
      - AZP_URL=https://dev.azure.com/你的组织名称
      - AZP_TOKEN=你的个人访问令牌
      - AZP_AGENT_NAME=自定义代理名称
      - AZP_POOL=默认代理池
      - AZP_WORK=_work
    volumes:
      - c:\agent\_work:c:\agent\_work

启动容器：

bash
docker-compose up -d

配置参数说明

环境变量

数据持久化

通过挂载卷c:\agent\_work可持久化代理工作目录，避免容器重启后任务数据丢失。

注意事项

• 确保Docker服务以管理员权限运行，且已启用Windows容器功能
• 个人访问令牌（PAT）需定期更新，过期会导致代理无法连接Azure DevOps
• 如需使用特定工具，可基于本镜像构建自定义镜像并预装所需软件
• 代理容器运行期间需保持网络连接，断开连接会导致任务执行失败