Eigene TFS Build / Release Aufgaben bereitstellen

Hier finden Sie die Anleitung für den Import von Benutzerdefinierten TFS Build / Release Aufgaben.

Für den Import ist das Tool tfx-cli notwendig. Neben der Verwaltung für Erweiterungen, kann dieses Tool kann auch Workitems und Builds verwalten.

Zusätzlich benötigen Sie für die Ausführung nodejs. Wechseln Sie auf die Seite https://github.com/Microsoft/tfs-cli und folgen Sie den Anweisungen.

Installation tfs-cli

  •  Installieren Sie von der Webseite nodejs.org die aktuelle Version für Windows herungen und installieren diese auf dem gewünschten System
  • Nach erfolgreicher Installatino führen Sie die Kommandozeile als Administrator aus und installieren die Erweiterung tfx-cli mit den folgenden Befehl
    npm install -g tfx-cli
  • Nach erfolgreicher Bereitstellung geben Sie den folgenden Befehl für die Funktionsüberischt ein
    tfx

 

Sie haben die Möglichkeit sich über einen Token oder mit Windows Authentifizierung anzumeldne. Hier werden beide Varianten vorgestellt.

Konfiguration TFS Basic Authentfizierung

  • Damit Sie über eine Windows Authentifizierung sich am TFS anmeldnen können, müssen Sie Basic Authentication aktivieren. Diese Einstellung nehmen Sie am Server Manager des TFS Servers vor.

    TFS tfx-cli import Aufgaben Modul
    TFS tfx-cli import Aufgaben Modul
  • Im Anschluss müssen Sie die Basic Authentification im IIS für Ihren TFS Server aktivieren.

    TFS tfx-cli import Aufgaben Modul
    TFS tfx-cli import Aufgaben Modul

Authentifizierung über Token

  • Melden Sie sich über das TFS Web Interface an und wechseln auf Ihr Foto / Sicherheit

    TFS tfx-cli import Aufgaben Modul
    TFS tfx-cli import Aufgaben Modul
  • Klicken Sie im Bereich Persönlicher Zugriffstoken auf Hinzufügen. Vergeben Sie einen Namen, Zeitraum und die Rechte (Marktplace publish – siehe https://docs.microsoft.com/en-us/vsts/extend/publish/command-line. Erstellen Sie den Token mit Token erstellen.
    Im Anschluss notieren Sie sich den Token. Dieser kann nicht mehr eigesehen werden.

    TFS tfx-cli import Aufgaben Modul
    TFS tfx-cli import Aufgaben Modul

 

Nach erfolgreicher Konfiguration können Sie jetzt mit dem Tool tfx Ihre Tätigkeiten ausführen.

Beachten Sie, dass eine Authentifizierung für tfx immer über die Collection erfolgt. Somit ist auch für VSTS Online die Collection mit anzugeben (z.B. https://my-work.visualstudio.com/DefaultCollection).

Anmeldung Basic Authentifizierung

  • Führen Sie den folgenden Befehl für die TFS Windows Anmeldung aus
    tfx login --auth-type basic
  • Geben Sie jetzt Ihre TFS URL ink. des Collectionnamens ein (z.B.: https://tfs.server.de/DefaultCollection)
  • Geben Sie jetzt den Usernamen ein (z.B.: Domäne\administrator)
  • Zum Schluss geben Sie noch das Passwort des Users ein.
  • Sie sind nun am TFS Server angemeldet
TFS tfx-cli import Aufgaben Modul
TFS tfx-cli import Aufgaben Modul

Anmeldung über Token

  • Führen Sie den gewünschten Befehl aus, geben Sie Ihre TFS URL ein und ihren Token.
    tfx login --auth-type pat
TFS tfx-cli import Aufgaben Modul
TFS tfx-cli import Aufgaben Modul

Auflistung aller vorhandenen Aufgaben:

  • Für die Aufistung aller vorhanden Aufgaben geben Sie den folgenden Befehl ein.
    tfx build tasks list
TFS tfx-cli import Aufgaben Modul
TFS tfx-cli import Aufgaben Modul

Import der neu erstellten Aufgabe: 

  • Führen Sie den folgenden Befehl aus, wobei Sie den Pfad zu Ihrem Tool anpassen.
    tfx build tasks upload --task-path c:\meinPfad
TFS tfx-cli import Aufgaben Modul
TFS tfx-cli import Aufgaben Modul

Aufgabe löschen:

  • Führen Sie den folgenden Befehl aus, wobei Sie die ID an Ihre anpassen.
    tfx build tasks delete --task-id IDdesTaks
TFS tfx-cli import Aufgaben Modul
TFS tfx-cli import Aufgaben Modul

Weitere Links:

https://docs.microsoft.com/en-us/vsts/integrate/get-started/auth/tfs-basic-auth

https://www.npmjs.com/package/tfx-cli

https://github.com/Microsoft/tfs-cli