Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Ladda upp anpassade eller färdiga pipelineuppgifter till din Azure DevOps-organisation eller Azure DevOps Server-projektsamling med hjälp av Node CLI för Azure DevOps (tfx-cli).
Viktig
När du laddar upp inbyggda uppgifter till en Azure DevOps Server-instans kanske vissa uppgiftsfunktioner inte stöds på grund av agentversionen eller brist på support på serversidan.
Mer information om tfx-clifinns i Node CLI för Azure DevOps på GitHub.
Förutsättningar
| Kategori | Kravspecifikation |
|---|---|
| Behörigheter | Medlemskap i gruppen Agentpooladministratörer på organisations- eller samlingsnivå. Se Säkerhetsgrupper, tjänstkonton och behörigheter. |
| Token | En personlig åtkomsttoken (PAT) med omfånget Agentpooler (Läs och hantera) eller en Microsoft Entra-token. Entra-token rekommenderas över PAT:er för bättre säkerhet. |
| Arbetsredskap |
Den senaste versionen av Node.js och tfx-cli installerat globalt: npm install -g tfx-cli |
Logga in med tfx-cli
Logga in på Azure DevOps med hjälp av tfx-cli innan du laddar upp uppgifter. Fler autentiseringsalternativ finns i Plattformsoberoende CLI-autentisering för Azure DevOps.
Kör följande kommando och ange tjänstens URL och PAT när du uppmanas att göra det:
tfx login
Använd tjänst-URL:en som matchar din miljö:
| Miljö | URL-format |
|---|---|
| Azure DevOps Services | https://dev.azure.com/{organization} |
| Azure DevOps Server | http://{server}:{port}/DefaultCollection |
Ladda upp uppgifter
Tips
Om du behöver uppdatera fördefinerade pipeline-uppgifter kan du klona azure-pipelines-tasks-repositoryt. Skapa sedan de uppgifter som krävs genom att följa riktlinjen – hur du skapar uppgifter.
Ladda upp en uppgift genom att använda tfx-cli.
tfx build tasks upload --task-path <PATH_TO_TASK>
PATH_TO_TASK är sökvägen till mappen som innehåller den kompilerade uppgiften, inklusive task.json.
Viktig
Pipeline-agenter cachelagrar uppgifter per version. Om du ändrar en uppgift och laddar upp den igen med samma versionsnummer fortsätter agenterna att använda den cachelagrade kopian. Höj alltid åtminstone patch-versionen i task.json, innan du laddar upp en uppdaterad uppgift.
Verifiera uppladdningen
Bekräfta att uppgiften har laddats upp:
tfx build tasks list
Utdata visar alla aktiviteter på servern, inklusive id, nameoch version för varje aktivitet.
Ta bort en uppgift
Ta bort en uppladdad uppgift genom att ange dess ID. Hämta aktivitets-ID:t från tfx build tasks list resultatet.
tfx build tasks delete --task-id <TASK_ID>
Varning
Om du tar bort en aktivitet tas den bort från servern. En pipeline som refererar till den borttagna aktiviteten misslyckas vid nästa körning.
Felsökning
| Error | Orsak | Reparera |
|---|---|---|
| 401 Obehörig | PAT har gått ut, återkallats eller saknar Agentpooler (läs och hantera)-omfånget. | Skapa en ny PAT med rätt omfång. |
| 403 – Förbjuden | Ditt konto finns inte i gruppen Agentpooladministratörer . | Be en organisationsadministratör att lägga till dig. |
| Uppgiften finns redan | Har laddat upp samma version som redan finns på servern. | Höj korrigeringsversionen i task.json och ladda upp den igen. |
Mer information om tfx-cli finns i dokumentationen om Node CLI för Azure DevOps.