동일한 시스템에서 다수의 TeamCity 에이전트 실행

빌드 동작의 예측 가능성을 높이고 빌드 간 데이터 충돌을 방지하기 위해 일반적으로 물리적 시스템 또는 가상 머신당 빌드 에이전트 1개만 설치하는 것이 좋습니다. 그러나 동일한 시스템에서 여러 개의 병렬 빌드를 실행하려는 경우 다수의 빌드 에이전트를 설정할 수 있습니다.

이를 설정하려면 평소처럼 첫 번째 빌드 에이전트를 설치합니다. 동일한 시스템에 다음 에이전트를 설치하고 구성할 때 다음 작업을 수행해야 합니다.

  • 다른 OS 사용자 계정을 사용하여 각각의 새 에이전트를 설치합니다. 이를 통해 아티팩트 캐시와 같은 사용자 리소스의 충돌을 방지할 수 있습니다.
  • 다른 로컬 디렉터리에 각 에이전트를 설치합니다.
  • 각 에이전트의 구성 파일(conf/buildAgent.properties)을 조정합니다.
    • 'name' 및 'port'에 대해 고유한 임의의 값을 설정합니다.
    • 에이전트의 자체 작업 디렉터리('workDir') 및 임시 디렉터리('tempDir')에 대한 상대 경로를 지정합니다. 각 에이전트에는 해당 디렉터리의 고유한 개별 사본이 있어야 합니다.
    • 'authorizationToken' 프로퍼티를 지웁니다(값 삭제 또는 제거). 서버 연결 시 에이전트가 해당 토큰을 수신합니다.
    • TeamCity 온프레미스 서버가 리버스 프록시에 설치된 경우 'serverUrl'을 프록시 주소로 설정해야 합니다.

    TeamCity Cloud 사용자는 고유한 에이전트 구성 파일을 자동 생성할 수 있습니다. Agents(에이전트)로 이동하여 화면 오른쪽 상단의 Install Build Agents(빌드 에이전트 설치) 메뉴를 열고 Use authentication token(인증 토큰 사용)을 클릭합니다. Download config(구성 다운로드) 옵션을 선택하고 에이전트 이름(빌드 에이전트 구성의 'name' 속성)을 입력하여 전체 구성 파일을 다운로드합니다. 해당 파일을 빌드 에이전트 디렉터리에 'buildAgent.properties' 파일로 저장하고, 위 설명에 따라 수정합니다.

  • 빌드 단계 및 스크립트에서 에이전트 시스템의 절대 경로가 아닌, 빌드 체크아웃 디렉터리 파일에 대한 상대 경로가 사용되었는지 확인하세요. 필요한 경우 빌드 직전에 항상 VCS 저장소에서 직접 소스를 가져오는 clean checkout(클린 체크아웃) 옵션을 활성화할 수 있습니다.

도움말 문서를 통해 자세한 설치 과정 및 Windows, macOS 시스템과 관련한 중요 정보를 알아보세요.