빌드 에이전트 만들기 및 작업
업데이트: 2011년 5월
Team Foundation Build를 사용하려면 팀에 빌드 에이전트가 적어도 하나는 있어야 합니다. 빌드 에이전트는 버전 제어에서 파일 가져오기, 작업 영역 프로비전, 코드 컴파일, 테스트 실행 및 버전 제어에 파일 다시 병합과 같이 프로세서를 많이 사용하는 빌드 작업을 수행합니다. 각 빌드 에이전트는 단일 빌드 컨트롤러에 전용으로 사용되고 제어됩니다.
시작하기 전에
빌드 에이전트를 사용하는 다양한 방법과 빌드 시스템에서 빌드 에이전트의 역할에 대해 알아야 합니다. 자세한 내용은 Team Foundation Build 시스템 이해를 참조하십시오.
빌드 에이전트는 빌드 컴퓨터에 호스팅됩니다. 따라서 빌드 에이전트를 만들고 작업하려면 먼저 빌드 컴퓨터를 구성해야 합니다. 각 빌드 컴퓨터는 하나 이상의 빌드 에이전트를 호스팅할 수 있습니다. 자세한 내용은 빌드 컴퓨터 구성을 참조하십시오.
항목 내용
필요한 권한
빌드 에이전트 만들기
빌드 에이전트 수정
빌드 에이전트 속성 대화 상자
- 작업 디렉터리 속성에 대한 추가 정보
빌드 에이전트를 사용하여 테스트 실행
추가 소프트웨어 설치
코드를 컴파일하는 데 필요한 소프트웨어 설치
기타 작업을 수행하는 데 필요한 소프트웨어 설치
빌드 에이전트에 태그 할당
빌드 에이전트 제거
필요한 권한
이 절차를 수행하려면 빌드 컴퓨터에서 Administrators 그룹의 멤버여야 하고 빌드 리소스 관리 권한이 허용으로 설정되어 있어야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.
빌드 에이전트 만들기
빌드 에이전트를 만들려면
빌드 에이전트를 만들 빌드 컴퓨터에 로그온합니다.
시작, 모든 프로그램, Microsoft Team Foundation Server 2010을 차례로 클릭한 다음 Team Foundation 관리 콘솔을 클릭합니다.
Team Foundation 관리 콘솔이 나타납니다.
트리 창에서 서버의 이름을 확장한 다음 Team Foundation Build 노드를 클릭합니다.
빌드 컴퓨터에 대한 정보가 내용 창에 나타납니다.
**빌드 서비스가 ...에 대해 구성되어 있습니다.**라는 메시지가 나타나지 않으면 빌드 컴퓨터 구성을 참조하십시오.
새 에이전트를 클릭합니다.
빌드 에이전트 속성 대화 상자가 나타납니다. 자세한 내용은 이 항목 뒷부분의 빌드 에이전트 속성을 참조하십시오.
에이전트 속성을 수정하는 작업이 끝나면 확인을 클릭합니다.
빌드 에이전트 이름 바로 아래에 시작 링크가 나타나면 클릭합니다.
빌드 에이전트 수정
클라이언트 컴퓨터에서 또는 빌드 에이전트를 호스팅하는 빌드 컴퓨터에서 직접 빌드 에이전트를 수정할 수 있습니다.
클라이언트 컴퓨터에서 빌드 에이전트를 수정하려면
Visual Studio에서 빌드 메뉴를 연 다음 빌드 컨트롤러 관리를 클릭합니다.
빌드 컨트롤러 관리 대화 상자가 나타납니다.
수정할 빌드 에이전트를 클릭하고 속성을 클릭합니다.
빌드 에이전트 속성 대화 상자가 나타납니다.
빌드 컴퓨터에서 빌드 에이전트를 수정하려면
수정할 빌드 에이전트를 실행하는 빌드 컴퓨터에 로그온합니다.
시작, 모든 프로그램, Microsoft Team Foundation Server 2010을 차례로 클릭한 다음 Team Foundation 관리 콘솔을 클릭합니다.
Team Foundation 관리 콘솔이 나타납니다.
트리 창에서 서버의 이름을 확장한 다음 Team Foundation Build 노드를 클릭합니다.
수정할 빌드 에이전트의 이름 바로 아래에서 속성을 클릭합니다.
빌드 에이전트 속성 대화 상자가 나타납니다.
빌드 에이전트 속성 대화 상자
빌드 에이전트 속성 대화 상자에서는 표시 이름과 설명 및 빌드 에이전트의 작동 방식에 영향을 주는 기타 속성을 보거나 변경할 수 있습니다.
표시 이름, 설명
팀 멤버가 쉽게 식별할 수 있고 빌드 에이전트에 대한 중요한 정보를 얻을 수 있는 이름과 설명을 제공합니다.
컨트롤러
이 빌드 에이전트를 제어할 빌드 컨트롤러를 지정합니다. 빌드 컨트롤러는 이 빌드 에이전트와 같은 빌드 컴퓨터 또는 다른 빌드 컴퓨터에서 실행될 수 있습니다.
컴퓨터 이름
이 상자에는 이 빌드 에이전트를 호스팅하는 빌드 컴퓨터의 이름이 표시됩니다.
작업 디렉터리
이 상자를 사용하여 작업 디렉터리 경로를 지정할 수 있습니다. 자세한 내용은 작업 디렉터리 속성에 대한 추가 정보를 참조하십시오.
빌드 에이전트 서비스 사용
이 빌드 에이전트가 작동하도록 설정하려면 이 확인란을 선택하고, 빌드 에이전트를 비활성화하여 빌드가 할당되지 않게 하려면 확인란의 선택을 취소합니다.
팁
빌드 컴퓨터에서 유지 관리를 수행할 때마다 빌드 에이전트를 비활성화하는 것이 좋습니다.
작업 디렉터리 속성에 대한 추가 정보
빌드 에이전트는 파일을 읽거나 파일에 써야 하는 작업을 위해 작업 디렉터리를 사용합니다. 예를 들어 소스 파일은 이 폴더의 하위 디렉터리에 복사되고 이진 파일을 만들면 이 폴더의 다른 하위 디렉터리에 저장됩니다.
작업 디렉터리 토큰
c:\temp\build\와 같이 작업 디렉터리 속성에 리터럴 경로를 지정할 수는 있지만 토큰을 사용하여 경로를 지정하는 방법이 유연성이 높습니다. 다음과 같은 두 가지 종류의 토큰을 사용할 수 있습니다.
환경 변수: 환경 변수에는 시스템 및 로그온한 사용자의 환경에 대한 정보가 포함됩니다.
예를 들어 Team Foundation Build 서비스를 BuildSvcAcct라는 계정에서 실행하도록 구성했습니다. 또한 Windows Server 2008을 실행하는 빌드 컴퓨터에서 빌드 에이전트의 작업 디렉터리로 $(HomeDrive)\Builds를 지정합니다. 이렇게 하면 빌드 에이전트는 대개 C:\Builds와 같은 실제 디렉터리를 작업 디렉터리로 사용합니다.
팁
빌드 컴퓨터의 환경 변수를 나열하려면 명령 프롬프트를 열고 set을 입력하십시오.
Team Foundation Build 변수: 빌드 에이전트의 작업 디렉터리에서 사용할 수 있는 변수는 다음과 같습니다.
$(BuildAgentId): 팀 프로젝트 컬렉션 내에서 빌드 에이전트를 고유하게 식별하는 자동으로 생성된 정수입니다.
$(BuildAgentName): 빌드 에이전트의 표시 이름입니다.
$(BuildDefinitionId): 팀 프로젝트 컬렉션 내에서 빌드 정의를 고유하게 식별하는 자동으로 생성된 정수입니다.
$(BuildDefinitionPath): 백슬래시로 구분된 팀 프로젝트 이름 및 빌드 정의 이름입니다.
작업 디렉터리 예제
예를 들어 BuildBot3이라는 빌드 에이전트가 있습니다. 팀 프로젝트 CoolApp에 NightlyBuild와 WeeklyBuild라는 두 빌드를 정의했습니다. 작업 디렉터리 상자에 $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath) 값을 지정합니다. 이렇게 하면 BuildBot3 빌드 에이전트에서 다음과 같은 두 작업 디렉터리를 만들고 사용합니다.
C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild
C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild
작업 디렉터리가 너무 길지 않도록 설정
작업 디렉터리를 지정할 때 빌드 에이전트에서 259자가 넘는 실제 경로를 생성하지 않도록 해야 합니다. 이렇게 하지 않으면 빌드가 실패하고 "TF10128:PhysicalPath 경로가 최대 길이인 259자보다 깁니다. 더 짧은 경로를 입력하거나 선택하십시오."라는 오류가 기록됩니다. 대개 빌드 에이전트에서 만드는 실제 경로를 인식할 수 없으므로 이 오류는 예상할 수 없습니다.
이 문제를 해결하려면 실제 경로가 더 짧은 작업 디렉터리를 지정해야 합니다. 예를 들어 $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID) 디렉터리를 지정하면 **c:\bld\3\2\**와 같은 작업 디렉터리가 만들어집니다.
작업 디렉터리에 만든 하위 디렉터리
빌드 에이전트는 이 경로 아래에 다음과 같은 하위 디렉터리를 만들고 사용합니다.
하위 디렉터리 |
저장되는 파일 |
|---|---|
Sources |
빌드 에이전트에서 읽는 파일(예: 소스 파일). 다운로드하는 파일은 각 빌드 정의의 작업 영역 설정에서 지정합니다. 자세한 내용은 빌드 작업 영역 사용 항목을 참조하십시오. |
Binaries |
빌드 에이전트에서 컴파일하는 파일(예: 컴파일된 응용 프로그램 파일) |
TestResults |
빌드 에이전트에서 실행한 테스트의 결과 파일 |
빌드 에이전트를 사용하여 테스트 실행
자동화된 테스트 실행을 하나 이상 실행하는 빌드 프로세스를 디자인할 수 있습니다. 다음 표에서 보여 주는 것과 같이 일부 종류의 테스트 및 테스트 작업에는 특별한 요구 사항을 충족하는 빌드 에이전트가 필요합니다.
테스트 형식 |
Visual Studio 2010이 빌드 컴퓨터에 설치되어 있어야 하는지 여부 |
기타 요구 사항 및 정보 |
|---|---|---|
코드 검사 |
예 |
없음 |
코딩된 UI 테스트 |
예 |
빌드 컴퓨터는 대화형 프로세스로 실행되고 있어야 합니다. 이러한 종류의 빌드 컴퓨터를 설정하는 방법에 대한 자세한 내용은 빌드 컴퓨터 구성을 참조하십시오. 이러한 종류의 테스트에 대한 자세한 내용은 자동화된 UI 테스트를 사용하여 사용자 인터페이스 테스트를 참조하십시오. |
데이터베이스 테스트 데이터 생성 |
아니요 |
없음 |
데이터베이스 단위 테스트 |
예 |
없음 |
제네릭 테스트 |
아니요 |
없음 자세한 내용은 제네릭 테스트를 사용하여 실행 파일을 실행하는 자동화된 테스트 만들기를 참조하십시오. |
부하 테스트 |
예 |
없음 자세한 내용은 순서가 지정된 테스트를 사용하여 테스트 실행 시퀀스 설정을 참조하십시오. |
MSTest 단위 테스트 |
아니요 |
없음 |
순서가 지정된 테스트 |
아니요 |
없음 |
테스트 영향 분석 |
아니요 |
없음 |
웹 테스트 |
예 |
없음 |
테스트를 실행하는 빌드 프로세스를 정의하는 방법에 대한 자세한 내용은 빌드 시스템을 사용하여 테스트 구성 항목을 참조하십시오.
추가 소프트웨어 설치
빌드 에이전트에서 특정 작업을 수행하려면 빌드 컴퓨터에 추가 소프트웨어를 설치해야 할 수도 있습니다.
코드를 컴파일하는 데 필요한 소프트웨어 설치
빌드 에이전트에서 대부분의 일반적인 프로젝트를 빌드할 때는 추가 소프트웨어가 필요하지 않습니다. 예를 들어 추가 소프트웨어를 설치하지 않아도 빌드 에이전트에서 기본 Visual C# WPF 응용 프로그램을 컴파일할 수 있습니다.
그러나 다른 형식의 프로젝트를 컴파일하려면 추가 소프트웨어를 설치해야 합니다. 예를 들어 설치 프로젝트를 컴파일하려면 Visual Studio을 설치해야 합니다.
빌드 에이전트에서 프로젝트를 컴파일할 수 있게 하려면
빌드 에이전트가 실행되는 빌드 컴퓨터에서 팀이 사용하는 Visual Studio의 버전과 에디션을 모두 설치합니다.
개발 환경에 설치되어 있고 응용 프로그램을 빌드하는 데 필요한 기타 소프트웨어 및 구성 요소를 설치합니다.
기타 작업을 수행하는 데 필요한 소프트웨어 설치
빌드 에이전트에서 다양한 다른 작업을 수행하려면 빌드 컴퓨터에 추가 소프트웨어를 설치해야 할 수 있습니다. 다음 표에서는 몇 가지 일반적인 빌드 에이전트 작업 및 해당 작업을 수행하는 데 필요한 소프트웨어를 보여 줍니다.
빌드 에이전트에서 수행할 작업 |
빌드 에이전트 컴퓨터에 설치해야 할 소프트웨어 |
|---|---|
ASP.NET 웹 응용 프로그램 프로젝트 빌드 |
Visual Studio 2010 |
C++ 프로젝트 빌드 |
Visual Studio 2010 |
빌드 에이전트에 태그 할당
빌드 시스템의 규모가 증가함에 따라 특수화된 빌드 에이전트를 정의해야 할 수도 있습니다. 빌드 에이전트에 특수 기능이 있거나 특정 용도가 계획된 경우에는 항상 해당 에이전트에 하나 이상의 태그를 할당해야 합니다. 이렇게 하면 팀 멤버는 특정 유형의 빌드 에이전트가 필요한 빌드 정의를 만들 때 해당 빌드 정의에 태그를 지정할 수 있습니다.
빌드 에이전트에 둘 이상의 태그를 적용할 수 있습니다. 예를 들어 x86 태그와 릴리스 태그가 적용된 빌드 에이전트를 만들어 32비트 응용 프로그램의 릴리스 구성을 컴파일하기 위해 설정된 에이전트를 나타낼 수 있습니다.
같은 빌드 컴퓨터에서 여러 빌드 에이전트를 실행하는 경우 해당 빌드 에이전트는 모두 같은 기능을 가집니다. 따라서 해당 빌드 컴퓨터의 모든 빌드 에이전트에 같은 태그를 적용할 수 있습니다.
빌드 에이전트 기능을 나타내기 위해 태그 사용
다음 표에서는 태그 이름 및 해당 태그 이름으로 나타낼 수 있는 빌드 에이전트 기능 예제를 제공합니다.
빌드 에이전트에 적용할 수 있는 태그 |
빌드 에이전트의 기능 |
|---|---|
x86 |
32비트 응용 프로그램을 컴파일합니다. |
x64 |
64비트 응용 프로그램을 컴파일합니다. |
IIS |
ASP.NET 웹 응용 프로그램을 컴파일한 다음, 빌드 에이전트가 실행되는 빌드 컴퓨터에 호스팅합니다. |
테스트, 스트레스 |
부하 및 스트레스 테스트를 실행하기 위해 Test Professional 2010이 설치된 빌드 컴퓨터에서 실행되는 빌드 에이전트입니다. |
빌드 프로세스의 부하를 분산시키기 위해 태그 사용
태그를 사용하면 팀에서 수행해야 할 빌드 처리 작업의 부하를 분산시킬 수 있습니다. 예를 들어 체크 인 유효성을 검사하는 빌드 정의(체크 인 빌드)가 하나 있습니다. 자세한 내용은 변경 내용의 유효성을 검사하는 제어된 체크 인 빌드 정의를 참조하십시오. 이 빌드 정의는 자주 실행되며 한 번에 하나의 인스턴스만 실행될 수 있습니다. 따라서 고속 다중 코어 프로세서 및 고속 하드 디스크 드라이브와 같은 고성능 하드웨어를 갖춘 빌드 컴퓨터를 설치합니다. 그런 다음 해당 컴퓨터에 빌드 에이전트를 만들고 체크 인 태그를 할당합니다. 이제, 체크 인 태그가 있는 빌드 에이전트에서만 실행되도록 빌드 정의를 설정합니다.
한 팀이 작업하고 있는 우선 순위가 가장 높은 프로젝트의 빌드를 처리하는 다른 빌드 정의(급속 빌드)가 있습니다. 이 특수 프로젝트의 요구 사항에 충족되는 다른 빌드 에이전트를 설정하고 이 에이전트에 FastTrack 태그를 할당한 다음, 이 태그가 있는 빌드 에이전트에서만 실행되도록 빌드 정의를 설정합니다.
클라이언트 컴퓨터의 빌드 에이전트에 태그를 적용하려면
빌드 메뉴에서 빌드 컨트롤러 관리를 클릭합니다.
빌드 컨트롤러 관리 대화 상자가 나타납니다.
태그를 적용할 빌드 에이전트를 클릭하고 속성을 클릭합니다.
빌드 에이전트 속성 대화 상자가 나타납니다.
다음 방법 중 하나를 사용하여 하나 이상의 태그를 적용합니다.
목록에서 하나 이상의 태그를 선택합니다.
새 태그 추가 링크를 클릭합니다. 새 태그 추가 대화 상자에서 적용할 태그의 이름을 입력합니다.
빌드 컴퓨터의 빌드 에이전트에 태그를 적용하려면
수정할 빌드 에이전트를 실행하는 빌드 컴퓨터에 로그온합니다.
시작, 모든 프로그램, Microsoft Team Foundation Server 2010을 차례로 클릭한 다음 Team Foundation 관리 콘솔을 클릭합니다.
Team Foundation 관리 콘솔이 나타납니다.
트리 창에서 서버의 이름을 확장한 다음 Team Foundation Build 노드를 클릭합니다.
빌드 에이전트의 이름 바로 아래에서 속성을 클릭합니다.
빌드 에이전트 속성 대화 상자가 나타납니다.
다음 방법 중 하나를 사용하여 하나 이상의 태그를 적용합니다.
목록에서 하나 이상의 태그를 선택합니다.
새 태그 추가 링크를 클릭합니다. 새 태그 추가 대화 상자에서 적용할 태그의 이름을 입력합니다.
빌드 에이전트 제거
클라이언트 컴퓨터를 사용하거나, 빌드 에이전트를 호스팅하는 빌드 컴퓨터에서 직접 빌드 에이전트를 제거할 수 있습니다.
참고 빌드 에이전트를 제거해도 빌드 컴퓨터에서 Team Foundation Build 서비스가 제거되지는 않습니다.
클라이언트 컴퓨터를 사용하여 빌드 에이전트를 제거하려면
빌드 메뉴에서 빌드 컨트롤러 관리를 클릭합니다.
빌드 컨트롤러 관리 대화 상자가 나타납니다.
제거할 빌드 컨트롤러 또는 빌드 에이전트를 클릭하고 삭제를 클릭합니다.
빌드 컴퓨터에서 빌드 에이전트를 제거하려면
수정할 빌드 에이전트를 실행하는 빌드 컴퓨터에 로그온합니다.
시작, 모든 프로그램, Microsoft Team Foundation Server 2010을 차례로 클릭한 다음 Team Foundation 관리 콘솔을 클릭합니다.
Team Foundation 관리 콘솔이 나타납니다.
트리 창에서 서버의 이름을 확장한 다음 Team Foundation Build 노드를 클릭합니다.
빌드 에이전트의 이름 바로 아래에서 삭제를 클릭합니다.
참고 항목
기타 리소스
변경 기록
날짜 |
변경 내용 |
이유 |
|---|---|---|
|
2011년 5월 |
테스트 실행 방법에 대한 정보를 추가했습니다. |
향상된 기능 관련 정보 |