촘두네 블로그

최근 새로 설치한 팀시티 빌드 에이전트에서 언리얼 엔진 소스를 체크아웃받아 놓은 폴더가 있었는데, 어느 날 확인 해보니 사라져 있었다.

엔진은 리빌드를 하면 너무 오래 걸리기 때문에 수정된 내용만 컴파일되도록 가급적 건드리지 않는 게 좋은데, 이렇게 사라져 버리면 전체 빌드를 하느라 시간이 많이 걸린다. 

원인을 파악해 보니 예전에도 본 것 같은 기능이 있었는데, 팀시티는 여러가지 이유로 체크아웃 폴더를 삭제하고 다시 받도록 할 수 있는데, VCS 설정이 바뀌거나 디스크 용량이 부족해서 삭제를 하는 것은 당연하지만 아무것도 안 했는데 삭제를 하는 것은 기간만료 기능 때문이다. 약 8일 정도 사용을 안 하면 자동으로 삭제를 한다고 한다.

팀시티 문서 링크: https://www.jetbrains.com/help/teamcity/2024.07/build-checkout-directory.html#Checkout+Directory+Expiration

해당 기능을 끄려면 문서에도 나와 있듯이 두가지 방법 중 하나를 사용하면 된다.

빌드 에이전트 머신으로 들어가서 buildAgent.properties 파일을 찾아서 다음의 속성을 추가한다.

이 방법은 에이전트 머신마다 설정하는 방법이고 해당 에이전트에서 빌드하는 모든 프로젝트에 적용된다.

혹은, 팀시티 프로젝트에서 다음의 속성을 추가한다. (이 방법 추천)

이 방법이 더 나은 거 같다. 원하는 프로젝트나 설정에만 적용할 수 있기 때문이다. 물론 전체 적용을 원한다면 Root project에 한 번만 설정하면 된다.

팀시티 2018.2.3 버전 기준으로 설명하겠습니다.

팀시티 설치파일은 아래의 링크에서 받을 수 있습니다.

https://www.jetbrains.com/teamcity/download/

Download 버튼을 누르면 바로 받을 수 있습니다.

설치파일을 실행합니다.

팀시티가 설치될 PC에 특별한 게 없다면, 모두 기본 옵션으로 설치해도 됩니다.

첫 화면

라이센스 동의 화면

설치 폴더는 기본으로 c:\TeamCity 폴더로 되어 있습니다.

서버와 에이전트를 같이 깝시다.

설치 중...

웹서버 포트가 기본으로 80으로 되어 있는데, 혹시 다른 웹서비스가 이미 구동 중이라면 다른 포트(예: 8080)로 바꿔 주세요.

그냥 Save 누르면 됩니다.

workDir에 대해 잠시 설명 드리자면, 프로젝트 생성시 작업경로를 따로 지정하지 않으면 workDir 쪽에서 임의의 폴더를 만들어서 소스를 다운로드 받고 컴파일 하는 작업을 하게 됩니다. 일부 CI 툴에서는 저 작업 경로를 바꿀 수 없습니다. 하지만, 팀시티에서는 프로젝트 마다 작업폴더를 임의로 지정할 수 있으므로 workDir 경로값은 무시해도 됩니다.

팀시티 구동에 필요한 계정 종류를 선택합니다.

위쪽은 시스템 계정이고, 아래쪽은 유저 계정입니다.

경험상 유저 계정을 사용하는 게 좋습니다.

Git 이나 Subversion 로그인에 필요한 자격증명이나 기타 여러가지 설정을 저장해서 사용해야 된다면, 유저 계정을 사용하는 게 낫습니다.

서비스를 구동할 윈도우 유저 계정의 아이디와 비번을 입력합니다.

서비스를 지금 시작합니다.

설치 작업이 완료되었습니다.

Finish를 누르면 팀시티 웹페이지(예: http://localhost:80)가 뜹니다.

혹시 원격으로 팀시티 홈페이지에 접속하려고 하는데 잘 안된다면, 윈도우즈 방화벽 메뉴에서 인바운드에 새 항목으로 TCP, 80(혹은 8080) 포트를 추가하면 됩니다.

팀시티 웹페이지를 처음 띄운 경우, 몇가지 초기 설정을 해야 합니다.

먼저 데이터 경로를 지정합니다. 기본값 그대로 진행합니다.

DB 선택화면이 나옵니다. MySQL을 선택합시다.

Download JDBC driver 버튼을 누르면 자바 컨넥터를 자동으로 다운로드 받아서 설치합니다.

다운로드가 정상적으로 되었다면 Loaded JDBC driver version: 5.1 이라는 메시지가 뜹니다.

MySQL에서 사용중인 컨넥터는 8.1이지만... 이걸로도 통신은 되므로 그냥 넘어갑시다.

다른 항목의 값은 다음과 같습니다.

Database Host[:port]는 비워놔도 됩니다. (원래는 localhost:3306 입니다.)

Database name은 teamcity 라고 입력합니다. (MySQL에서 생성한 DB 이름)

User name은 root 라고 입력하고요.

Password : MySQL 설치시 사용했던 비번을 입력하면 됩니다.

그 다음에 진행(Proceed)을 누르면 됩니다.

혹시 이 단계에서 다음과 같은 에러가 뜬다면

이전에 사용중이던 DB가 이미 있어서 발생한 문제입니다.

백업이 필요한 DB가 아니라면, MySQL에서 teamcity DB를 지우고(drop) 다시 생성(create)한 후 재시도하면 됩니다. 

만약, 이 단계에서 자바 컨넥터 연결이 잘 안된다는 에러가 뜨면 자바 컨넥터를 수동으로 설치해야 합니다.

일단, 서비스에서 TeamCity를 내리고요.

MySQL에 들어 있는 자바 컨넥터 파일을 Teamcity 폴더로 복사해 줘야 됩니다.

c:\Program Files (x86)\MySQL\Connector J 8.0\mysql-connector-java-8.0.15.jar

=> ​c:\ProgramData\JetBrains\TeamCity\lib\jdbc\

이때, Teamcity폴더에 예전 커넥터 파일이 있다면 삭제해 주세요.

이후 Teamcity 서비스를 다시 구동하고요.

웹페이지를 띄워서 다시 진행하되 Download JDBC driver 버튼은 누르지 마세요.

DB와 정상적으로 연결되었다면 이렇게 나옵니다. 시작 중...

라이센스 동의 화면이 한번 뜹니다.

관리자 계정 생성 화면이 뜹니다.

보통 설치하는 사람이 관리자이므로 본인이 사용할 아이디와 비번을 입력하면 됩니다.

Create Account를 눌러서 생성하면 다음 화면으로 넘어갑니다.

혹시 이 화면이 안 뜬다던가, 이전에 생성한 아이디나 비번을 잊어 버린 경우엔 슈퍼유저로 로그인 하는 방법이 있습니다.

위의 스샷 하단에 나와 있는 거 같은 Login as Super user 이라는 글자를 누르면...

인증 토큰을 입력하라는 화면이 뜹니다.

토큰은 c:\TeamCity\logs\teamcity-server.log 파일에 있습니다.

해당 파일에서 Super user authentication token 라는 걸 찾습니다.

맨 마지막에 나오는 걸 찾은 다음에 옆에 있는 숫자를 복사해서 토큰 입력창에 넣어주면 로그인이 됩니다.

참고 링크 : https://confluence.jetbrains.com/display/TCD18/Super+User

드디어 메인화면에 도달했습니다.

아직 프로젝트 생성이 안되어 있기 때문에, Create project 버튼만 보이고 있습니다.

다음에는 다른 유저 계정 만들기, 프로젝트 설정 백업과 복원, 프로젝트 생성과 관리 방법 등을 다루도록 하겠습니다.

팀시티는 기본 내장 DB의 성능이 안 좋습니다.

그냥 설치해서 사용하면 다른 DB를 사용하라는 경고 메시지가 계속 뜹니다.

그래서 MySQL을 깔아서 같이 사용해 주는 것이 좋습니다.

이번 글에서는 팀시티를 위해 MySQL을 설치하는 법을 설명하겠습니다.

8.0.15 버전 기준으로 설명하겠습니다.

MySQL은 팀시티를 설치할 PC에 같이 설치해 주면 됩니다.

우선 아래의 다운로드 페이지로 갑니다.

https://dev.mysql.com/downloads/installer/

mysql-installer-community-8.0.15.0.msi 를 다운로드 받습니다.

Download 버튼을 누르면 로그인하라는 버튼이 크게 나오는데, 무시하고 아래의 No thanks, just start my download 글자를 눌러서 바로 받습니다.

다운로드 받은 설치파일을 실행합니다.

라이센스 동의 화면이 뜨면 동의하고 넘어갑시다.

설치 타입은 Custom을 고릅니다.

MySQL Servers, MySQL Workbench, Connector/J(자바)를 선택합니다.

서버는 기본으로 필요한 요소이고요.

워크벤치는 DB를 생성하거나 관리/삭제할 때 사용하는 UI 툴입니다.

컨넥터는 팀시티와의 통신을 위해서 필요한 드라이버입니다.

Execute를 누르면 설치를 시작합니다.

설치중...

설치완료

제품 설정을 해야 합니다. Next를 누르고요.

기본 옵션 그대로 Next

기본 옵션 그대로 Next

여기서 포트 번호 3306 이라는 게 중요합니다. 특별한 경우가 아니라면 바꾸지 맙시다.

인증 방법도 기본으로 두고 Next

루트 계정용 비번을 만들어야 합니다. 두번 입력하면 되고요.

아래쪽 유저 계정 추가로 만드는 건 필요없습니다.

그냥 이대로 두면 됩니다 Next

Execute를 눌러서 설정을 적용합니다.

적용이 다 되었습니다. Finish 누르세요.

이 화면 다시 한번 나오는데 그냥 Next 누르세요.

모든 설치가 완료되었습니다.

Finish 누르면 설치 프로그램은 종료되고, 아래처럼 워크벤치가 뜹니다.

MySQL80을 클릭합니다.

아까 입력한 비번을 넣어주고요.

Save password in vault(비번저장) 옵션을 체크하고 OK

DB에 연결된 화면입니다.

이제 팀시티용 데이타베이스를 만들어야 합니다.

create database Teamcity; 까지 입력하고 Ctrl+Shift+Enter를 치면 이 SQL 문장을 실행합니다.

아래쪽에 1 row(s) affected 글자가 뜨면 성공입니다. (순식간에 뜹니다.)

참고로 데이터 베이스를 삭제하는 명령은 drop database {DB 이름}; 입니다.

팀시티 설치과정에서 뭔가 잘못되어 재설치를 해야 될 경우 등에 사용하세요.

왼쪽 패널의 Schemas 탭을 눌러서 teamcity 스키마가 생성된 것을 확인합니다. (대소문자 다른 건 중요하지 않으니 그냥 넘어갑시다)

워크벤치는 이제 종료합니다.

이 상태로 팀시티를 설치하면 팀시티에서 아래와 같은 경고가 뜨기 때문에, 한가지 할 일이 더 남아 있습니다.

c:\ProgramData\MySQL\MySQL Server 8.0\my.ini 파일을 열어서 편집해야 합니다.

innodb_flush_log_at_trx_commit 항목을 찾습니다. 기본값인 1이 지정되어 있을 건데요. 

아래처럼 2로 바꾸고 저장합니다.

innodb_flush_log_at_trx_commit=2

MySQL 서비스를 재시작합니다.