다음을 통해 공유

방법: 빌드 정의 만들기

  • 아티클

업데이트: 2007년 11월

Team Foundation Build에서는 빌드 정의를 사용하여 팀 프로젝트의 단일 솔루션이나 솔루션 집합이 빌드되는 조건을 구성합니다. 빌드를 수행하려면 새 빌드 정의를 만들거나 기존 빌드 정의를 사용해야 합니다.

빌드 정의 대화 상자를 사용하여 빌드 정의를 만들 때 여러 가지 옵션을 설정할 수 있습니다. 이러한 옵션에는 빌드 이름, 빌드할 파일의 소스 제어 작업 영역 및 TFSBuild.proj 프로젝트 파일의 위치, 빌드 에이전트, 빌드 보존 정책, 빌드 트리거 등이 있습니다. 기존 MSBuild 프로젝트 파일이 없는 경우 빌드 정의 대화 상자에서 MSBuild 프로젝트 파일 만들기 마법사를 시작하여 빌드 정의에 대한 새 TFSBuild.proj 파일을 만들 수 있습니다. 또한 빌드 에이전트 속성 대화 상자를 시작하여 새 빌드 에이전트를 만들 수도 있습니다.

새 빌드 정의를 만든 후에는 이러한 옵션을 변경할 수 있습니다. 자세한 내용은 방법: 빌드 정의 편집을 참조하십시오.

MSBuild 형식으로 작성된 TFSBuild.proj 파일을 편집하여 빌드 정의를 더 자세히 사용자 지정할 수도 있습니다. 자세한 내용은 Team Foundation Build 사용자 지정을 참조하십시오.

먼저 빌드 정의와 연결된 빌드를 삭제하면 빌드 정의가 제거됩니다. 그러면 빌드 정의 자체를 삭제할 수 있습니다. 자세한 내용은 방법: 빌드 정의 삭제를 참조하십시오.

필수 권한

이 절차를 수행하려면 빌드 관리 보안 권한이 허용으로 설정되어 있어야 합니다. 또한 응용 프로그램 계층 서비스 계정과 Team Foundation Build 서비스 계정에 빌드 저장 위치에 대한 읽기/쓰기 권한이 있어야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.

새 빌드 정의를 만들려면

  1. 팀 탐색기에서 새 빌드 정의를 만들 프로젝트를 선택합니다.

  2. 빌드 메뉴에서 새 빌드 정의를 선택합니다.

    일반이 선택되어 있는 빌드 정의 대화 상자가 나타납니다.

    팁:

    옆에 경고 아이콘이 있는 탭에 입력해야 합니다.

  3. 빌드 정의 이름 텍스트 상자에 빌드 정의와 연결된 이름을 지정합니다.

    고유하고 유효한 Windows 파일 이름을 입력해야 합니다.

  4. 설명 텍스트 상자에 적절한 설명을 추가합니다.

    이 설명은 빌드 "<team project name>" 큐에 대기 대화 상자에 나타납니다. 자세한 내용은 방법: 빌드 정의 큐에 대기 또는 시작을 참조하십시오.

  5. 작업 영역 탭을 클릭합니다.

    작업 폴더 테이블에는 기본적으로 새 빌드 정의를 만들 팀 프로젝트의 소스 제어 폴더와 빌드 에이전트의 로컬 폴더가 포함되어 있습니다. 빌드 에이전트의 로컬 폴더는 로컬 폴더 열에 나열됩니다. 빌드 에이전트의 모든 작업 영역 경로는 표시된 기본 루트 디렉터리와 상대적으로 매핑됩니다.

  6. 작업 폴더 목록에 기존 작업 영역을 복사하려면 기존 작업 영역 복사 단추를 클릭하여 복사할 작업 영역 선택 대화 상자를 시작합니다.

    선택하는 작업 영역은 빌드 에이전트에서 공통 루트 디렉터리의 자식이 됩니다.

    소스 제어 폴더의 빈 테이블 셀을 클릭한 다음 줄임표(…)를 클릭하여 작업 폴더로 추가할 소스 제어 폴더를 찾을 수도 있습니다. 선택하는 소스 제어 폴더도 빌드 에이전트에서 공용 루트 디렉터리로 정규화됩니다.

  7. 프로젝트 파일 탭을 클릭합니다. 프로젝트 파일 창에서 기존 TFSBuild.proj 프로젝트 파일을 찾거나 MSBuild 프로젝트 파일 만들기 마법사를 시작하여 새 TFSBuild.proj 파일을 만들 수 있습니다.

  8. 기존 TFSBuild.proj 파일을 찾으려면 찾아보기를 클릭합니다. 폴더 찾아보기 대화 상자의 TeamBuildTypes 폴더에서 기존 빌드 정의를 선택한 다음 확인을 클릭합니다.

    이제 기존 빌드 정의와 새 빌드 정의 간에 TFSBuild.proj 파일이 공유됩니다.

    TFSBuild.proj 파일이 있으면 프로젝트 파일 창에 찾은 MSBuild 프로젝트 파일: TFSBuild.proj라는 텍스트가 표시됩니다. 프로젝트 파일이 없으면 프로젝트 파일 창에 경고 텍스트가 표시되고 새 MSBuild 프로젝트 파일을 만들라는 메시지가 표시됩니다.

    중요:

    공유된 TFSBuild.proj 파일에서 변경한 내용은 파일을 연결하는 모든 빌드 정의를 사용자 지정합니다. 자세한 내용은 Team Foundation Build 사용자 지정을 참조하십시오.

    빌드 정의에 대한 새 프로젝트 파일을 만들려면 만들기를 클릭합니다. MSBuild 프로젝트 파일 만들기 마법사가 나타납니다.

    1. 빌드할 솔루션 선택 및 순서 지정 페이지에서 빌드할 솔루션을 선택합니다. 솔루션의 순서를 지정하려면 솔루션 하나를 선택하고 목록 오른쪽에 있는 화살표 키를 사용하여 빌드 순서에서의 위치를 변경합니다.

      주의:

      솔루션이 빌드되는 순서를 결정할 때는 솔루션 간의 종속 관계에 유의합니다. 예를 들어, Solution2가 Solution1에 종속된 경우 Solution1이 Solution2보다 먼저 빌드되도록 설정합니다.

    2. 다음을 클릭합니다.

      빌드할 구성 선택 페이지가 표시됩니다.

    3. 빌드할 구성을 선택하십시오. 아래의 표에서 빌드 정의에 포함할 플랫폼과 원하는 구성을 선택합니다. 빌드 구성은 구성과 플랫폼(예: Release 및 Any CPU)을 나타냅니다.

      참고:

      웹 프로젝트의 빌드 정의를 만드는 경우에는 플랫폼 드롭다운 메뉴에서 혼합 플랫폼을 선택합니다.

    4. 다음을 클릭합니다.

      빌드 옵션 선택 페이지가 표시됩니다.

    5. 테스트 실행(예: BVT 실행) 및 코드 분석 실행 확인란을 적절하게 선택하여 사용할 빌드 옵션을 지정합니다. 테스트 실행(예: BVT 실행) 확인란을 선택한 경우 드롭다운 옵션을 사용하여 메타데이터 파일 테스트와 실행할 테스트 목록을 적절하게 지정합니다.

      자세한 내용은 테스트 목록 사용 및 고품질 코드 작성을 참조하십시오.

      중요:

      테스트를 실행하려면 Team Edition for Testers가 빌드 에이전트에 설치되어 있어야 합니다. 코드 분석을 실행하려면 Team Edition for Developers가 빌드 에이전트에 설치되어 있어야 합니다.

    6. 마침을 클릭합니다.

      빌드 정의 대화 상자의 프로젝트 파일 창이 나타납니다. 사용자가 만든 TFSBuild.proj 파일은 소스 제어의 $<Team Project>\TeamBuild Types\<Build Definition Name>\TFSBuild.proj 아래에 저장됩니다.

  9. 보존 정책 탭을 클릭합니다. 빌드 보존 방법 지정 목록에서 실패했거나, 중지되었거나, 부분적으로 성공했거나, 완전히 성공한 빌드에 대한 보존 정책을 선택할 수 있습니다. 드롭다운 목록에서 보존 정책을 선택합니다. <보존할 개수 지정>을 선택한 경우 빌드 수 대화 상자가 나타납니다. 보존할 빌드 수 지정 텍스트 상자에서 지정한 빌드 결과를 보존할 빌드 수를 표시합니다.

  10. 빌드 기본값 탭을 클릭합니다. 빌드 기본값 창의 빌드 에이전트 드롭다운 목록에서 기존 빌드 에이전트를 선택할 수 있습니다. 빌드 에이전트가 없거나 새 빌드 에이전트를 만들려면 새로 만들기를 클릭합니다. 빌드 에이전트 속성 대화 상자가 나타납니다. 표시 이름, 설명 및 컴퓨터 이름 텍스트 상자에 내용을 입력하고 확인을 클릭합니다. 자세한 내용은 방법: 빌드 에이전트 만들기 및 관리를 참조하십시오.

    빌드를 준비하는 공유 위치(예: \\server\share) 텍스트 상자에 UNC(\\server\share) 위치를 입력합니다. 빌드가 완료되는 즉시 빌드된 이진 파일 및 로그 파일이 이 폴더에 배치됩니다.

    참고:

    이 단계를 완료하기 전에 TFSService 계정이 모든 권한을 가진 빌드 에이전트 컴퓨터에 공용 폴더를 만들어야 합니다. Team Foundation 서비스 계정에 대한 자세한 내용은 방법: Team Foundation Server 서비스 보기를 참조하십시오.

  11. 트리거 탭을 클릭합니다.

    1. 요청 시에만 빌드하려면 트리거 창에서 체크 인이 새 빌드를 트리거하지 않음을 선택합니다.

    2. 빌드 정의로 빌드한 파일에 변경 내용을 체크 인할 때마다 계속 빌드하려면 각 체크 인 빌드(빌드가 많은 경우)를 선택합니다.

    3. 롤링 빌드를 만들려면 이전 빌드가 완료될 때까지 체크 인 누적(빌드가 적은 경우)을 선택합니다. 이전 빌드가 완료될 때까지 체크 인 누적(빌드가 적은 경우) 확인란을 선택한 경우 최소 빌드 간격 확인란을 선택하고 분 텍스트 상자에 숫자를 입력하여 빌드 발생 빈도를 표시할 수 있습니다.

      분 텍스트 상자에 유효한 범위는 0부터 2147483647(Int32 MaxValue)까지입니다.

      참고:

      Visual Studio Team System 2008 Team Foundation Server 서비스 팩 1을 사용 중인 경우에는 롤링 빌드 간격을 120분에서 240분 사이로 설정할 수 있습니다. 서비스 팩 1 없이 Visual Studio Team System 2008 Team Foundation Server를 사용 중인 경우에는 Team Foundation Build가 해당 범위의 값을 무시합니다.

    4. 매주 다음 요일에 빌드를 선택하여 예약된 빌드를 만듭니다. 요일이 표시된 확인란을 사용하여 빌드할 각 요일을 선택합니다. 다음 시간에 기본 빌드 에이전트에서 빌드를 큐에 대기 텍스트 상자에 빌드 시간을 입력합니다.

      참고:

      이전 빌드 이후로 변경 내용을 체크 인하지 않은 경우 예약된 빌드 작업이 발생하지 않습니다.

  12. 필요한 모든 정보를 입력했으면 확인을 클릭하여 빌드 정의를 만듭니다.

    만들어진 빌드 정의가 팀 탐색기의 빌드 폴더에 표시됩니다. 서버에 저장된 빌드 정의 관련 정보를 검토하려면 팀 탐색기에서 해당 정보를 마우스 오른쪽 단추로 클릭한 다음 빌드 정의 편집을 클릭합니다. 입력한 정보가 빌드 정의 대화 상자에 표시됩니다. 입력한 정보를 변경할 수도 있습니다. 자세한 내용은 방법: 빌드 정의 편집을 참조하십시오.

    중요:

    다른 빌드와 TFSBuild.proj 파일을 공유하도록 빌드 정의가 지정되어 있으면 빌드 정의 및 그와 연결된 파일이 TeamBuildTypes 폴더 아래에 있는 소스 제어 탐색기에 표시되지 않습니다. 이 경우에는 원래 빌드 정의만 표시됩니다.

참고 항목

작업

연습: Team Foundation Build에서 빌드 정의 만들기

방법: Team Foundation Build 에이전트에 대한 사용 권한 설정

방법: Team Foundation Build 설정 및 설치

연습: 사용자 지정 작업을 통해 Team Foundation Build 사용자 지정

개념

Team Foundation Build 개요

기타 리소스

Team Foundation Build에서 빌드 정의 사용