使用适用于VSTS / TFS的.NET客户端库检索构建定义的任务列表

Question

我正在使用VSTS / TFS的.NET客户端库（https://docs.microsoft.com/en-us/vsts/integrate/concepts/dotnet-client-libraries?view=vsts）来检索所有团队项目的所有构建定义的任务列表。我正在使用NuGet包的v16.139.0预览版Microsoft.TeamFoundation.ExtendedClient（我需要因为我需要检索Release Definition工作流，因为你需要Microsoft.VisualStudio.Services.Release.Client，它有一个ExtendedClient的依赖性要求。服务器（本地）是TFS 2017.2。我无法检索任务/阶段/过程。这是我的代码：

VssConnection connection = new VssConnection(new Uri("http://tfsserver:8080/tfs/defaultcollection"), new VssClientCredentials());
ProjectHttpClient projectClient = connection.GetClient<ProjectHttpClient>();
IEnumerable<TeamProjectReference> projects = projectClient.GetProjects().Result;
BuildHttpClient buildClient = connection.GetClient<BuildHttpClient>();
foreach (var project in projects)
{
  IPagedList<BuildDefinition> buildDefinitions = buildClient.GetFullDefinitionsAsync2(project: project.Name, name: null).Result;
  foreach (BuildDefinition buildDefinition in buildDefinitions)
  {
    // get the tasks
  }
}

• 我试图使用buildClient.GetDefinitionAsync重新检索构建定义而不会产生额外的影响
• “Steps”属性（将被弃用）始终为null
• “Process”属性为空
• 没有“阶段”属性可用（这似乎是逻辑上看在构建定义中具有多个阶段的选项
• BuildDefinitionStep有一个合同：https://docs.microsoft.com/en-us/vsts/extend/reference/client/api/tfs/build/contracts/builddefinitionstep?view=vsts
• REST API文档没有名为“Step”的属性：https://docs.microsoft.com/en-us/rest/api/vsts/build/definitions/get?view=vsts-rest-4.1#builddefinition

有没有人知道如何解决这个问题？

Answer 1

只需使用.NET客户端库尝试下面的C＃示例，在TFS 2017.3和VSTS上进行测试，两者都有效。 （没有TFS 2017.2在我这边，如果我没记错的话，TFS 2017.2与TFS 2015有类似的构建过程，它没有“Process”和“phases”属性。）

using System;
using Microsoft.TeamFoundation.Build.WebApi;
using Microsoft.VisualStudio.Services.Client;
using Microsoft.VisualStudio.Services.Common;

namespace RetrieveTaskList
{
    class Program
    {
        static void Main(string[] args)
        {
            //For TFS :
            var tfsUrl = "http://ws-tfs2017:8080/tfs/DefaultCollection";
            var buildClient = new BuildHttpClient(new Uri(tfsUrl), new VssAadCredential());

            //For VSTS:
            //var tfsUrl = "https://{account}.visualstudio.com";
            //var buildClient = new BuildHttpClient(new Uri(tfsUrl), new VssBasicCredential(string.Empty, "PAT here"));

            var definitions = buildClient.GetFullDefinitionsAsync(project: "ScrumProject");

            foreach (var definition in definitions.Result)
            {
                Console.WriteLine(string.Format("\n {0} - {1}:", definition.Id, definition.Name));

                // Get BuildDefinitionStep to array, each of which has a task property that contains things like the name of the task and the inputs.
                var tasks = definition.Steps.ToArray();

                //Get each step/task from the array
                foreach (var task in tasks)
                {
                    Console.WriteLine(task.DisplayName);
                }
            }
            Console.ReadLine();
        }
    }
}

---

您还可以使用REST API从构建定义中检索任务列表。

PowerShell例如：

Param(
   [string]$baseurl = "http://server:8080/tfs/DefaultCollection", 
   [string]$projectName = "ProjectName",
   [string]$buildDefinitionID = "26",
   [string]$user = "domain\user",
   [string]$token = "password"
)

# Base64-encodes the Personal Access Token (PAT) appropriately
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $user,$token)))


$uri = "$baseurl/$($projectName)/_apis/build/definitions/$buildDefinitionID"
Write-Host $uri
$result = (Invoke-RestMethod -Uri $uri -Method Get -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)})
$tasks = $result.process.phases.steps.displayName

foreach ($task in $tasks)
{
  write-host $task
}

您也可以尝试REST客户端，请参考以下主题：Retrieve VSTS/TFS Build task name list

Answer 2

在@Andy的帮助下，我能够解决问题。我用Fiddler调用REST Api（http://server:8080/tfs/DefaultCollection/MyProject/_apis/build/definitions/1）并读取JSON响应。我发现“build”属性包含任务集合。我修复了@Andy提供的PowerShell脚本：

Param(
   [string]$baseurl = "http://server:8080/tfs/DefaultCollection", 
   [string]$projectName = "MyProject",
   [string]$buildDefinitionID = "530",
   [string]$user = "domain\user",
   [string]$token = "PersonalAccessToken"
)

# Base64-encodes the Personal Access Token (PAT) appropriately
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $user,$token)))

$uri = "$baseurl/$($projectName)/_apis/build/definitions/$buildDefinitionID"
Write-Host $uri
$result = (Invoke-RestMethod -Uri $uri -Method Get -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)})

foreach ($task in $result.build)
{
    Write-Host $task.displayName
}