gitlab 설치

사용자 계정 생성

gitlab 서비스를 구동할 사용자의 계정을 생성한다. 보안을 위해 ssh login 은 막아 놓는다.

gitlab-shell 설치

gitlab-shell 은 ssh 접근 및 git 저장소 관리를 하는 유틸리티이다.  설치는 gitlab 의 저장소에서 git clone 명령어로 설치한다.

1. git 홈 디렉터리로 이동한다.

   cd /home/git

2. gitlab 사이트에서 프로젝트를 복제한다. 버전은 1.9.1 이다

   sudo -u git -H git clone https://gitlab.com/gitlab-org/gitlab-shell.git -b v1.9.1 

3. gitlab-shell 의 설정 파일을 생성한다.

   cd gitlab-shell

   sudo -u git -H cp config.yml.example config.yml

4. config.yml 을 열어서 URL 과 포트를 설치하려는 URL 과 포트에 맞게 수정한다. 기본 포트는 8080 이지만 8080 은 톰캣이 기본 사용하는 경우가 많으므로 우리는 8085 포트를 지정하도록 하자.

   gitlab_url: "http://localhost:8085/" 
   http_settings:
   	self_signed_cert: false

   CODE
   

   gitlab-shell 은 gitlab과 REST API 로 통신하며 gitlab_url 설정은 이때 API 호출시 사용하는 URL이다. 둘 다 동일한 서버에 설치되어 있으므로 URL은 전체 주소 도메인 네임(FQDN) 대신 로컬 호스트와 포트(유니콘이 구동되어 있는)를 바로 지정하는 게 좋다.

   왜냐하면 FQDN 으로 지정하면 웹 서버를 통하게 되며 웹서버는 URL redirect 설정이 있으면 HTTP 302 Found 응답 코드와 새로운 Location 을 전송하는데 gitlab-shell 은 이를 처리하지 않으므로 push 가 실패하게 된다.

5. gitlab-shell 설치 스크립트를 실행하면 설정에 필요한 명령어를 자동으로 실행하고 결과를 출력한다.

   sudo -u git -H ruby ./bin/install
   
   mkdir -p /home/git/repositories: OK
   mkdir -p /home/git/.ssh: OK
   chmod 700 /home/git/.ssh: OK
   touch /home/git/.ssh/authorized_keys: OK
   chmod 600 /home/git/.ssh/authorized_keys: OK
   chmod -R ug+rwX,o-rwx /home/git/repositories: OK
   find /home/git/repositories -type d -exec chmod g+s {} ;: OK

6. gitlab-shell 이 생성한 .ssh 는 SELinux 의 context 가 부여되지 않는다. 이럴 경우 sshd 가 git 홈디렉터리 밑의 .ssh 를 읽지 못해서 외부에서 clone 이나 pull/push 작업이 에러가 발생한다. SELinux context 를 설정하여 문제를 해결하자.

   restorecon -Rv /home/git/.ssh

MySQL DB 설정

gitlab은 MySQL 과 PostgreSQL 을 지원한다. 본서에서는 모든 application 의 DBMS 를 MySQL 로 구성할 예정이므로 MySQL 기준으로 설명하고자 한다. gitlab 설치중에 ruby db 아답터를 컴파일하여 설치하는 과정이 있는데 정상적으로 진행되려면 전장에서 설치한 mysql 개발용 패키지가 필요하다.

1. mysql 클라이언트로 root 계정으로 DBMS 에 연결한다.

   mysql -u root -p

2. gitlab 이 사용할 Database 와 사용자의 계정을 생성하고 Database 에 권한을 부여한다.

   CREATE DATABASE IF NOT EXISTS gitlabhq_production CHARACTER SET utf8 COLLATE utf8_bin;
   GRANT ALL PRIVILEGES ON gitlabhq_production.* TO 'gitlab'@'localhost' IDENTIFIED BY 'secure_password';

   SQL

3. 정상적으로 설정되었는지 mysql client 로 연결해 본다. 다음과 같은 mysql> 프롬프트가 뜨면 정상 설정된 것이다.

   mysql -u gitlab -psecure_password -D gitlabhq_production
   
   

   Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

   mysql>

GitLab 설치

gitlab 소스 복제

1. gitlab 홈 디렉터리로 이동한후 저장소에서 gitlab 소스를 복제한다.

   cd /home/git
sudo -u git -H git clone https://gitlab.com/gitlab-org/gitlab-ce.git -b 6-7-stable gitlab

gitlab config 설정

1. gitlab 소스를 복제한  경로로 이동한후 gitlab 의 예제 설정 파일을 복사한다.

   cd /home/git/gitlab
   sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml

2. 이제 선호하는 에디터로 config/gitlab.yml 을 편집하여 환경을 구성할 수 있다. 수정해야할 항목은 많지 않으며 gitlab 이 사용하는 ruby 로 구현된 Unicorn 이라는 웹서버의 포트(기본값 8080)와 이메일 전송시 주소 정도만 수정하면 된다. 유니콘  웹서버의 포트는 특별한 이유가 없다면 기본 설정을 사용하는걸 권장한다. 우리는 apache httpd 의 mod_proxy 를 이용하여 gitlab 을 사용할 예정이므로 host 명은 localhost 로 설정되어 있어도 사용에 지장이 없다.

   gitlab:
       ## Web server settings
       host: gitlab.example.com
       port: 443
       https: true
   	email_from: gitlab@example.com

   CODE

   host: gitlab 의 도메인명이다. 전체 주소 도메인 네임(FQDN - Fully Qualified Domain Name) 형식으로 작성해야 하며 http:// 나 https:// 는 제외해야 한다. 
   port: git 이 사용하는 포트이다. HTTP 를 사용할 경우 80 으로 설정한다. gitlab 에서 배포하는 아파치 연계용 설정은 클라이언트가 HTTP 로 연결할 경우 mod_rewrite 의 URL 재전송을 통해 HTTPS 로 전환시키게 설정되어 있으므로 이 부분도 수정해야 한다.
   https: gitlab 이 HTTPS 를 사용하는지 여부이다. HTTP 를 사용할 경우 false 로 설정한다.
   email_from :  gitlab 이 공지용 이메일을 보낼때 사용할 주소. 환경에 맞게 수정한다.
   support_email: 지원용 이메일 주소. email_from  과 동일하게 설정한다. 

   
   host 와 port 는 gitlab 에서 저장소를  생성하면 어떻게 연결하는지에 대한 작업 흐름을 보여줄 때 표시되는 URL 과 포트이므로 실제 서비스 URL과 동일하게 설정해야 하며 gitlab-shell 에서 설정한 gitlab_url 과 동일해야 한다.

   

3. 이제 gitlab 계정으로 로그와 임시 디렉터리에 쓸 수 있게 권한을 부여한다.

   
   

   sudo chown -R git log/ tmp/

   sudo chmod -R u+rwX  log/ tmp/

4. satellites 모듈을 위한 디렉터리를 생성한다.

   
   

   sudo -u git -H mkdir /home/git/gitlab-satellites

5. sockets과 pids 기록을 위한 디렉터리를 만들고 gitlab 이 쓸수 있게 권한을 부여한다.

   
   

   sudo -u git -H mkdir tmp/{pids,sockets}

   sudo chmod -R u+rwX  tmp/{pids,sockets}

6. 백업을 위한 public/uploads 디렉터리를 생성한다.

   
   

   sudo -u git -H mkdir public/uploads

   sudo chmod -R u+rwX  public/uploads

7. 유니콘 웹서버 설정을 위해 기본 설정 파일을 복사한다.

   sudo -u git -H cp config/unicorn.rb.example config/unicorn.rb

8. 선호하는 에디터로 config/unicorn.rb 파일을 편집한다. 수정해야 할 부분은 다음과 같다.

   worker_processes 2
   listen "127.0.0.1:8085", :tcp_nopush => true

   worker_processes :  서비스를 처리할 유니콘 워커의 갯수를 지정한다. 기본 워커는 2 지만 많은 부하가 걸리는 서버라면 3 또는 4로 지정한다. worker 를 3으로 지정시 최소  2GB 이상의 RAM 이 있어야 한다. 4GB 이상일 경우 worker 를 4로 지정한다.

   listen  : unicorn 웹서버가 바인딩할 IP 와 포트를 지정한다. 기본 설정은  "127.0.0.1:8080" 이지만 8080 을 사용하는 서비스가 많으므로 우리는 8085로 지정해 보자.  
    

9. Web 을 통한 외부 공격을 막기 위한 프레임워크인 Rack attack 을 설정한다. 

   
   

   sudo -u git -H cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb

10. git user를 위한 git  전역 설정을 한다.

    
    

    sudo -u git -H git config --global user.name "GitLab"

    sudo -u git -H git config --global user.email "gitlab@gitlab.example.com"

    sudo -u git -H git config --global core.autocrlf input

초기 설정

DB 설정

1. MySQL 용 설정 파일을 복사한다.

   sudo -u git -H cp config/database.yml.mysql config/database.yml

2. 편집기로 database.yml 을 열어서 database, db username,  password 항목을 생성한 계정에 맞게 편집한다. 

   production:
     adapter: mysql2
     encoding: utf8
     reconnect: false
     database: gitlabhq_production
     pool: 10
     username: gitlab
     password: "secure_password"

   CODE

Install Gems

루비의 의존성 관리자인 bundle 명령어로 구동에 필요한 Gem 파일을 설치한다. 아래의 명령어는 불필요한 모듈(gitlab 개발/테스트 인스턴스, postgres , 아마존 웹 서비스)를 제외하고 필요한 패키지를 설치한다.

Database 초기화 및 advanced 기능 활성화

이제 데이타베이스의 스키마와 테이블을 만들고 초기 데이타를 입력할 차례이다. 다음 명령어가 정상적으로 수행되면 'Administrator account created:' 메시지와 초기 로그인 id/pwd를 볼 수 있다.

Install Init Script

시스템 부팅시 gitlab 을 자동으로 구동하기 위한 구동 스크립트를 생성한다. 먼저 wget 으로 gitlab 사이트에서 이미 작성한 스크립트를 다운 받아서 service 명령어로 구동할 수 있게 /etc/init.d/gitlab 으로 저장하자.

실행 속성을 부여하고 부팅시 자동으로 구동되게 run level 을 조정한다.

Set up logrotate

gitlab 이 쌓는 로그를 주기적으로 자르기 위해 logrotate 를 설정한다.

이제 설치가 마무리 되었다. 다음 명령어로 현재 설치된 app 의 상태를 확인해 볼 수 있다.

이제 service 명령어로 gitlab 을 구동할 수 있다.

서버의 구동이 끝났으면 gitlab 이 사용하는 asset 파일을 컴파일한다. 시간이 꽤 오래 걸리므로 차를 한 잔 마시면서 기다려 보자.

SELinux 설정

gitlab 이 사용하는 웹서버인 유니콘은 기본적으로 8080 포트를 사용하고 있지만 위에서 8085 로 변경 하였다.

이 포트는 아파치가 연결하도록 허용된 포트가 아니므로 현재 상태에서 mod_proxy 를 설정해도 "Permission Denied" 에러가 발생하며  gitlab의 유니콘 서버에 연결할 수 없다.

이에 대한 해결책중 하나는 아파치가 모든 네트워크 포트에 연결할 수 있게 하는 boolean 인 httpd_can_network_connect  를 1로 설정하는 것이지만 이는 보안상 권장하지 않는다.

대신 아파치가 구동할 때 부여되는 컨텍스트인 http_port_t 에 8085 포트를 등록해 주는게 가장 적절한 해결책이므로 이 방법으로 해결해 보자. 

웹서버와 방화벽 설정

이제 기나긴 설치 여정의 마지막 단계이다. 

apache httpd 설정

미리 설정된 apache 용 gitlab 설정 파일을 다운 받아서 사용하는게 간단하다. 다음 명령어로 설정을 다운받고 기존 설정을 백업한다.

위 설정 파일은 다음과 같은 환경으로 설정되어 있다.

1. gitlab 이 8085 포트로 구동
2. HTTP 는 HTTPS 로 강제 전환
3. HTTPS 사용시 인증서와 개인키는 mod_ssl 패키지에 기본 포함된 localhost.crt 와 localhost.key 파일 사용

8085 외 다른 포트를 사용한다면 에디터의 일괄 변경 기능을 이용하여 변경하자. HTTPS 대신 HTTP 를 사용하겠다면 /etc/httpd/conf.d/gitlab.conf 의 mod_rewrite의 RewriteEngine 을 off 로 설정한다.

RewriteEngine off

그 후에 /home/git/gitlab/config/gitlab.yml 파일의 host, port, https 를 다음과 같이 설정해야 한다. 

 gitlab:
    ## Web server settings (note: host is the FQDN, do not include http://)
    host: gitlab.example.com
    port: 80
    https: false

HTTPS 를 사용할 경우 베리사인(VeriSign)이나 쏘트(Thawte) 같은 회사에서 발급 받은 SSL 인증서를 쓰지 않을 경우 브라우저에서 경고가 발생하며 경고의 강도는 브라우저 종류에 따라 다르다. Internet Explorer 는 경고창을 표시하고 무시하면 다음으로 진행하지만 크롬의 경우 아예 연결을 하지 못한다.

이 문제는 비용을 들여서  인증 기관에서 SSL 인증서를 발급받거나 아니면 자체적으로 루트 인증기관 인증서를 생성하고 이 인증서를 사용자 브라우저마다 신뢰하는 인증 기관으로 설정해 주는 수 밖에는 없다. (openssl 을 활용한 루트 인증서 생성 방법은 http://lesstif.com/x/HoBq 를 참고하자.) 

이제 /etc/httpd/conf.d/gitlab.conf 파일 설정을 마쳤으면 httpd 를 재구동하여 설정을 반영해 보자.

방화벽 설정

apache httpd 설정시  http와 https 포트를 iptables 에서 열었지만 gitlab 을 git+ssh 로 사용할 경우 ssh 서비스도 방화벽을 오픈해야 한다.

lokkit 명령어로 /etc/sysconfig/iptables 를 수정하지 않고 정책을 변경할 수 있다.

이제 서비스 명령어로 변경 내역을 반영하면 된다.

이제 기나긴 gitlab 의 설치가 모두 완료됐다. 브라우저로 연결을 확인하기 전에 정상 설치 여부를 명령어로 확인할 수 있다.

메시지를 통해 정상적으로 설치 여부를 확인할 수 있다. 

 Checking Environment ...
           Git configured for git user? ... yes
           Checking Environment ... Finished
           Checking GitLab Shell ...
           GitLab Shell version >= 1.9.1 ? ... OK (1.9.1)
           Repo base directory exists? ... yes

이제 gitlab 에 최초 로그인할 시간이다. 브라우저를 구동하고 주소창에 우리가 설치한 gitlab(예: gitlab.example.com) 의 주소를 입력하자. 로그인창이 어려운 설치 과정을 헤치고 온 우리를 반겨줄 것이다.