Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Upload custom or in-the-box pipeline tasks to your Azure DevOps organization or Azure DevOps Server project collection by using the Node CLI for Azure DevOps (tfx-cli).
Important
When you upload in-the-box tasks to an Azure DevOps Server instance, some task capabilities might not be supported due to the agent version or lack of support on the server side.
For more information about tfx-cli, see the Node CLI for Azure DevOps on GitHub.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | Permission to update the organization (Azure DevOps Services) or project collection (Azure DevOps Server). |
| Tokens | A personal access token (PAT) with the scope Environment (Read & Manage). |
| Tools | Latest version of Node.js and tfx-cli installed globally: npm install -g tfx-cli |
Sign in with tfx-cli
Sign in to Azure DevOps by using tfx-cli before you upload tasks. For more authentication options, see Cross-platform CLI authentication for Azure DevOps.
Run the following command and provide the service URL and PAT when prompted:
tfx login
Use the service URL that matches your environment:
| Environment | URL format |
|---|---|
| Azure DevOps Services | https://dev.azure.com/{organization} |
| Azure DevOps Server | http://{server}:{port}/DefaultCollection |
Upload tasks
Tip
If you need to update the in-the-box pipeline tasks, you can clone the azure-pipelines-tasks repository. Then, build the required tasks by following the guideline - how to build tasks.
Upload a task by using tfx-cli:
tfx build tasks upload --task-path <PATH_TO_TASK>
Note
PATH_TO_TASK is the path to the folder with the compiled task. For more information about using tfx-cli, see Node CLI for Azure DevOps documentation.