Variables d'environnement Team Foundation Build

  • Article

Vous pouvez utiliser les variables d'environnement TF_BUILD pour obtenir les bits de données clés dont vous avez besoin pour la logique de votre processus de génération. Vous pouvez par exemple obtenir le chemin d'accès au dossier source ou le chemin d'accès au dossier qui contient les sorties à supprimer.

  • Variables d'environnement TF_BUILD

  • Utiliser des variables d'environnement dans MSBuild

  • Utiliser des variables d'environnement dans des programmes ou des scripts

  • Utiliser des variables d'environnement dans un processus de génération personnalisé

Variables d'environnement TF_BUILD

  • TF_BUILD défini par TFBuild sur True de sorte que vous pouvez rendre conditionnelles des parties de votre script, selon que celui-ci est ou non exécuté par TFBuild.

  • TF_BUILD_BINARIESDIRECTORY Répertoire à partir duquel le processus de génération copie les fichiers de sortie vers l'emplacement intermédiaire. Ce répertoire est un sous-répertoire du répertoire de travail de l'agent de build. Par exemple : C:\Build\BuildBot3\CoolApp\CIBuild\bin.

    TFBuild crée automatiquement ce répertoire et y place les sorties de la génération, à moins que vous n'ayez défini l'Emplacement de sortie sur AsConfigured. Dans ce cas, vous pouvez utiliser vos scripts pour copier les fichiers que vous souhaitez déplacer dans ce répertoire.

    Notes

    Votre script doit également pouvoir gérer la création ou le nettoyage de ce répertoire si nécessaire.Pour obtenir un exemple, consultez Exécuter un script dans votre processus de génération.

  • TF_BUILD_BUILDDEFINITIONNAME Le nom de la définition de build.

  • TF_BUILD_BUILDDIRECTORY Le répertoire de travail de l'agent de build. Par exemple : C:\Build\BuildBot3\CoolApp\CIBuild.

  • TF_BUILD_BUILDNUMBER Le numéro de build de la génération. Par exemple : CIBuild_20130613.6.

  • TF_BUILD_BUILDREASON Le motif de build de la génération. Par exemple : IndividualCI.

  • TF_BUILD_BUILDURI L'URI de la build. Par exemple : vstfs:///Build/Build/35.

  • TF_BUILD_COLLECTIONURI URI vers la collection de projets d'équipe. Par exemple : http://fabrikam-2:8080/tfs/DefaultCollection (Visual Studio 2012 Update 2 ou version ultérieure doit être installé pour utiliser cette variable d'environnement.)

  • TF_BUILD_DROPLOCATION L'emplacement de la cible. Exemple de déplacement vers un chemin d'accès UNC : \\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6. Exemple de déplacement vers Team Foundation Server : #/11/drop.

  • TF_BUILD_SOURCEGETVERSION La version (Ensemble de modifications TFVC ou Validation de Git) en cours de génération.

  • TF_BUILD_SOURCESDIRECTORY Le sous-répertoire des sources du répertoire de travail de l'agent de build. Ce répertoire contient votre code source. Par exemple : C:\Build\BuildBot3\CoolApp\CIBuild\src.

    Pour obtenir un exemple, consultez Exécuter un script dans votre processus de génération.

  • TF_BUILD_TESTRESULTSDIRECTORY Le sous-répertoire des résultats des tests du répertoire de travail de l'agent de build. Par exemple : C:\Build\BuildBot3\CoolApp\CIBuild\tst.

Utiliser des données de variable d'environnement dans MSBuild

Lorsque vous utilisez MSBuild pour compiler votre code (à l'aide du modèle par défaut ou dans un processus de génération personnalisé utilisant l'activité MSBuild), vous pouvez passer des arguments pour contrôler son fonctionnement. En outre, certains projets de code incluent des cibles spéciales que vous pouvez appeler à l'aide de ces arguments. Vous pouvez utiliser des variables d'environnement TF_BUILD pour activer ces options sans devoir modifier le XML du fichier du projet de code.

Par exemple, vous utilisez le modèle par défaut pour générer un projet d'applications web ASP.Net et vous souhaitez déplacer uniquement le package Web vers votre emplacement intermédiaire. Pour cela, modifiez la définition de build et :

  • définissez le paramètre de processus Emplacement de sortie sur AsConfigured ;

  • ajoutez par exemple les options suivantes aux arguments MSBuild :

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

Utiliser des données de variable d'environnement dans des programmes ou des scripts

Vous pouvez également passer les variables d'environnement TF_BUILD à des programmes ou à des scripts dont vous n'êtes pas propriétaire. Vous n'êtes pas obligé de les passer à vos propres scripts tant que ceux-ci peuvent y accéder à l'aide des noms indiqués ci-dessus. Pour obtenir des exemples, consultez Exécuter un script dans votre processus de génération.

Utiliser des données d'environnement à partir d'un processus de génération personnalisé

Si vous devez utiliser une variable d'environnement dans votre modèle de processus de génération personnalisé, vous pouvez utiliser l'activité GetEnvironmentVariable pour obtenir les données. Vous pouvez obtenir des données à partir de n'importe quel WellKnownEnvironmentVariables.

Par exemple, pour obtenir le chemin d'accès au répertoire de binaires, définissez la propriété Name de l'activité GetEnvironmentVariable sur Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory