通过

将任务上传到项目集合

  • 项目

Azure DevOps Services

了解如何使用适用于 Azure DevOps 的 Node CLI（tfx-cli）将任务上传到组织，以便在 Azure DevOps 中处理自定义任务或内置任务。

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

重要

将内置任务上传到本地实例时，由于代理版本过旧或 Azure DevOps 服务器端某些功能不受支持，某些任务功能可能无法得到支持。

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

先决条件

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

  • Node.js 的最新版本。

  • 用于上传任务的 Azure DevOps 的节点 CLI。

    • 通过运行以下命令使用 Node.js 的组件 npm 安装 tfx-cli：
      npm install -g tfx-cli

  • 用于更新所需项目集合的权限、使用范围环境（读取和写入）生成的能够将任务上传到项目集合的 PAT。

    重要

    我们建议使用 Microsoft Entra 令牌。 有关减少 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 的详细信息，请参阅 Node CLI for Azure DevOps 文档。