Share via


Reason 속성

업데이트: 2007년 11월

중요:

이 기능은 Team Foundation Server 2008 서비스 팩 1에서만 사용할 수 있습니다.

Team Foundation Server 2008, IBuildDetail 서비스 팩 1에는 BuildReason 열거형 형식의 Reason 속성이 포함되어 있습니다. 이 속성은 빌드가 트리거된 방법을 표시합니다. 자세한 내용은 방법: 빌드 정의 만들기를 참조하십시오. 허용되는 값은 다음과 같습니다.

  • Manual   이 값은 사용자가 팀 탐색기의 새 빌드 큐 대기 메뉴 명령을 통해 빌드를 수동으로 시작했음을 나타냅니다.

  • IndividualCI   이 값은 빌드가 체크 인으로 인해 시작되었고 빌드 정의가 각 체크 인에서 빌드하도록 구성되어 있음을 나타냅니다.

  • BatchedCI   이 값은 빌드가 하나 이상의 체크 인으로 인해 시작되었고 빌드 정의가 체크 인을 누적하도록 구성되어 있음을 나타냅니다.

  • Schedule   이 값은 특정 시간에 빌드하도록 예약되었으므로 빌드가 시작되었고 변경 내용을 체크 인한 경우 정기적인 일정으로 빌드하도록 빌드 정의가 구성되어 있음을 나타냅니다.

  • ScheduleForced   이 값은 설정 시간에 빌드가 시작되었고 변경 내용을 체크 인했는지 여부에 관계없이 정기적인 일정으로 빌드하도록 빌드 정의가 구성되어 있음을 나타냅니다.

Reason 속성은 빌드 로그에 표시되지 않습니다. 자세한 내용은 빌드 보고서 개요를 참조하십시오.

Reason 속성은 GetBuildDetails 작업의 출력 속성이기도 하며 TFSBuild.proj 파일에서 MSBuild 속성으로 사용할 수 있습니다. 이 속성을 사용하여 트리거에 따라 빌드 파일을 수정할 수 있습니다. Reason 속성을 사용하여 다음을 수행할 수 있습니다.

  • 특정 빌드 정의에 의해 제어되는 빌드가 어떻게 트리거되었는지 구별합니다. 또한 빌드 트리거에 따라 다양한 빌드 속성을 서로 다른 값으로 설정하여 빌드 출력을 사용자 지정할 수 있습니다.

  • 둘 이상의 빌드 정의가 동일한 TfsBuild.proj 파일을 사용하도록 구성된 경우 특정 빌드 정의를 구별합니다.

예를 들어 야간 빌드에 대해 사용자 지정 빌드 번호를 생성하려면 TFSBuild.proj 파일에 다음 XML을 추가합니다.

<Target Name="BuildNumberOverrideTarget" Condition=" '$(Reason)' == 'Schedule' ">
    <MyBuildNumberGenerator TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)">
      <Output TaskParameter="BuildNumber" PropertyName="BuildNumber" />
    </MyBuildNumberGenerator>
</Target>

또한 MyBuildNumberGenerator 작업을 등록 및 정의해야 합니다. 자세한 내용은 방법: 빌드 번호 사용자 지정을 참조하십시오.

참고 항목

개념

Team Foundation Build 구성 파일 이해

기타 리소스

Team Foundation Build에서 빌드 정의 사용