Share via

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

  • 아티클

업데이트: 2007년 11월

이 연습에서는 Team Foundation Build에 대한 빌드 정의를 구성하는 방법을 보여 줍니다. 이 연습을 시작하려면 Team Foundation Build에 대한 몇 가지 기본 지식을 알고 있어야 합니다. 자세한 내용은 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 사용자 지정을 참조하십시오.

  9. 빌드 정의에 대한 새 프로젝트 파일을 만들려면 만들기를 클릭합니다.

    MSBuild 프로젝트 파일 만들기 마법사가 나타납니다.

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

      주의:

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

    2. 다음을 클릭합니다.

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

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

      참고:

      웹 프로젝트의 빌드 정의를 만들려는 경우에는 혼합 플랫폼을 선택합니다.

    4. 다음을 클릭합니다.

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

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

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

      중요:

      테스트를 실행하려면 Visual Studio Test Edition이 빌드 에이전트에 설치되어 있어야 합니다. 코드 분석을 실행하려면 Development Edition이 빌드 에이전트에 설치되어 있어야 합니다.

    6. 마침을 클릭합니다.

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

  10. 보존 정책 탭을 클릭합니다.

    1. 빌드 보존 방법 지정 목록에서 실패했거나, 중지되었거나, 부분적으로 성공했거나, 완전히 성공한 빌드에 대한 보존 정책을 선택할 수 있습니다.

    2. 드롭다운 목록에서 보존 정책을 선택합니다.

      <보존할 개수 지정>을 선택한 경우 빌드 수 대화 상자가 나타납니다.

    3. 보존할 빌드 수 지정 텍스트 상자에서 지정한 빌드 결과를 보존할 빌드 수를 표시합니다.

  11. 빌드 기본값 탭을 클릭합니다.

    1. 빌드 기본값 창의 빌드 에이전트 드롭다운 목록에서 기존 빌드 에이전트를 선택할 수 있습니다.

    2. 빌드 에이전트가 없거나 새 빌드 에이전트를 만들려면 새로 만들기를 클릭합니다.

      빌드 에이전트 속성 대화 상자가 나타납니다.

    3. 표시 이름, 설명 및 컴퓨터 이름 텍스트 상자에 내용을 입력하고 확인을 클릭합니다.

      자세한 내용은 방법: 빌드 에이전트 만들기 및 관리을를 참조하십시오.

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

    중요:

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

    생성된 각각의 빌드는 개별 디렉터리에 저장됩니다. 빌드 컴퓨터를 구성하는 데 사용한 계정에 이 UNC 위치에 대한 쓰기 권한이 있는지 확인해야 합니다.

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

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

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

    3. 롤링 빌드를 만들려면 이전 빌드가 완료될 때까지 체크 인 누적(빌드가 적은 경우)을 선택합니다.

      이전 빌드가 완료될 때까지 체크 인 누적(빌드가 적은 경우) 확인란을 선택한 경우 최소 빌드 간격 확인란을 선택하고 분 텍스트 상자에 숫자를 입력하여 빌드 발생 빈도를 표시할 수 있습니다. 분 텍스트 상자에 유효한 범위는 0부터 2147483647(Int32 MaxValue)까지입니다.

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

      참고:

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

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

    만들어진 빌드 정의가 팀 탐색기의 빌드 폴더에 표시됩니다.

  14. 서버에 저장된 빌드 정의 관련 정보를 검토하려면 팀 탐색기에서 해당 정보를 마우스 오른쪽 단추로 클릭한 다음 빌드 정의 편집을 클릭합니다.

    입력한 정보가 빌드 정의 대화 상자에 표시됩니다. 입력한 정보를 변경할 수도 있습니다. 자세한 내용은 방법: 빌드 정의 편집을 참조하십시오.

    중요:

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

빌드 권한을 설정하려면

  1. 이전에 선택한 빌드 컴퓨터의 시스템 관리자에게 문의하여 Visual Studio Team Foundation Build 서비스가 실행되는 계정 이름을 확인합니다.

  2. 팀 메뉴에서 팀 프로젝트 설정을 선택한 다음 그룹 멤버 자격을 선택합니다.

    프로젝트 그룹 대화 상자가 나타납니다.

  3. 프로젝트 그룹의 그룹 목록에서 Build Services라는 그룹을 찾아 속성을 클릭합니다.

    Team Foundation Server 그룹 속성 대화 상자가 나타납니다.

  4. 멤버 탭을 선택합니다.

    이전 단계에서 얻은 계정이 멤버 목록에 있으면 선택한 빌드 컴퓨터에서 이 빌드 정의를 빌드할 수 있습니다. 그렇지 않으면 다음 단계를 수행합니다.

  5. 멤버 추가 섹션에서 Windows 사용자 또는 그룹을 선택하고 추가를 클릭합니다.

    사용자 또는 그룹 선택 대화 상자가 나타납니다.

  6. 사용자 또는 그룹 선택 대화 상자에서 이 빌드 정의에 사용되는 빌드 컴퓨터의 Visual Studio Team Foundation Build 서비스와 연결된 계정을 입력합니다.

    참고:

    이 빌드 정의가 여러 빌드 에이전트에서 빌드되는 경우에는 모든 Visual Studio Team Foundation Build 서비스 계정을 이 프로젝트의 Build Services 그룹 멤버로 추가해야 합니다.

  7. 빌드 시작/다시 시작 권한을 부여하여 빌드 정의를 실행할 사용자를 구성합니다.

참고 항목

작업

연습: Team Foundation Build에서 빌드 정의 실행

방법: Team Foundation Build 설정 및 설치

방법: 빌드 정의 만들기

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

참조

Start 명령(Team Foundation Build)