Condividi tramite

Variabili di ambiente di Team Foundation Build

  • Articolo

È possibile usare le variabili di ambiente TF_BUILD per ottenere bit di dati chiave necessari per la logica del processo di compilazione. È possibile ad esempio ottenere il percorso della cartella originale o il percorso della cartella che contiene gli output da generare.

  • Variabili di ambiente TF_BUILD

  • Usare variabili di ambiente in MSBuild

  • Usare variabili di ambiente in programmi o script

  • Usare variabili di ambiente in un processo di compilazione personalizzato

Variabili di ambiente TF_BUILD

  • TF_BUILD Impostato da TFBuild su True in modo da poter rendere condizionali le parti dello script indipendentemente dal fatto che lo script venga eseguito o meno da TFBuild.

  • TF_BUILD_BINARIESDIRECTORY La directory da cui il processo di compilazione copia i file di output nella posizione di gestione temporanea. Questa directory è una sottodirectory della directory di lavoro dell'agente di compilazione. Ad esempio: C:\Build\BuildBot3\CoolApp\CIBuild\bin.

    TFBuild automaticamente crea la directory e vi inserisce gli output di compilazione a meno che si imposti Percorso di output su AsConfigured. In questo caso, è possibile usare script per copiare i file che si vuole rilasciare in tale directory.

    Nota

    Lo script deve essere in grado di gestire la creazione o la pulizia della directory in base alle esigenze.Per un esempio, vedere Eseguire uno script nel processo di compilazione.

  • TF_BUILD_BUILDDEFINITIONNAME Il nome della definizione di compilazione.

  • TF_BUILD_BUILDDIRECTORY La directory di lavoro dell'agente di compilazione. Ad esempio: C:\Build\BuildBot3\CoolApp\CIBuild.

  • TF_BUILD_BUILDNUMBER Il numero build della compilazione. Ad esempio: CIBuild_20130613.6.

  • TF_BUILD_BUILDREASON Il motivo di compilazione. Ad esempio: IndividualCI.

  • TF_BUILD_BUILDURI L'URI della compilazione. Ad esempio: vstfs:///Build/Build/35.

  • TF_BUILD_COLLECTIONURI URI della raccolta di progetti team. Ad esempio: http://fabrikam-2:8080/tfs/DefaultCollection (per usare questa variabile di ambiente è necessario che sia installato Visual Studio 2012 Update 2 o una versione successiva).

  • TF_BUILD_DROPLOCATION La posizione della destinazione. Esempio di destinazione di un percorso UNC \\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6. Esempio di destinazione in Team Foundation Server: #/11/drop.

  • TF_BUILD_SOURCEGETVERSION La versione (insieme di modifiche TFVC o commit Git) da compilare.

  • TF_BUILD_SOURCESDIRECTORY La sottodirectory di origine della directory di lavoro dell'agente di compilazione. Questa directory contiene il codice sorgente. Ad esempio: C:\Build\BuildBot3\CoolApp\CIBuild\src.

    Per un esempio, vedere Eseguire uno script nel processo di compilazione.

  • TF_BUILD_TESTRESULTSDIRECTORY La sottodirectory dei risultati di test della directory di lavoro dell'agente di compilazione. Ad esempio: C:\Build\BuildBot3\CoolApp\CIBuild\tst.

Usare dati della variabile di ambiente in MSBuild

Quando si usa MSBuild per compilare il codice (tramite il modello predefinito o in un processo di compilazione personalizzato mediante l'attività MSBuild), è possibile passare argomenti per controllarne il funzionamento. Inoltre, alcuni progetti di codice includono le destinazioni speciali che è possibile richiamare usando questi argomenti. È possibile usare le variabili di ambiente di TF_BUILD per attivare queste opzioni senza dover modificare il linguaggio XML nel file di progetto di codice.

Ad esempio, si usa il modello predefinito per compilare un progetto di applicazione Web ASP.NET e si vuole rimuovere solo il pacchetto Web nella posizione di gestione temporanea. A tale scopo, modificare la definizione di compilazione e:

  • Impostare il parametro di processo Percorso di output su AsConfigured.

  • Aggiungere un elemento come le seguenti opzioni agli argomenti MSBuild:

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

Usare dai di ambiente in programmi o script

È anche possibile passare variabili di ambiente TF_BUILD a programmi o script di cui non si è proprietari. Non è necessario passare le variabili agli script di proprietà dell'utente se lo script accede alle variabili usando i nomi specificati in precedenza. Per alcuni esempi, vedere Eseguire uno script nel processo di compilazione.

Usare dati di ambiente da un processo di compilazione personalizzato

Se è necessario usare una variabile di ambiente nel modello di processo di compilazione personalizzato, è possibile usare l'attività GetEnvironmentVariable per ottenere i dati. È possibile ottenere dati da un oggetto WellKnownEnvironmentVariables qualsiasi.

Per ottenere il percorso della directory dei file binari, ad esempio, impostare la proprietà Name dell'attività GetEnvironmentVariable su Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory