업그레이드 템플릿을 사용하여 빌드 정의

  • 아티클

업그레이드 템플릿을 사용하면 Visual Studio Team Foundation Server 2010의 레거시 빌드 정의를 계속 사용할 수 있습니다. 특히, 이 템플릿을 사용하여 다음 유형의 빌드 개체를 실행할 수 있습니다.

  • Visual Studio Team System 2008 Team Foundation Server를 사용하여 만든 빌드 정의

  • Visual Studio 2005 Team Foundation Server를 사용하여 만든 빌드 형식

Team Foundation Server 2010로 처음 업그레이드할 때 시스템의 각 레거시 빌드 정의와 각 빌드 형식에 대한 업그레이드 템플릿 빌드 정의가 자동으로 만들어집니다.

또한 Team Foundation Server 2010를 실행하는 서버에서 이전 버전의 Visual Studio ALM을 사용하여 빌드 정의나 빌드 형식을 만들 때도 업그레이드 템플릿 빌드 정의가 자동으로 만들어집니다.

이러한 레거시 빌드 개체에 대한 대부분의 특성을 수정하려면 TFSBuild.proj 파일을 수정해야 합니다. 자세한 내용은 Team Foundation Build 대상, 작업 및 속성을 참조하십시오. 그러나 빌드 정의 개체의 일부 설정은 팀 탐색기에서 빌드 노드를 열어 변경할 수 있습니다. 이 항목에서는 이러한 설정에 대해 설명합니다.

필요한 권한

이 절차를 수행하려면 빌드 정의 편집 권한이 허용으로 설정되어 있어야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.

업그레이드 템플릿 빌드 정의를 수정하려면

  1. 팀 탐색기에서 빌드를 정의할 팀 프로젝트를 확장한 다음 빌드 노드를 확장합니다.

  2. 수정할 빌드 정의를 마우스 오른쪽 단추로 클릭한 다음 빌드 정의 편집을 클릭합니다.

  3. 빌드 기본값 탭에서 빌드 컨트롤러 메뉴를 연 다음 빌드 컨트롤러를 선택합니다.

  4. 프로세스 탭을 클릭합니다.

  5. 빌드 프로세스 템플릿 아래에 업그레이드 템플릿이 표시되는지 확인합니다.

  6. 필수 노드를 확장합니다.

  7. 구성 폴더 경로에서 TFSBuild.proj 파일이 들어 있는 폴더의 경로가 올바르게 지정되어 있는지 확인합니다.

  8. 이 항목 뒷부분의 정보를 참조하여 이 빌드 정의에 포함할 기능을 지정하는 필드를 완성합니다.

  9. 프로세스 탭의 필드를 완성한 후 필요에 따라 트리거, 작업 영역, 빌드 기본값 및 보존 정책 탭의 필드를 수정합니다.

    자세한 내용은 기본 빌드 정의 만들기를 참조하십시오.

항목 내용

  • 업그레이드 템플릿의 빌드 프로세스 매개 변수 정보

  • 로그의 자세한 정도 지정

  • 빌드를 처리하는 빌드 에이전트 설정 지정

  • 빌드 에이전트 시간 제한 지정

  • 고급 빌드 프로세스 매개 변수 지정

업그레이드 템플릿의 빌드 프로세스 매개 변수 정보

이 항목에서는 업그레이드 템플릿을 기반으로 하는 빌드의 빌드 프로세스 매개 변수를 사용하여 빌드를 수정하는 방법에 대해 설명합니다. 이 정보는 다음과 같은 경우에 Visual Studio ALM(Application Lifecycle Management)과 일치해야 합니다.

  • Visual Studio ALM에 포함된 두 가지 프로세스 템플릿(MSF for Agile Software Development v5.0 또는 MSF for CMMI Process Improvement v5.0) 중 하나를 사용하여 만든 팀 프로젝트에서 작업하고 있는 경우

  • 팀 멤버 중 아무도 업그레이드 템플릿을 제거하거나 사용자 지정하지 않은 경우

로그의 자세한 정도 지정

빌드 결과 창에 표시되는 로그의 자세한 정도를 지정하려면 기본 노드를 확장하고 로깅의 자세한 정도 목록에서 값을 선택합니다. 다음 표에서는 로깅의 자세한 정도 값과 해당 효과를 보여 줍니다.

값

빌드 오류

빌드 경고

중요도가 높은

Build

메시지

중요도가 보통인

Build

메시지

중요도가 낮은

Build

메시지

워크플로 활동 속성(입력 및 출력)

Minimal

Y

N

N

N

N

N

보통

Y

Y

Y

N

N

N

자세히

Y

Y

Y

Y

N

N

매우 자세히

Y

Y

Y

Y

Y

Y

로깅의 자세한 정도로 지정한 값은 MSBuild에서 발생하는 메시지의 자세한 정도에도 영향을 줍니다. 자세한 내용은 MSBuild 명령줄 참조를 참조하십시오.

빌드 보고서에 대한 자세한 내용은 빌드 결과 창 보기를 참조하십시오.

빌드를 처리하는 빌드 에이전트 지정

빌드를 처리하는 데 사용되는 빌드 를 지정하려면 고급 노드, 에이전트 설정 노드를 차례로 확장하고 다음 상자 중 하나를 채웁니다.

  • 이름 필터: 이 필드에 에이전트 이름을 입력하여 이 빌드 정의를 처리하는 데 사용되는 빌드 에이전트를 필터링할 수 있습니다. * 및 ? 와일드카드 문자를 사용하여 여러 개의 이름을 지정할 수도 있습니다. 예를 들어 이름이 문자 CI로 시작하는 모든 에이전트를 지정하려면 CI*를 지정합니다. 이 조건과 일치하는 에이전트에는 CI, CI1, CI_Agent2 등이 포함됩니다.

  • 태그 필터: 일치하는 태그가 있는 빌드 에이전트에서만 이 빌드가 실행되도록 하려면 하나 이상의 태그를 지정합니다. 예를 들어 빌드 컴퓨터에 제어된 체크 인 빌드를 처리하도록 디자인된 빌드 에이전트를 설치하고 이 빌드 에이전트에 'gated' 태그를 적용합니다. 그런 다음 'gated' 태그로 지정된 에이전트에 의해서만 빌드가 처리되도록 해당 빌드 정의에 'gated' 태그를 적용합니다. 태그를 지정하려면 줄임표 단추(...)를 클릭합니다.

    참고

    이 빌드를 처리하는 데 사용할 수 있는 빌드 에이전트 풀은 이 빌드 정의에 대해 지정한 빌드 컨트롤러에 따라 결정됩니다. 빌드 컨트롤러를 수정하려면 빌드 기본값 탭을 클릭하고 빌드 컨트롤러 메뉴를 연 다음 이 메뉴에서 빌드 컨트롤러를 선택합니다.

빌드 에이전트 시간 제한 지정

시간 제한을 지정하려면 고급 노드, 에이전트 설정 노드를 차례로 확장하고 다음 매개 변수를 지정합니다.

수행하려는 작업

설정할 매개 변수

지침

빌드 에이전트에서 빌드를 처리하는 데 허용되는 최대 시간 지정

최대 실행 시간

hh:mm:ss 서식으로 시간 범위 값을 입력합니다. 예를 들어 값을 04:30:15로 지정한 경우 4시간 30분 15초가 지난 후에도 빌드 에이전트가 작업을 완료하지 못했으면 시간 초과 오류가 발생하면서 빌드가 실패합니다. 빌드 에이전트에서 빌드를 처리할 수 있는 시간에 제한을 두지 않으려면 값을 00:00:00으로 지정합니다.

빌드 에이전트에 빌드 요청을 할당하는 데 허용되는 최대 시간 지정

최대 대기 시간

hh:mm:ss 서식으로 시간 범위 값을 입력합니다. 예를 들어 값을 01:30:45로 지정한 경우 1시간 30분 45초가 지난 후에도 빌드 에이전트에 빌드가 할당되지 않았으면 시간 초과 오류가 발생하면서 빌드가 실패합니다. 빌드 컨트롤러에서 이 빌드 정의를 처리할 빌드 에이전트를 찾을 수 있는 시간에 제한을 두지 않으려면 값을 00:00:00으로 지정합니다.

고급 빌드 프로세스 매개 변수 지정

덜 일반적인 시나리오를 성공적으로 완료하려면 고급 노드의 빌드 프로세스 매개 변수를 수정해야 합니다.

수행하려는 작업

설정할 매개 변수

지침

이진 파일이 빌드 후 저장되는 하위 디렉터리 지정

이진 파일 하위 디렉터리

하위 디렉터리를 지정하지 않으면 Binaries라는 하위 디렉터리가 사용됩니다.

로컬 컴퓨터에 있는 빌드 형식 정의 사용

빌드 형식 다운로드 안 함

Team Foundation Server에서 빌드 형식 정의를 다운로드하지 않고 로컬 컴퓨터에 있는 정의를 사용하려면 이 플래그를 Ture로 설정합니다. 사용된 로컬 경로가 빌드 형식에 대한 로컬 작업 영역입니다.

TFSBuild.proj 파일을 디버깅할 수 있도록 이 매개 변수는 대개 임시로 True로 설정됩니다.

개별 프로젝트에 대한 오류 및 경고 로그 파일 생성

프로젝트당 로그 파일

개별 플랫폼 및 구성 조합 대신 개별 프로젝트에 대한 오류 및 경고 로그 파일을 생성하려면 이 값을 True로 설정합니다.

MSBuild에 전달할 명령줄 인수 지정

MSBuild 인수

빌드 프로세스의 요구 사항에 따라 MSBuild에 인수를 전달해야 하는 경우 MSBuild 인수 매개 변수에 해당 인수를 입력합니다. 자세한 내용은 MSBuild 명령줄 참조를 참조하십시오.

빌드를 처리하는 데 사용되는 MSBuild 버전의 비트 지정

MSBuild 플랫폼

다음 값 중 하나를 지정합니다.

  • 빌드 에이전트에 설치된 Team Foundation Build 서비스의 CPU 비트와 동일한 비트의 MSBuild를 실행하려면 Auto를 지정합니다.

  • 이 빌드를 항상 32비트 버전의 MSBuild를 사용하여 처리하려면 X86을 지정합니다.

    Visual Studio 2010은 32비트 응용 프로그램으로 실행되므로 64비트 버전의 Team Foundation Build 서비스를 실행하는 빌드 에이전트에서 빌드가 처리되는 경우 문제가 발생할 수 있습니다. X86을 지정하여 이러한 종류의 문제를 해결할 수 있습니다,

  • 이 빌드를 항상 64비트 버전의 MSBuild를 사용하여 처리하려면 X64를 지정합니다.

    참고참고
    이 값을 지정할 경우 이 항목 앞부분에서 설명한 것과 같이 태그를 사용하는 등의 방법으로 빌드가 64비트 빌드 컴퓨터에서 호스팅되는 빌드 에이전트에 의해 처리되는지 확인해야 합니다.그렇지 않으면 빌드가 실패합니다.

MSBuild에서 구성 폴더 경로에 있는 파일을 재귀적으로 가져와 사용하도록 지정

재귀 형식

다음 값 중 하나를 지정합니다.

  • MSBuild에서 처리할 파일이 구성 폴더 경로에 지정된 폴더에 들어 있으면 한 수준을 지정합니다.

  • MSBuild에서 처리할 파일이 구성 폴더 경로에 지정된 폴더에 들어 있거나 해당 폴더의 하위 디렉터리에 들어 있으면 전체를 지정합니다.

작업 영역과 빌드를 매핑하는 데 사용되는 하위 디렉터리 지정

소스 하위 디렉터리

이 값은 이 빌드 컴퓨터를 사용하는 빌드 에이전트의 소스 하위 디렉터리 중 적절한 디렉터리로 설정합니다. 하위 디렉터리를 지정하지 않으면 Sources라는 하위 디렉터리가 사용됩니다.

테스트 결과를 저장하는 데 사용되는 하위 디렉터리 지정

테스트 결과 하위 디렉터리

이 값은 이 빌드 컴퓨터를 사용하는 빌드 에이전트의 테스트 결과 하위 디렉터리 중 적절한 디렉터리로 설정합니다. 하위 디렉터리를 지정하지 않으면 TestResults라는 하위 디렉터리가 사용됩니다.