Proměnné prostředí sestavení Team Foundation Build

  • Článek

Pomocí proměnných prostředí TF_BUILD můžete získat klíčová data, která budete potřebovat pro svoji logiku procesu sestavení.Například můžete získat cestu ke zdrojové složce nebo cestu ke složce obsahující výstupy, které chcete odpojit.

  • Proměnné prostředí TF_BUILD

  • Použití proměnných prostředí v MSBuild

  • Použití proměnných prostředí v programech nebo skriptech

  • Použití proměnných prostředí ve vlastním procesu sestavení

Proměnné prostředí TF_BUILD

  • TF_BUILD Nastavuje TFBuild na hodnotu True, aby mohly být vytvořeny podmíněné části skriptu závisející na tom, zda skript je či není spuštěn pomocí TFBuild.

  • TF_BUILD_BINARIESDIRECTORY Adresář, ze kterého proces sestavení kopíruje výstupní soubory do pracovního umístění.Tento adresář je podadresářem pracovního adresáře agentu sestavení.Například: C:\Build\BuildBot3\CoolApp\CIBuild\bin.

    TFBuild automaticky vytvoří tento adresář a vloží do něj výstupy sestavení, pokud nenastavíte položku Umístění výstupu na hodnotu AsConfigured.V takovém případě můžete zkopírovat soubory, které chcete umístit do tohoto adresáře, pomocí skriptů.

    [!POZNÁMKA]

    Skript by měl být schopen zpracovat vytváření nebo čištění tohoto adresáře podle potřeby.Příklad naleznete v tématu Spuštění skriptu v procesu sestavení.

  • TF_BUILD_BUILDDEFINITIONNAME název definice sestavení.

  • TF_BUILD_BUILDDIRECTORYPracovní adresář agentu sestavení.Například: C:\Build\BuildBot3\CoolApp\CIBuild.

  • TF_BUILD_BUILDNUMBERČíslo sestavení pro sestavení.Například: CIBuild_20130613.6.

  • TF_BUILD_BUILDREASONDůvod sestavení pro sestavení.Například: IndividualCI.

  • TF_BUILD_BUILDURI Identifikátor URI pro sestavení.Například: vstfs:///Build/Build/35.

  • TF_BUILD_COLLECTIONURI Indikátor URI kolekce týmových projektů.Příklad: http://fabrikam-2:8080/tfs/DefaultCollection (musí jste nainstalovali sadu Visual Studio 2012 Update 2 nebo následné verze používat tuto proměnnou prostředí.)

  • TF_BUILD_DROPLOCATION Umístění odkládací složky.Příklad snížení hodnoty do cesty UNC: \\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6.Příklad odkládací složky pro Team Foundation Server: #/11/drop.

  • TF_BUILD_SOURCEGETVERSION Probíhá sestavování verzí (sada změn TFVC nebo závazek Git).

  • TF_BUILD_SOURCESDIRECTORY Zdrojové podadresáře pracovního adresáře agentu sestavení.Tento adresář obsahuje váš zdrojový kód.Například: C:\Build\BuildBot3\CoolApp\CIBuild\src.

    Příklad naleznete v tématu Spuštění skriptu v procesu sestavení.

  • TF_BUILD_TESTRESULTSDIRECTORY Podadresář pracovního adresáře agentu sestavení s výsledky testů.Například: C:\Build\BuildBot3\CoolApp\CIBuild\tst.

Použití dat proměnných prostředí v MSBuild

Při kompilaci kódu pomocí nástroje MSBuild (buď prostřednictvím výchozí šablony, nebo ve vlastním sestavení pomocí procesu aktivity MSBuild) můžete předat argumenty k řízení fungování procesu.Některé projekty kódu rovněž obsahují speciální cíle, které lze pomocí těchto argumentů vyvolat.Chcete-li povolit tyto možnosti bez nutnosti úpravy XML v souboru s kódem projektu, můžete použít proměnné prostředí TF_BUILD.

Například používáte výchozí šablonu pro vytvoření projektu webové aplikace ASP.Net a chcete pouze umístit webový balíček do pracovního umístění.Chcete-li to provést, upravte definici sestavení a:

  • Nastavte parametr procesu Umístění výstupu na hodnotu AsConfigured.

  • Přidejte do argumentů MSBuild něco podobného následujícím možnostem:

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

Použití dat prostředí v programech nebo skriptech

Proměnné prostředí TF_BUILD můžete také předat do programů nebo skriptů, které nevlastníte.Není třeba je předávat do vlastních skriptů, pokud je vaše skripty využívají pomocí názvů uvedených výše.Příklady naleznete v tématu Spuštění skriptu v procesu sestavení.

Použití dat prostředí z vlastního procesu sestavení

Pokud potřebujete použít proměnné prostředí ve své šabloně vlastního procesu sestavení, můžete k získání dat použít aktivitu GetEnvironmentVariable.Data lze získat z libovolných WellKnownEnvironmentVariables.

Cestu k adresáři binárních souborů lze například získat nastavením vlastnosti Name aktivity GetEnvironmentVariable na hodnotu Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory