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.

  

• Im Anschluss müssen Sie die Basic Authentification im IIS für Ihren TFS Server aktivieren.

  

Authentifizierung über Token

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

  

• 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.

  

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

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

Auflistung aller vorhandenen Aufgaben:

• Für die Aufistung aller vorhanden Aufgaben geben Sie den folgenden Befehl ein.

  tfx build tasks list

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

Aufgabe löschen:

• Führen Sie den folgenden Befehl aus, wobei Sie die ID an Ihre anpassen.

  tfx build tasks delete --task-id IDdesTaks

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