Udostępnij za pośrednictwem

Zmienne środowiskowe Team Foundation Build

  • Artykuł

Można użyć zmiennych środowiskowych programu TF_BUILD w celu uzyskania kluczowych bitów danych, które są potrzebne użytkownikowi zgodnie z logiką procesu kompilacji.Można na przykład uzyskać ścieżkę do folderu źródłowego lub ścieżkę do folderu zawierającego dane wyjściowe, które użytkownik chce usunąć.

  • Zmienne środowiskowe TF_BUILD

  • Użyj zmiennych środowiskowych w programie MSBuild

  • Użyj zmiennych środowiskowych w programach lub skryptach

  • Użyj zmiennych środowiskowych w procesie kompilacji niestandardowej

Zmienne środowiskowe TF_BUILD

  • TF_BUILD Ustaw za pomocą programu TFBuild wartość True, aby fragmenty skryptu można było określać jako warunkowe na podstawie tego, czy skrypt jest uruchamiany przez program TFBuild, czy nie.

  • TF_BUILD_BINARIESDIRECTORY Katalog, z którego proces kompilacji kopiuje pliki wyjściowe do lokalizacji tymczasowej.Ten katalog jest podkatalogiem katalogu roboczego agenta kompilacji.Na przykład: C:\Build\BuildBot3\CoolApp\CIBuild\bin.

    Program TFBuild automatycznie tworzy ten katalog i umieszcza w nim dane wyjściowe kompilacji, chyba że dla opcji Lokalizacja wyjściowa ustawiono wartość AsConfigured.W takim przypadku można używać skryptów do kopiowania plików, które użytkownik chce upuścić do tego katalogu.

    [!UWAGA]

    Skrypt powinien obsługiwać również tworzenie lub czyszczenie katalogu, stosownie do potrzeb.Aby zapoznać się z przykładem, zobacz Uruchamianie skryptu w procesie kompilacji.

  • Nazwa definicji kompilacji TF_BUILD_BUILDDEFINITIONNAME.

  • TF_BUILD_BUILDDIRECTORY The build agent working directory.Na przykład: C:\Build\BuildBot3\CoolApp\CIBuild.

  • TF_BUILD_BUILDNUMBER The build number of the build.Na przykład: CIBuild_20130613.6.

  • TF_BUILD_BUILDREASON The build reason for the build.Na przykład: IndividualCI.

  • TF_BUILD_BUILDURI Identyfikator URI kompilacji.Na przykład: vstfs:///Build/Build/35.

  • TF_BUILD_COLLECTIONURI Identyfikator URI do kolekcji projektu zespołowego.Na przykład: http://fabrikam-2:8080/tfs/DefaultCollection (należy zainstalować program Visual Studio 2012 Update 2 lub późniejszych wersji do użycia tej zmiennej środowiskowej.)

  • TF_BUILD_DROPLOCATION Lokalizacja miejsca upuszczania.Przykładem listy w ścieżce UNC: \\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6.Przykład zrzutu do programu Team Foundation Server: #/11/drop.

  • TF_BUILD_SOURCEGETVERSION Kompilowana wersja (zbiór zmian TFVC lub zatwierdzenie Git).

  • TF_BUILD_SOURCESDIRECTORY Podkatalog katalogu roboczego agenta kompilacji zawierający źródła.Katalog ten zawiera kod źródłowy.Na przykład: C:\Build\BuildBot3\CoolApp\CIBuild\src.

    Aby zapoznać się z przykładem, zobacz Uruchamianie skryptu w procesie kompilacji.

  • TF_BUILD_TESTRESULTSDIRECTORY Podkatalog katalogu roboczego agenta kompilacji zawierający wyniki testu.Na przykład: C:\Build\BuildBot3\CoolApp\CIBuild\tst.

Użyj danych zmiennych środowiskowych w programie MSBuild

Używając programu MSBuild do kompilowania kodu (za pośrednictwem szablonu domyślnego lub w niestandardowym procesie kompilacji za pomocą działania programu MSBuild), możesz przekazać argumenty, aby sprawdzić, jak to działa.Ponadto niektóre projekty kodów zawierają specjalne elementy docelowe, które można wywołać za pomocą tych argumentów.Aby włączyć te opcje bez konieczności edytowania kodu XML w pliku kodu projektu, można użyć zmiennych środowiskowych TF_BUILD.

Na przykład używany jest domyślny szablon w celu zbudowania projektu aplikacji sieci Web w środowisku ASP.Net, a chcesz upuścić tylko pakiet sieci Web do lokalizacji tymczasowej.Aby to zrobić, edytuj definicję kompilacji i:

  • Ustaw parametr procesu Położenie wyjściowe na AsConfigured.

  • Dodaj którąś z poniższych opcji do argumentów MSBuild:

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

Użyj danych środowiskowych w programach lub skryptach

Można również przekazywać zmienne środowiskowe TF_BUILD do programów lub skryptów, które nie są własnością użytkownika.Nie trzeba przekazać ich do własnych skryptów, dopóki skrypt uzyskuje do nich dostęp za pomocą nazw wymienionych powyżej.Aby uzyskać kilka przykładów, zobacz sekcję Uruchamianie skryptu w procesie kompilacji.

Użyj danych środowiskowych z procesu kompilacji niestandardowej

Jeśli użytkownik musi użyć zmiennej środowiskowej w swoim szablonie procesu kompilacji niestandardowej, może użyć działania GetEnvironmentVariable w celu pozyskania danych.Dane można uzyskać z jednego z WellKnownEnvironmentVariables.

Na przykład, aby uzyskać ścieżkę do katalogu plików binarnych, należy ustawić właściwość Name działania GetEnvironmentVariable na Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory