Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Upload aangepaste of standaard pijplijn-taken naar uw Azure DevOps-organisatie of Azure DevOps Server-projectverzameling door gebruik te maken van de Azure DevOps Node CLI (tfx-cli).
Belangrijk
Wanneer u in-the-box-taken uploadt naar een Azure DevOps Server-exemplaar, worden sommige taakmogelijkheden mogelijk niet ondersteund vanwege de agentversie of gebrek aan ondersteuning aan de serverzijde.
Voor meer informatie over tfx-cli, bekijk de Node CLI voor Azure DevOps op GitHub.
Voorwaarden
| Categorie | Requirements |
|---|---|
| toestemmingen | Lidmaatschap van de groep Agentpoolbeheerders op organisatieniveau of verzamelniveau. Zie Beveiligingsgroepen, serviceaccounts en machtigingen. |
| Tokens | Een persoonlijk toegangstoken (PAT) met de bereikagentgroepen (lezen en beheren) of een Microsoft Entra-token. Entra-tokens worden aanbevolen boven PATs voor betere beveiliging. |
| Gereedschappen |
Nieuwste versie van Node.js en tfx-cli die wereldwijd is geïnstalleerd: npm install -g tfx-cli |
Aanmelden met tfx-cli
Meld u aan bij Azure DevOps met behulp van tfx-cli voordat u taken uploadt. Zie Voor meer verificatieopties , platformoverschrijdende CLI-verificatie voor Azure DevOps.
Voer de volgende opdracht uit en geef de service-URL en PAT op wanneer u hierom wordt gevraagd:
tfx login
Gebruik de service-URL die overeenkomt met uw omgeving:
| Milieu | URL-indeling |
|---|---|
| Azure DevOps Services | https://dev.azure.com/{organization} |
| Azure DevOps Server | http://{server}:{port}/DefaultCollection |
Taken uploaden
Aanbeveling
Als u de standaard pijplijntaken wilt bijwerken, kunt u de azure-pipelines-tasks repository klonen. Bouw vervolgens de vereiste taken volgens de richtlijn: het bouwen van taken.
Een taak uploaden met behulp van tfx-cli:
tfx build tasks upload --task-path <PATH_TO_TASK>
PATH_TO_TASK is het pad naar de map die de gecompileerde taak bevat, inclusief task.json.
Belangrijk
Pijplijnagents cachetaken per versie. Als u een taak wijzigt en opnieuw uploadt met hetzelfde versienummer, blijven agents de kopie in de cache gebruiken. Verhoog altijd ten minste de patchversie in task.json voordat je een bijgewerkte taak uploadt.
De upload controleren
Controleer gelijk of uw taak succesvol is geüpload.
tfx build tasks list
De uitvoer bevat alle taken op de server, inclusief de id, nameen version van elke taak.
Een taak verwijderen
Verwijder een geüploade taak door de id op te geven. Haal de taak-id op uit de tfx build tasks list uitvoer.
tfx build tasks delete --task-id <TASK_ID>
Waarschuwing
Als u een taak verwijdert, wordt deze verwijderd van de server. Elke pijplijn die verwijst naar de verwijderde taak mislukt tijdens de volgende uitvoering.
Troubleshooting
| Fout | Oorzaak | Repareren |
|---|---|---|
| 401 Niet geautoriseerd | PAT is verlopen, ingetrokken of heeft niet de Agentpools (lezen en beheren) bevoegdheid. | Maak een nieuwe PAT met het juiste bereik. |
| 403 Verboden | Uw account bevindt zich niet in de groep Beheerders van agentgroepen . | Vraag een organisatiebeheerder om u toe te voegen. |
| Taak bestaat al | Dezelfde versie die zich al op de server bevindt, is geüpload. | Verhoog de patch versie in task.json en upload opnieuw. |
Zie de Documentatie voor Node CLI voor Azure DevOps voor meer informatie over tfx-cli.