iunera/vsts-agent

iunera/vsts-agent 镜像文档

镜像概述

iunera/vsts-agent 是一个基于 Ubuntu 系统的 VSTS（Visual Studio Team Services）代理镜像，集成了 OpenJDK 运行时环境和 Docker 引擎。该镜像旨在提供一个开箱即用的 CI/CD 代理环境，可直接连接 VSTS 服务，执行构建、测试和部署任务，尤其适用于需要 Java 运行环境和 Docker 操作的场景。

核心功能与特性

• 基础环境：基于 Ubuntu 系统，提供稳定的操作系统基础
• Java 支持：集成 OpenJDK，支持 Java 应用的编译和运行
• Docker 集成：内置 Docker 环境，可直接在代理中执行 Docker 命令（如构建、推送镜像）
• VSTS 代理功能：包含 VSTS 代理启动脚本，支持快速连接 VSTS 服务
• 持久化配置：支持通过卷挂载 Docker 套接字，实现与主机 Docker 服务的交互

使用场景与适用范围

• CI/CD 流程中的自动化构建代理
• 需要 Java 运行环境的应用构建任务
• 包含 Docker 镜像构建、推送步骤的部署流程
• 团队协作开发中的持续集成环境

使用方法与配置说明

前置要求

• 已注册 VSTS 账户并创建项目
• 拥有有效的个人访问令牌（PAT），具有代理池管理权限
• 已创建 VSTS 代理池

Docker Compose 部署

推荐使用 docker-compose 进行部署，配置示例如下：

yaml
version: '2'
services:
  vsts-agent:
    restart: always  # 容器退出时自动重启
    privileged: true  # 授予特权模式，支持 Docker 操作
    image: iunera/vsts-agent:latest  # 使用最新版本镜像
    command: ./vsts-startup.sh https://iunera.visualstudio.com <PAT> <AGENT_POOL> <Agent Name>  # 启动命令
    volumes: 
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载主机 Docker 套接字，实现 Docker 命令交互

命令参数说明

command 字段中的参数需替换为实际值：

• https://iunera.visualstudio.com：VSTS 服务地址（根据实际项目地址修改）
• <PAT>：个人访问令牌，用于认证 VSTS 服务
• <AGENT_POOL>：目标代理池名称，代理将加入该池
• <Agent Name>：代理名称，在 VSTS 控制台中显示的标识

Docker Run 命令部署

也可直接使用 docker run 命令启动容器：

bash
docker run -d \
  --restart always \
  --privileged \
  -v /var/run/docker.sock:/var/run/docker.sock \
  iunera/vsts-agent:latest \
  ./vsts-startup.sh https://iunera.visualstudio.com <PAT> <AGENT_POOL> <Agent Name>

验证部署

部署完成后，可在 VSTS 控制台的 "代理池" 页面查看新添加的代理状态，当状态显示为 "在线" 时，即可开始接收并执行构建任务。

注意事项

• 确保主机 Docker 服务正常运行，且挂载的 /var/run/docker.sock 具有正确权限
• 个人访问令牌（PAT）需包含 "代理池管理" 和 "构建服务" 相关权限
• 代理名称需在代理池中保持唯一，避免冲突
• 如需自定义 Java 版本或 Docker 版本，可基于此镜像进行二次构建