lambda3/azure-pipelines-agent

Azure Pipelines Agent Docker镜像

本仓库包含https://github.com/lambda3/docker-azure-pipelines-agent%E7%9A%84%60Dockerfile%60%E5%AE%9A%E4%B9%89%E3%80%82%E8%AF%A5%E9%A1%B9%E7%9B%AE%E5%85%81%E8%AE%B8Azure Pipelines代理在Docker或Kubernetes（通过Helm）上运行。

https://github.com/lambda3/docker-azure-pipelines-agent/actions/workflows/build.yml/badge.svg?branch=main](https://github.com/Lambda3/docker-azure-pipelines-agent/actions/workflows/build.yml)

支持的标签

• https://github.com/lambda3/docker-azure-pipelines-agent/blob/master/agent/Dockerfile
• https://github.com/lambda3/docker-azure-pipelines-agent/blob/master/agent-docker/Dockerfile

配置说明

latest标签

需设置以下环境变量：

• AGENT_PAT - Azure Pipelines的个人访问令牌。必填项。有关创建PAT的说明，请参见Microsoft文档。
• VS_TENANT - Azure Pipelines租户，即.visualstudio.com前的部分，例如在foo.visualstudio.com中应为foo。必填项。
• AGENT_POOL - 代理池。可选项，默认值为Default。

docker标签

可通过以下额外变量进行预定义登录（但不建议使用，详见变量后的免责声明）：

• DOCKER_USERNAME - Docker用户名。可选项，无默认值。
• DOCKER_PASSWORD - Docker密码。可选项，无默认值。
• DOCKER_SERVER - Docker registry地址，默认为Docker公共registry。可选项。

若未指定Docker用户名和密码，代理将不会登录。

免责声明：设置上述变量会使代理永久连接到Docker registry。建议使用Docker任务并通过Docker registry服务连接提供认证，这将使代理能够与多个registry配合工作并降低***风险。

使用方法

标签选择指南

• 使用latest标签获取最新版本代理
• 使用特定版本标签（如2.154.3）运行指定版本，但旧代理通常会自动更新
• 使用docker标签使代理使用主机的Docker引擎
• 使用特定版本+-docker标签（如2.154.3-docker）运行指定版本，但旧代理通常会自动更新

避免使用docker标签，建议将Docker引擎部署在单独的主机上。

Kubernetes部署（使用Helm Chart）

详见https://github.com/Lambda3/helmcharts/blob/master/charts/azure-pipelines-agent/README.md%E3%80%82

Docker部署

基础部署（latest标签）

Linux或Mac（使用Docker for Mac，bash环境）：

设置环境变量：

bash
export VS_TENANT=<yourtenantname>
export AGENT_PAT=<yourpat>

运行容器：

bash
docker run --name azure-pipelines-agent -ti -e VS_TENANT=$VS_TENANT -e AGENT_PAT=$AGENT_PAT -d -v /agent/_works:/agent/_works lambda3/azure-pipelines-agent:latest

Windows（使用Docker for Windows，PowerShell环境）：

设置环境变量：

powershell
$env:VS_TENANT=<yourtenantname>
$env:AGENT_PAT=<yourpat>

运行容器：

powershell
docker run --name azure-pipelines-agent -ti -e VS_TENANT=$env:VS_TENANT -e AGENT_PAT=$env:AGENT_PAT -d lambda3/azure-pipelines-agent:latest

重要提示：若使用Docker容器构建，需注意卷挂载会挂载到Docker主机而非代理文件系统。为确保代理正常工作，建议将/agent/_works从主机挂载到代理容器，添加-v /agent/_works:/agent/_works参数。这将使代理暂存目录（及其他工作目录）在代理重启后保持持久化。同时，建议挂载到与此目录相关的路径（如暂存目录），以便在主机上挂载后也能被代理访问。

带Docker支持的部署（docker标签）

注意：不推荐此方式，详见前文说明。需使用docker标签。

Linux或Mac（bash环境）：

设置环境变量：

bash
export VS_TENANT=<yourtenantname>
export AGENT_PAT=<yourpat>
export DOCKER_USERNAME=<yourdockerusername>
export DOCKER_PASSWORD=<yourdockerpassword>
export DOCKER_SERVER=<dockerserver>

运行容器：

bash
docker run --name azure-pipelines-agent -ti -e VS_TENANT=$VS_TENANT -e AGENT_PAT=$AGENT_PAT -e DOCKER_USERNAME=$DOCKER_USERNAME -e DOCKER_PASSWORD=$DOCKER_PASSWORD -e DOCKER_SERVER=$DOCKER_SERVER -d --volume=/var/run/docker.sock:/var/run/docker.sock -v /agent/_works:/agent/_works lambda3/azure-pipelines-agent:docker

Windows（PowerShell环境）：

设置环境变量：

powershell
$env:VS_TENANT=<yourtenantname>
$env:AGENT_PAT=<yourpat>
$env:DOCKER_USERNAME=<yourdockerusername>
$env:DOCKER_PASSWORD=<yourdockerpassword>
$env:DOCKER_SERVER=<dockerserver>

运行容器：

powershell
docker run --name azure-pipelines-agent -ti -e VS_TENANT=$env:VS_TENANT -e AGENT_PAT=$env:AGENT_PAT -e DOCKER_USERNAME=$env:DOCKER_USERNAME -e DOCKER_PASSWORD=$env:DOCKER_PASSWORD -e DOCKER_SERVER=$env:DOCKER_SERVER -d --volume=/var/run/docker.sock:/var/run/docker.sock lambda3/azure-pipelines-agent:docker

已安装软件

基于最新LTS Ubuntu镜像，包含以下额外软件包：

• apt-transport-https
• build-essential
• curl
• gdebi-core
• git
• iproute2
• iputils-ping
• libicu60
• libssl-dev
• libunwind8
• libuuid1
• python
• python-pip
• python3
• python3-pip
• software-properties-common
• sudo
• unzip
• vim
• wget
• zip

以及：

• .NET Core（当前版本和最新LTS版本）
• Azure CLI
• PowerShell Core（pwsh - 最新稳定版）
• Node（最新LTS版本）及nvm、Npm和Yarn
• Google Chrome
• kubectl
• Helm CLI
• Terraform CLI
• OpenJDK（最新LTS版本）
• Docker CLI
• docker-compose

更多信息详见https://github.com/lambda3/docker-azure-pipelines-agent/blob/master/agent/Dockerfile%E3%80%82

维护者

• Giovanni Bassi，又名Giggio，来自Lambda3，@giovannibassi

许可证

本软件开源，采用Apache License 2.0许可。详见https://github.com/lambda3/azure-pipelines-agent/blob/master/LICENSE.txt%E3%80%82%E5%9C%A8%E8%B4%A1%E7%8C%AE%E3%80%81%E5%88%86%E5%8F%89%E3%80%81%E5%A4%8D%E5%88%B6%E6%88%96%E5%AF%B9%E4%BB%A3%E7%A0%81%E8%BF%9B%E8%A1%8C%E4%BB%BB%E4%BD%95%E6%93%8D%E4%BD%9C%E5%89%8D%EF%BC%8C%E8%AF%B7%E6%9F%A5%E7%9C%8B%E8%AE%B8%E5%8F%AF%E6%9D%A1%E6%AC%BE%E3%80%82%E8%8B%A5%E6%82%A8%E5%86%B3%E5%AE%9A%E8%B4%A1%E7%8C%AE%EF%BC%8C%E5%8D%B3%E8%A1%A8%E7%A4%BA%E5%90%8C%E6%84%8F%E5%B0%86%E6%82%A8%E6%89%80%E6%9C%89%E8%B4%A1%E7%8C%AE%E7%9A%84%E7%89%88%E6%9D%83%E6%8E%88%E4%BA%88%E6%9C%AC%E9%A1%B9%E7%9B%AE%EF%BC%8C%E5%B9%B6%E5%90%8C%E6%84%8F%E6%98%8E%E7%A1%AE%E5%A3%B0%E6%98%8E%E6%98%AF%E5%90%A6%E4%B8%8D%E5%90%8C%E6%84%8F%E8%BF%99%E4%BA%9B%E6%9D%A1%E6%AC%BE%E3%80%82%E6%82%A8%E7%9A%84%E5%B7%A5%E4%BD%9C%E5%B0%86%E4%B8%8E%E9%A1%B9%E7%9B%AE%E5%85%B6%E4%BD%99%E4%BB%A3%E7%A0%81%E4%B8%80%E8%B5%B7%E4%BB%A5Apache V2许可发布。