Compartilhar via

Variáveis de ambiente do Team Foundation Build

  • Artigo

É possível usar as variáveis de ambiente TF_BUILD para obter bits de chave de dados necessários para a lógica do processo de compilação. Por exemplo, é possível obter o caminho para a pasta de origem ou o caminho para a pasta que contém as saídas que você deseja remover.

  • Variáveis de ambiente TF_BUILD

  • Usar variáveis de ambiente em MSBuild

  • Usar variáveis de ambiente em programas ou scripts

  • Usar variáveis de ambiente em um processo de compilação personalizado

Variáveis de ambiente TF_BUILD

  • TF_BUILD Definido por TFBuild como True de forma que seja possível tornar partes do script condicionais, com base na possibilidade do script ser ou não executado por TFBuild.

  • TF_BUILD_BINARIESDIRECTORY O diretório do qual o processo de compilação copia arquivos de saída para o local de preparo. Esse diretório é um subdiretório do diretório de trabalho do agente de compilação. Por exemplo: C:\Build\BuildBot3\CoolApp\CIBuild\bin.

    TFBuild cria automaticamente esse diretório e coloca as saídas de compilação, a menos que você defina Local de saída como AsConfigured. Nesse caso, é possível usar os scripts para copiar os arquivos que você deseja remover para esse diretório.

    Dica

    O script também deve ser capaz de identificar a criação ou a limpeza desse diretório conforme necessário.Para ver um exemplo, consulte Executar um script em seu processo de compilação.

  • TF_BUILD_BUILDDEFINITIONNAME o nome da definição de compilação.

  • TF_BUILD_BUILDDIRECTORY O diretório de trabalho do agente de compilação. Por exemplo: C:\Build\BuildBot3\CoolApp\CIBuild.

  • TF_BUILD_BUILDNUMBER O número de compilação da compilação. Por exemplo: CIBuild_20130613.6.

  • TF_BUILD_BUILDREASON O motivo da compilação. Por exemplo: IndividualCI.

  • TF_BUILD_BUILDURI O URI da compilação. Por exemplo: vstfs:///Build/Build/35.

  • TF_BUILD_COLLECTIONURI O URI da coleção de projetos da equipe. Por exemplo: http://fabrikam-2:8080/tfs/DefaultCollection (Você deve ter instalado o Visual Studio 2012 Update 2 ou uma versão posterior para usar esta variável de ambiente.)

  • TF_BUILD_DROPLOCATION A localização para soltar. Um exemplo de soltar para um caminho UNC: \\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6. Um exemplo de soltar para o Team Foundation Server: #/11/drop.

  • TF_BUILD_SOURCEGETVERSION A versão (conjunto de alterações TFVC ou confirmação Git) que está sendo compilada.

  • TF_BUILD_SOURCESDIRECTORY O subdiretório de origem do diretório de trabalho do agente de compilação. Esse diretório contém o código-fonte. Por exemplo: C:\Build\BuildBot3\CoolApp\CIBuild\src.

    Para ver um exemplo, consulte Executar um script em seu processo de compilação.

  • TF_BUILD_TESTRESULTSDIRECTORY O subdiretório de resultados do teste do diretório de trabalho do agente de compilação. Por exemplo: C:\Build\BuildBot3\CoolApp\CIBuild\tst.

Usar dados de variável de ambiente em MSBuild

Ao usar MSBuild para compilar o código (por meio do modelo padrão ou em um processo de compilação personalizado usando a atividade MSBuild), você pode passar argumentos para controlar como ele funciona. Além disso, alguns projetos de código incluem destinos especiais que é possível invocar usando-se esses argumentos. É possível usar variáveis de ambiente TF_BUILD para habilitar essas opções sem precisar editar o XML no arquivo do projeto de código.

Por exemplo, você está usando o Modelo Padrão para compilar um projeto de aplicativo Web do ASP.NET e deseja soltar apenas o pacote da Web no local de preparo. Para fazer isso, você edita a definição de compilação e:

  • Defina o parâmetro de processo Local de saída como AsConfigured.

  • Adicione algo como as seguintes opções aos Argumentos de MSBuild:

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

Usar dados de ambiente em programas ou scripts

Também é possível passar variáveis de ambiente TF_BUILD para programas ou scripts que você não possui. Você não precisa passá-los para os próprios scripts, desde que o script os acesse usando os nomes fornecidos anteriormente. Para alguns exemplos, consulte Executar um script em seu processo de compilação.

Usar os dados de ambiente com base em um processo de compilação personalizado

Se precisar usar uma variável de ambiente no modelo do processo de compilação personalizado, você poderá usar a atividade GetEnvironmentVariable para obter os dados. É possível obter dados de qualquer um do WellKnownEnvironmentVariables.

Por exemplo, para obter o caminho para o diretório de binários, defina a propriedade Name da atividade GetEnvironmentVariable como Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory