Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Laden Sie benutzerdefinierte oder sofort einsatzbereite Pipelineaufgaben in Ihre Azure DevOps-Organisation oder Azure DevOps Server-Projektsammlung hoch, indem Sie die Node CLI für Azure DevOps (tfx-cli) verwenden.
Wichtig
Wenn Sie vordefinierte Aufgaben in eine Azure DevOps Server-Instanz hochladen, werden einige Aufgabenfunktionen möglicherweise aufgrund der Agentversion oder durch fehlende Unterstützung auf der Serverseite nicht unterstützt.
Weitere Informationen über tfx-cli finden Sie im Node CLI für Azure DevOps auf GitHub.
Voraussetzungen
| Kategorie | Anforderungen |
|---|---|
| Erlaubnisse | Mitgliedschaft in der Gruppe Agentpooladministratoren auf Organisations- oder Sammlungsebene. Siehe Sicherheitsgruppen, Dienstkonten und Berechtigungen. |
| Token | Ein persönliches Zugriffstoken (PAT) mit dem Umfang Agent Pools (Read & Manage) oder einem Microsoft Entra-Token. Entra-Token werden über PATs empfohlen, um eine bessere Sicherheit zu gewährleisten. |
| Werkzeuge |
Neueste Version von Node.js und tfx-cli global installiert: npm install -g tfx-cli |
Anmelden mit tfx-cli
Melden Sie sich mit tfx-cli bei Azure DevOps an, bevor Sie Aufgaben hochladen. Weitere Authentifizierungsoptionen finden Sie unter plattformübergreifende CLI-Authentifizierung für Azure DevOps.
Führen Sie den folgenden Befehl aus, und stellen Sie die Dienst-URL und pat bereit, wenn Sie dazu aufgefordert werden:
tfx login
Verwenden Sie die Dienst-URL, die Ihrer Umgebung entspricht:
| Umwelt | URL-Format |
|---|---|
| Azure DevOps Services | https://dev.azure.com/{organization} |
| Azure DevOps Server | http://{server}:{port}/DefaultCollection |
Hochladen von Aufgaben
Tipp
Wenn Sie die vordefinierten Pipelineaufgaben aktualisieren müssen, können Sie das Repository "azure-pipelines-tasks" klonen. Erstellen Sie dann die erforderlichen Aufgaben, indem Sie der Richtlinie folgen – wie Aufgaben erstellt werden.
Hochladen einer Aufgabe mithilfe von tfx-cli:
tfx build tasks upload --task-path <PATH_TO_TASK>
PATH_TO_TASK ist der Pfad zum Ordner, der die kompilierte Aufgabe enthält, einschließlich task.json.
Wichtig
Pipeline-Agents zwischenspeichern Aufgaben nach Version. Wenn Sie eine Aufgabe ändern und mit derselben Versionsnummer erneut hochladen, verwenden Agents weiterhin die zwischengespeicherte Kopie. Erhöhen Sie zumindest die Patchversion in task.json, bevor Sie eine aktualisierte Aufgabe hochladen.
Überprüfen des Uploads
Vergewissern Sie sich, dass Ihre Aufgabe erfolgreich hochgeladen wurde:
tfx build tasks list
Die Ausgabe listet alle Aufgaben auf dem Server auf, einschließlich id, name und version der einzelnen Aufgaben.
Aufgabe löschen
Entfernen Sie eine hochgeladene Aufgabe, indem Sie ihre ID angeben. Rufen Sie die Vorgangs-ID aus der tfx build tasks list Ausgabe ab.
tfx build tasks delete --task-id <TASK_ID>
Warnung
Durch das Löschen einer Aufgabe wird sie vom Server entfernt. Jede Pipeline, die auf den gelöschten Vorgang verweist, schlägt bei der nächsten Ausführung fehl.
Problembehandlung
| Fehler | Ursache | Reparatur |
|---|---|---|
| 401 Nicht autorisiert | PAT ist abgelaufen, widerrufen oder fehlt der |
Erstellen Sie einen neuen PAT mit dem richtigen Umfang. |
| 403 – Unzulässig | Ihr Konto befindet sich nicht in der Gruppe " Agentpooladministratoren ". | Bitten Sie einen Organisationsadministrator, Sie hinzuzufügen. |
| Aufgabe ist bereits vorhanden | Die gleiche Version, die sich bereits auf dem Server befindet, wurde hochgeladen. | Erhöhen Sie die Patch-Version in task.json und laden Sie sie erneut hoch. |
Weitere Informationen zu tfx-cli finden Sie in der Dokumentation zur Node CLI für Azure DevOps.