Team Foundation Build-Umgebungsvariablen

  • Artikel

Sie können mithilfe der TF_BUILD-Umgebungsvariablen wichtige Datenbestandteile abrufen, die Sie für die Logik des Buildprozesses benötigen. Beispielsweise können Sie den Pfad zum Quellordner oder den Pfad zu dem Ordner abrufen, der die zu löschenden Ausgaben enthält.

  • TF_BUILD-Umgebungsvariablen

  • Verwenden von Umgebungsvariablen in MSBuild

  • Verwenden von Umgebungsvariablen in Programmen oder Skripts

  • Verwenden von Umgebungsvariablen in einem benutzerdefinierten Buildprozess

TF_BUILD-Umgebungsvariablen

  • TF_BUILD Wird von TFBuild auf True festgelegt, sodass Teile des Skript bedingt ausführt werden können, je nachdem, ob das Skript von TFBuild ausgeführt wird.

  • TF_BUILD_BINARIESDIRECTORY Das Verzeichnis, aus dem Ausgabedateien vom Buildprozess an den Stagingspeicherort kopiert werden. Bei diesem Verzeichnis handelt es sich um ein Unterverzeichnis des Build-Agent-Arbeitsverzeichnisses. Beispiel: C:\Build\BuildBot3\CoolApp\CIBuild\bin.

    TFBuild erstellt dieses Verzeichnis automatisch und speichert die Buildausgaben darin, es sei denn, für das Ausgabeverzeichnis wird AsConfigured festgelegt. In diesem Fall können Sie anhand der Skripts die Dateien kopieren, die Sie in diesem Verzeichnis ablegen möchten.

    Hinweis

    Das Skript sollte auch das Erstellen oder Bereinigen dieses Verzeichnis nach Bedarf verarbeiten können.Ein Beispiel finden Sie unter Ausführen eines Skripts im Buildprozess.

  • TF_BUILD_BUILDDEFINITIONNAME Der Name der Builddefinition.

  • TF_BUILD_BUILDDIRECTORY Das Build-Agent-Arbeitsverzeichnis. Beispiel: C:\Build\BuildBot3\CoolApp\CIBuild.

  • TF_BUILD_BUILDNUMBER Die Buildnummer des Builds. Beispiel: CIBuild_20130613.6.

  • TF_BUILD_BUILDREASON Der Buildgrund für den Build. Beispiel: IndividualCI.

  • TF_BUILD_BUILDURI Der URI für den Build. Beispiel: vstfs:///Build/Build/35.

  • TF_BUILD_COLLECTIONURIDie URI der Teamprojektauflistung. Zum Beispiel: http://fabrikam-2:8080/tfs/DefaultCollection (Sie müssen Visual Studio 2012 Update 2 oder eine Folgeversion installiert haben, um diese Umgebungsvariable zu verwenden.)

  • TF_BUILD_DROPLOCATION Der Speicherort der Ablage. Beispiel für eine Ablage unter einem UNC-Pfad: \\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6. Beispiel für eine Ablage auf dem Team Foundation-Server: #/11/drop.

  • TF_BUILD_SOURCEGETVERSION Die zu erstellende Version (TFVC-Changeset oder Git-Commit).

  • TF_BUILD_SOURCESDIRECTORY Das Unterverzeichnis für Quellen des Build-Agent-Arbeitsverzeichnisses. Dieses Verzeichnis enthält den Quellcode. Beispiel: C:\Build\BuildBot3\CoolApp\CIBuild\src.

    Ein Beispiel finden Sie unter Ausführen eines Skripts im Buildprozess.

  • TF_BUILD_TESTRESULTSDIRECTORY Das Unterverzeichnis für Testergebnisse des Build-Agent-Arbeitsverzeichnisses. Beispiel: C:\Build\BuildBot3\CoolApp\CIBuild\tst.

Verwenden von Umgebungsvariablendaten in MSBuild

Wenn Sie den Code mithilfe von MSBuild kompilieren (entweder über die Standardvorlage oder in einem benutzerdefinierten Buildprozess anhand der MSBuild-Aktivität), können Sie Argumente übergeben, um die Funktionsweise zu steuern. Außerdem enthalten einige Codeprojekte spezielle Ziele, die mithilfe dieser Argumente aufgerufen werden können. Sie können TF_BUILD-Umgebungsvariablen verwenden, um diese Optionen zu aktivieren, ohne das XML in der Codeprojektdatei bearbeiten zu müssen.

Beispielsweise erstellen Sie mithilfe der Standardvorlage ein ASP.NET-Webanwendungsprojekt und möchten nur das Webpaket am Stagingort ablegen. Hierzu bearbeiten Sie die Builddefinition und führen Folgendes aus:

  • Festlegen des Prozessparameters für den Ausgabespeicherort auf AsConfigured

  • Hinzufügen von Optionen zu den MSBuild-Argumenten wie z. B. folgende:

    /p:DeployOnBuild=true;DeployMethod=Package /p:DefaultPackageOutputDir=”$(TF_BUILD_BINARIESDIRECTORY)”\WebPackage

Verwenden von Umgebungsdaten in Programmen oder Skripts

Sie können TF_BUILD-Umgebungsvariablen auch an Programme oder Skripts übergeben, deren Besitzer Sie nicht sind. Sie müssen sie nicht an eigene Skripts übergeben, solange Ihr Skript mithilfe der oben angegebenen Namen auf sie zugreifen. Einige Beispiele finden Sie unter Ausführen eines Skripts im Buildprozess.

Verwenden von Umgebungsdaten aus einem benutzerdefinierten Buildprozess

Wenn Sie eine Umgebungsvariable in der benutzerdefinierten Buildprozessvorlage verwenden müssen, können Sie die Daten mithilfe der GetEnvironmentVariable-Aktivität abrufen. Sie können Daten von einer beliebigen WellKnownEnvironmentVariables-Variablen abrufen.

Um den Pfad zum Binärdateiverzeichnis abzurufen, können Sie zum Beispiel die Name-Eigenschaft der GetEnvironmentVariable-Aktivität auf Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory festlegen.