다음을 통해 공유

Team Foundation 빌드 환경 변수

  • 아티클

TF_BUILD 환경 변수를 사용하여 빌드 프로세스 논리에 필요한 핵심 데이터 비트를 가져올 수 있습니다. 예를 들어, 소스 폴더에 대한 경로 또는 저장할 출력이 들어 있는 폴더에 대한 경로를 가져올 수 있습니다.

  • TF_BUILD 환경 변수

  • MSBuild의 환경 변수 사용

  • 프로그램 또는 스크립트의 환경 변수 사용

  • 사용자 지정 빌드 프로세스의 환경 변수 사용

TF_BUILD 환경 변수

  • TF_BUILD TFBuild에 의해 True로 설정하면 스크립트가 TFBuild에 의해 실행되는지 여부에 따라 스크립트의 일부를 조건부로 만들 수 있습니다.

  • TF_BUILD_BINARIESDIRECTORY 이 디렉터리에서 빌드 프로세스가 출력 파일을 스테이징 위치에 복사합니다. 이 디렉터리는 빌드 에이전트 작업 디렉터리의 하위 디렉터리입니다. 예: C:\Build\BuildBot3\CoolApp\CIBuild\bin

    TFBuild에서 이 디렉터리를 자동으로 만들어서 빌드 출력(출력 위치를 AsConfigured로 설정하지 않은 경우)을 여기에 넣습니다. 이 경우 스크립트를 사용하여 이 디렉터리에 저장할 파일을 복사할 수 있습니다.

    참고

    스크립트에서 필요에 따라 이 디렉터리 작성 또는 정리를 처리할 수도 있습니다.예제를 보려면 빌드 프로세스에서 스크립트 실행를 참조하십시오.

  • TF_BUILD_BUILDDEFINITIONNAME 빌드 정의의 이름입니다.

  • TF_BUILD_BUILDDIRECTORY 빌드 에이전트 작업 디렉터리입니다. 예: C:\Build\BuildBot3\CoolApp\CIBuild

  • TF_BUILD_BUILDNUMBER 빌드의 빌드 번호입니다. 예: CIBuild_20130613.6

  • TF_BUILD_BUILDREASON 빌드에 대한 빌드 이유입니다. 예: IndividualCI

  • TF_BUILD_BUILDURI 빌드할 URI입니다. 예: vstfs:///Build/Build/35

  • TF_BUILD_COLLECTIONURI 팀 프로젝트 컬렉션에 대한 URI 예: http://fabrikam-2:8080/tfs/DefaultCollection(이 환경 변수를 사용하려면 Visual Studio 2012 업데이트 2 또는 후속 버전이 설치되어 있어야 함)

  • TF_BUILD_DROPLOCATION 저장 항목의 위치입니다. UNC 경로에 저장 예: \\fabrikam-1\Drops\CIBuild\CIBuild_20130613.6 Team Foundation Server에 저장 예: #/11/drop.

  • TF_BUILD_SOURCEGETVERSION 빌드 중인 버전(TFVC 변경 집합 또는 Git 커밋)입니다.

  • TF_BUILD_SOURCESDIRECTORY 빌드 에이전트 작업 디렉터리의 소스 하위 디렉터리입니다. 이 디렉터리에 소스 코드가 있습니다. 예: C:\Build\BuildBot3\CoolApp\CIBuild\src

    예제를 보려면 빌드 프로세스에서 스크립트 실행를 참조하십시오.

  • TF_BUILD_TESTRESULTSDIRECTORY 빌드 에이전트 작업 디렉터리의 테스트 결과 하위 디렉터리입니다. 예: C:\Build\BuildBot3\CoolApp\CIBuild\tst

MSBuild의 환경 변수 데이터

MSBuild를 사용하여 코드를 컴파일할 때(기본 템플릿 또는 MSBuild 작업을 사용하는 사용자 지정 빌드 프로세스를 통해) 작동 방식을 제어하기 위해 인수를 전달할 수 있습니다. 또한 일부 코드 프로젝트에는 인수를 사용하여 호출할 수 있는 특수 대상이 있습니다. TF_BUILD 환경 변수로 코드 프로젝트 파일에서 XML을 편집할 필요 없이 이러한 옵션을 사용할 수 있습니다.

예를 들어, 기본 템플릿을 사용하여 ASP.Net 웹 응용 프로그램 프로젝트를 빌드하고 웹 패키지만 스테이징 위치에 저장할 수 있습니다. 이렇게 하려면 빌드 정의를 편집하고 다음을 수행합니다.

  • 출력 위치 프로세스 매개 변수를 AsConfigured로 설정합니다.

  • 다음과 같은 옵션을 MSBuild 인수에 추가합니다.

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

프로그램 또는 스크립트의 환경 데이터 사용

소유하고 있지 않은 프로그램 또는 스크립트에 TF_BUILD 환경 변수를 전달할 수도 있습니다. 스크립트에서 위에 지정된 이름을 사용하여 TF_BUILD 환경 변수에 액세스하는 경우에는 스크립트에 TF_BUILD 환경 변수를 전달할 필요는 없습니다. 몇 가지 예제를 보려면 빌드 프로세스에서 스크립트 실행을 참조하십시오.

사용자 지정 빌드 프로세스의 환경 데이터 사용

사용자 지정 빌드 프로세스 템플릿에서 환경 변수를 사용해야 할 경우 GetEnvironmentVariable 작업을 사용하여 데이터를 가져올 수 있습니다. WellKnownEnvironmentVariables에서 데이터를 가져올 수 있습니다.

예를 들어, 이진 디렉터리에 대한 데이터를 가져오려면 GetEnvironmentVariable 작업의 Name 속성을 Microsoft.TeamFoundation.Build.Activities.Extensions.WellKnownEnvironmentVariables.BinariesDirectory로 설정합니다.