TeamCity VCS 옵션

2026. 1. 5. 14:41

VCS Root

VCS Checkout Mode - 프로젝트 파일이 Agent 에 도달하는 방식 정의

Checkout Directory - Agent 머신에 있는 디렉토리, 작업 디렉토리

CleanBuild - 빌드 전에 Checkout Directory 의 모든 파일을 삭제할지 여부

VCS checkout Mode	설명
recommend	가능한경우 agent, 그 외 server
server checkout	VCS Client 소프트웨어 서버에 설치 → 저장소에 대한 접근 권한을 제어하고 싶을 때 해당 디렉토리에 (.svn / .git 등) 생성되지 않음 Agent 에 마지막 빌드 이후 변경된 파일만 업데이트 → 패치로 보내줌 (서버로 변경사항 push 하지 못함)
agent checkout	VCS Client 소프트웨어 Agent 에 설치 단순한 업데이트 또는 체크아웃 해당 디렉토리에 (.svn / .git 등) 생성됨 Agent 가 직접 가져옴
do not checkout	자동 체크아웃 x / 빌드 스크립트를 통해 해당 디렉터리 사용 디렉터리 만료 기간이 구성되지 않은 경우 자동 정리 x

agent 및 server 체크아웃 모드에선 기본값 8일 동안 사용되지 않거나 용량이 부족하면 디스크에서 자동으로 삭제

아래 옵션은 VCS 가 Git 일 때만 설정되는 옵션

Agent 측 체크아웃 시 사용되는 설정

소스파일을 가져오는데 드는 시간과 디스크 공간을 절약하기 위해 System/git 복사본(Mirror) 생성

TeamCity 는 작업 디렉토리를 업데이트 할 때 이 Mirror를 가리킴

Checkout Policy	설명
Auto	수명이 짧은 Agent 는 shallow clone / 일반적인 에이전트는 use mirrors
user mirrors	작업 디렉토리를 지워도 Agent의 mirror 저장소를 참조하여 빠름
do not use mirrors	작업 디렉토리 안의 .git 에 의존하여 지워지면 느림
shallow clone	필요한 커밋만 깊이 1로 가져온다.

Clean Policy 가 Always 되어있다면 업데이트 후 git clean 을 진행하는데 이 때 Clean files policy 타입들을 정리