dayglo/vsts-rest

dayglo/vsts-rest镜像说明

镜像概述

dayglo/vsts-rest是Visual Studio Team Services（VSTS）的API工具包镜像，集成客户端库和命令行工具，帮助开发者高效管理VSTS项目的构建、发布流程，实现自动化配置与部署。

核心功能

1. 客户端库：提供VSTS API调用能力，支持项目查询、构建定义创建等核心操作；
2. 命令行工具：包含vsts-import命令，可快速导入构建/发布定义、关联代码仓库并触发构建；
3. 灵活配置：支持覆盖构建/发布代理、配置服务端点等自定义操作。

使用场景

• 自动化VSTS项目的构建与发布流程；
• 批量迁移VSTS项目的构建/发布定义到新环境；
• 自定义配置VSTS项目的代理与服务端点。

配置说明

环境变量

需设置以下环境变量：

• VSTS_ACCOUNT：VSTS账户名（即.visualstudio.com前缀部分）；
• VSTS_PAT：VSTS个人访问令牌（从VSTS web UI生成）；
• VSTS_USER：VSTS关联的***地址（命令行工具使用）。

Docker部署示例

Docker Run命令

bash
docker run -it --rm \
  -e VSTS_ACCOUNT=MyVstsAccount \
  -e VSTS_PAT=your_pat_token \
  -e VSTS_USER=your_email@example.com \
  -v $(pwd):/app \
  dayglo/vsts-rest \
  vsts-import YourProjectName -g https://bitbucket.org/your/repo

说明：挂载本地目录到容器/app，方便读取构建/发布定义文件（如build.json、release.json）。

客户端库使用（容器内）

bash
mkdir myProject && cd myProject
npm install vsts-rest
touch myprogram.js
# 编写myprogram.js（示例代码参考原文档）
node myprogram.js "My Project Name"

命令行工具使用

基础导入命令

bash
vsts-import YourProjectName -g https://bitbucket.org/your/repo

覆盖代理配置

bash
vsts-import MyProject --buildagent "Hosted Linux Preview" --releaseagent "Hosted macOS preview"

配置服务端点

bash
vsts-import MyProject \
  --releaseservice "connectedServiceNameARM=AzureServiceWestEurope" \
  --buildservice "SonarQube=SonarqubeService"