共用方式為

將工作上傳至專案集合

  • 發行項

Azure DevOps Services

瞭解如何使用 Azure DevOps 的 Node CLI (tfx-cli) 將任務上傳至組織，無論是自訂任務還是 Azure DevOps 中的預設任務。

例如，此指導方針有助於更新 Azure DevOps Server 上的內建工作。

重要

當將現成的工作上傳至內部部署實例時，某些工作功能可能會因舊代理程式版本或 Azure DevOps Server 端缺乏支援而不被支援。

如需 tfx-cli的詳細資訊，請參閱 GitHub 上的 azure DevOpsNode CLI。

先決條件

若要將工作上傳至專案集合，您需要必要條件：

  • Node.js的最新版本 。

  • Azure DevOps 的 Node CLI 上傳工作。

    • 使用 npm安裝 tfx-cli ，這是 Node.js 的元件，方法是執行：
      npm install -g tfx-cli

  • 更新專案集合所需的許可權，使用範圍 Environment 產生的 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 的詳細資訊，請參閱 azure DevOps Node CLI 檔案。