Share via

Variables de entorno de Team Foundation Build

  • Artículo

Puede usar las variables de entorno de TF_BUILD para obtener los bits de datos clave que necesita para la lógica del proceso de compilación. Por ejemplo, puede obtener la ruta de acceso a la carpeta de origen o la ruta de acceso a la carpeta que contiene los resultados que desea quitar.

  • Variables de entorno de TF_BUILD

  • Usar variables de entorno en MSBuild

  • Usar variables de entorno en programas o scripts

  • Usar variables de entorno en un proceso de compilación personalizado

Variables de entorno de TF_BUILD

  • TF_BUILD: TFBuild lo establece en True para que pueda crear partes del condicional del script en función de si TFBuild lo está ejecutando.

  • TF_BUILD_BINARIESDIRECTORY: el directorio que contiene los archivos de salida que el proceso de compilación copia en la ubicación de ensayo. Este directorio es un subdirectorio del directorio de trabajo del agente de compilación. Por ejemplo: C:\Build\BuildBot3\CoolApp\CIBuild\bin.

    TFBuild crea automáticamente este directorio y coloca en él los resultados de la compilación, a menos que establezca Ubicación de salida en AsConfigured. En este caso, puede usar scripts para copiar los archivos que desea colocar en este directorio.

    Nota

    El script también debe poder controlar la creación o la limpieza de este directorio cuando sea necesario.Para obtener un ejemplo, vea Ejecutar un script en el proceso de compilación.

  • TF_BUILD_BUILDDEFINITIONNAME: el nombre de la definición de compilación.

  • TF_BUILD_BUILDDIRECTORY: el directorio de trabajo del agente de compilación. Por ejemplo: C:\Build\BuildBot3\CoolApp\CIBuild.

  • TF_BUILD_BUILDNUMBER: el número de compilación. Por ejemplo: CIBuild_20130613.6.

  • TF_BUILD_BUILDREASON: el motivo de la compilación. Por ejemplo: IndividualCI.

  • TF_BUILD_BUILDURI: el URI de la compilación. Por ejemplo: vstfs:///Build/Build/35.

  • TF_BUILD_COLLECTIONURI URI a la colección del proyecto de equipo. Por ejemplo: http://fabrikam-2:8080/tfs/DefaultCollection (Para poder usar esta variable de entorno debe tener instalado Visual Studio 2012 Update 2 o una versión posterior).

  • TF_BUILD_DROPLOCATION: la ubicación de destino. Ejemplo de un destino a una ruta de acceso UNC: \\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6. Ejemplo de un destino a Team Foundation Server: #/11/drop.

  • TF_BUILD_SOURCEGETVERSION: la version (conjunto de cambios de TFVC o confirmación de Git) que se compila.

  • TF_BUILD_SOURCESDIRECTORY: el subdirectorio de orígenes del directorio de trabajo del agente de compilación. Este directorio contiene el código fuente. Por ejemplo: C:\Build\BuildBot3\CoolApp\CIBuild\src.

    Para obtener un ejemplo, vea Ejecutar un script en el proceso de compilación.

  • TF_BUILD_TESTRESULTSDIRECTORY: el subdirectorio de resultados de pruebas del directorio de trabajo del agente de compilación. Por ejemplo: C:\Build\BuildBot3\CoolApp\CIBuild\tst.

Usar datos de variables de entorno en MSBuild

Si usa MSBuild para compilar el código (mediante la plantilla predeterminada o en un proceso de compilación personalizado mediante la actividad MSBuild), puede pasar argumentos para controlar su funcionamiento. Además, algunos proyectos de código incluyen destinos especiales que puede invocar mediante estos argumentos. Puede usar variables de entorno de TF_BUILD para habilitar estas opciones sin necesidad de editar el código XML del archivo de proyecto de código.

Por ejemplo, imagine que está usando la plantilla predeterminada para compilar un proyecto de aplicación web de ASP.NET y desea colocar solo el paquete web en su ubicación de ensayo. Para ello, edite la definición de compilación y:

  • Establezca el parámetro de proceso Ubicación de salida en AsConfigured.

  • Agregue algo parecido a las opciones siguientes a Argumentos de MSBuild:

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

Usar datos de entorno en programas o scripts

También puede pasar variables de entorno de TF_BUILD a los programas o los scripts que no son de su propiedad. Si el script obtiene acceso a ellas mediante los nombres especificados anteriormente, no será necesario que las pase a sus propios scripts. Para obtener algunos ejemplos, vea Ejecutar un script en el proceso de compilación.

Usar datos de entorno de un proceso de compilación personalizado

Si necesita utilizar una variable de entorno en la plantilla de proceso de compilación personalizada, puede usar la actividad GetEnvironmentVariable para obtener los datos. Puede recopilar los datos de cualquier WellKnownEnvironmentVariables.

Por ejemplo, para obtener la ruta de acceso al directorio de archivos binarios, establezca la propiedad Name de la actividad GetEnvironmentVariable en Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory