TeamCity 설치하기

최근 들어 스프링 배치를 수행하는 Runner로 젠킨스가 최선인가? 라는 의문을 계속 보게 되었습니다.
(비단 배치 수행용이 아닌 배포에서도 마찬가지로)

여러 대안책을 검토 중에 젯브레인 (JetBrains) 에서 만든 Team City가 생각났습니다.

여러 비교글이 있었지만, 결정적 계기는 김영재님의 포스팅 였습니다.

전반적인 포스팅 내용들을 보면서 시작해봐도 괜찮겠다 싶어 별도의 AWS EC2에 설치해서 진행하게 되었습니다.
TeamCity로 시작하고자 하시는 분들은 참고하셔도 좋을것 같습니다.

포스팅은 Windows OS가 아닌 Linux OS에서 진행됩니다.
명령어는 Centos 기반으로 하고 있지만, Ubuntu 역시 비슷하게 사용할 수 있습니다.

1. 환경 확인

일단 Java 8이 설치되어 있어야 합니다.

java -version

확인 후, 아래와 같이 8 버전 이상이면 그대로 진행하시면 됩니다.

openjdk version "1.8.0_222"
OpenJDK Runtime Environment (build 1.8.0_222-b10)
OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)

EC2 기본이 Java7 이라 8 설치가 필요하신 분들은 이전 포스팅 을 참고해보세요.

2. 설치

먼저 TeamCity 다운로드 페이지 에서 다운로드 링크를 가져옵니다.

direct link 를 우클릭해서 링크를 복사합니다.

현재 (2019.09.08 기준) 최신 버전은 2019.1.3 입니다.

wget으로 복사한 링크를 다운 받습니다.

sudo wget https://download.jetbrains.com/teamcity/TeamCity-2019.1.3.tar.gz

다운 받은 tar.gz 파일의 압축을 해제합니다.

sudo tar -xzvf TeamCity-2019.1.3.tar.gz

압축을 해제하면 TeamCity 라는 디렉토리가 생성됩니다.
해당 디렉토리의 내용들을 신규로 생성한 teamcity 디렉토리로 복사합니다.

sudo mkdir /var/lib/teamcity
sudo cp -r /var/lib/TeamCity/* /var/lib/teamcity/

mkdir /var/lib/teamcity
- teamcity를 nginx나 jenkins처럼 관리하기 위해 /var/lib 디렉토리에 신규로 생성합니다.
- /var/lib 권한이 root라서 sudo를 사용합니다.

복사가 다 되셨다면 ./TeamCity 디렉토리와 tar 파일은 삭제합니다. (용량이 커요)

복사가 끝났다면 추가로 하나의 디렉토리를 더 생성합니다.

sudo mkdir /var/lib/teamcity/.BuildServer

.BuildServer
- TeamCity의 Data 들을 담아놓은 별도의 디렉토리입니다.
- 여러 설정들이 담긴 디렉토리로 보시면 됩니다.

여기까지 다 되셨다면 파일 설치는 끝이납니다.
TeamCity를 Linux Service로 추가하기 위해 몇가지 장치를 진행해보겠습니다.

2-1. 사용자 추가

teamcity라는 사용자를 추가해서 모든 실행 권한을 위임하겠습니다.
ec2-user, root 등은 너무 강력한 권한이기도 하고, sudo 권한을 가지고 있어 위험합니다.

그래서 TeamCity 역시 별도의 teamcity 사용자를 생성해서 관리하겠습니다.

nginx, jenkins 역시 설치해서 사용해보시면 각자의 사용자 권한으로 실행하는 것을 확인할 수 있습니다.

아래 명령어를 차례로 입력합니다.

sudo useradd teamcity
sudo chown -R teamcity:teamcity /var/lib/teamcity/

sudo useradd teamcity
- teamcity 사용자를 추가합니다.
sudo chown -R teamcity:teamcity /var/lib/teamcity/
- /var/lib/teamcity/ 를 포함하여 하위 디렉토리, 파일들의 소유 권한을 모두 teamcity 로 변경합니다.
- -R 옵션으로 하위에 있는 모든 디렉토리, 파일을 대상으로 합니다.

현재 상태에서 teamcity 사용자의 Home 위치는 /home/teamcity 입니다.
teamcity 사용자는 항상 teamcity 관련된 내용만 담당할거라 Home 위치를 TeamCity가 설치된 /var/lib/teamcity로 변경하겠습니다.

sudo usermod -d /var/lib/teamcity teamcity

만약 명령어 수행시 다음과 같이 usermod: user teamcity is currently logged in 가 발생한다면 pkill 로 전체 프로세스 제거 후 다시 시도합니다.

pkill -u teamcity

다시 사용되는 프로세스가 있는지 확인 후

ps -ef | grep teamcity

없으면 usermod로 home 변경을 진행합니다.

sudo usermod -d /var/lib/teamcity teamcity

Home이 변경되었다면 teamcity 계정으로 전환 후

sudo su - teamcity

현재 위치를 확인해봅니다.

-bash-4.2$ pwd
/var/lib/teamcity

/var/lib/teamcity 로 되어있는게 확인된다면 정상적으로 완료된 것입니다.

2-2. Service 추가

ec2-user 나 혹은 root와 같이 sudo 권한을 가진 계정으로 전환 후, /etc/init.d/ 에 service를 추가하겠습니다.

teamcity 파일을 생성하시고

sudo vim /etc/init.d/teamcity

아래 코드를 그대로 사용합니다.

#!/bin/bash
### BEGIN INIT INFO
# Provides:          teamcity
# Required-Start:    $local_fs
# Required-Stop:     $local_fs
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: TeamCity
# Description:       TeamCity
### END INIT INFO

TEAMCITY_USER=teamcity
TEAMCITY_DIR=/var/lib/teamcity
TEAMCITY_PATH=$TEAMCITY_DIR/bin/runAll.sh
TEAMCITY_DATA_DIR=$TEAMCITY_DIR/.BuildServer

case $1 in

  start)
    echo "Starting Team City"
    su - $TEAMCITY_USER -c "TEAMCITY_DATA_PATH=$TEAMCITY_DATA_DIR $TEAMCITY_PATH start"
    ;;
  stop)
    echo "Stopping Team City"
    su - $TEAMCITY_USER -c "TEAMCITY_DATA_PATH=$TEAMCITY_DATA_DIR $TEAMCITY_PATH stop"
    ;;
  restart)
    echo "Restarting Team City"
    su - $TEAMCITY_USER -c "TEAMCITY_DATA_PATH=$TEAMCITY_DATA_DIR $TEAMCITY_PATH stop"
    su - $TEAMCITY_USER -c "TEAMCITY_DATA_PATH=$TEAMCITY_DATA_DIR $TEAMCITY_PATH start"
    ;;
  *)
    echo "Usage: /etc/init.d/teamcity {start|stop|restart}"
    exit 1
    ;;
esac

exit 0

### BEGIN INIT INFO ~ ### END INIT INFO
- 없으면 chkconfig 에 추가되지 않습니다.
- 주석이라고 빼시면 안됩니다.
미리 만들어둔 .BuildServer을 환경변수로 사용하여 runAll.sh 스크립트를 실행합니다.
- start, stop, restart 으로 이루어져있습니다.

스크립트 파일 생성을 완료 하셨다면 실행 권한을 추가합니다.

sudo chmod +x /etc/init.d/teamcity

chkconfig 에 teamcity 를 등록합니다.

sudo chkconfig --add teamcity

서비스 등록이 완료 되었습니다.
이제 아래와 같은 service 명령어로 TeamCity를 관리할 수 있게 되었습니다.

sudo service teamcity start

2-3. Nginx 설치 및 연동

TeamCity의 기본 포트는 8111입니다.
80포트로 리버스 프록시, 정적 파일 (css/js/image 등)캐시, Let's Encrypt 를 통한 SSL 등록 등 여러가지 확장 포인트를 가질 수 있도록 Nginx을 설치하겠습니다.

이전 포스팅 의 챕터 3을 보시면 Nginx 설치 방법이 나옵니다.

설치된 Nginx의 nginx.conf 을 열어 아래와 같이 http://localhost:8111 로 프록시 설정을 합니다.

proxy_pass http://localhost:8111;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;

Nginx 를 실행하여 TeamCity로 프록시 되는 것을 확인하셨다면 성공입니다.