将任务上传到项目集合

Azure DevOps Services

了解如何使用用于 Azure DevOps 的 Node CLI(tfx-cli)将任务上传到组织的自定义任务或 Azure DevOps 中的内置任务。

例如,此准则可帮助更新 Azure DevOps Server 上的现内任务。

重要

对于将现成任务上传到本地实例的情况,由于 Azure DevOps Server 端的旧代理版本/缺乏支持,可能不支持某些任务功能。

有关 tfx-cli 的详细信息,请参阅 GitHub 上的 Azure DevOps 的 Node CLI。

先决条件

若要将任务上传到项目集合,需要满足以下先决条件:

  • Node.js最新版本

  • 用于 Azure DevOps 的 Node CLI,用于上传任务。

    • 通过npm运行 Node.js 的组件安装 tfx-cli
      npm install -g tfx-cli
    
  • 更新所需项目集合的权限,使用范围 环境(读取和写入) 生成的 PAT 能够将任务上传到项目集合。

使用个人访问令牌登录 Tfx-cli

需要使用 tfx-cli 登录到 Azure DevOps - 才能将管道任务上传到项目集合。

重要

默认情况下,需要个人访问令牌才能在 Azure DevOps 中对项目集合进行身份验证。 需要创建具有范围环境(读取和管理的个人访问令牌(PAT)。

提示

可以使用其他方法通过 tfx-cli 授权 - 有关更多详细信息,请参阅 Azure DevOps 的跨平台 CLI 中的身份验证。

若要登录 - 应将项目集合的路径指定为 URL。 项目集合的默认名称为 DefaultCollection

对于 Azure DevOps Services,项目集合的路径将采用以下格式: https://{Azure DevOps organization name}.visualstudio.com/DefaultCollection

对于 Azure DevOps Server 默认项目集合 URL,将取决于服务器所在的 URL 及其模板: http://{Azure DevOps Server url}/DefaultCollection

输入以下命令并提供请求的信息:

~$ tfx login

将任务上传到项目集合

提示

如果需要更新现装管道任务,可以克隆 azure-pipelines-tasks 存储库,并按照 准则生成所需任务 - 如何生成任务

现在,可以使用 tfx-cli.

输入以下命令:

tfx build tasks upload --task-path <PATH_TO_TASK>

注意

PATH_TO_TASK是包含已编译任务的文件夹的路径。 有关使用 tfx-cli 的详细信息,请参阅 适用于 Azure DevOps 的 Node CLI 文档