[GitLab] CentOS 7에 GitLab (ce) 설치하기 - curl/yum 이용한 온라인 설치

Ubuntu만 사용해오던 내가 입사 이후 CentOS를 계속 다루게 되면서 생각보다 다른 점들이 많았다. 오죽하면 리알못이던 학부생 시절에는 Ubuntu=Linux라고 생각했었음. 회사 제품에 GitLab을 연동해서 형상관리를 하는데, 제공받은 바이너리는 policycoreutils-python-utils 패키지를 필요로하길래 알아보니 CentOS 8 버전 GitLab인 것 같아 새로 받기로 했다.

 

GitLab이란?

GitLab은 깃 저장소, CI/CD(지속적인 통합 및 배포), 이슈 추적/관리, 코드 검토, 보안성 테스트 등의 기능을 갖춘 웹 기반의 오픈 소스 Git 관리자(DevOps 플랫폼)이다. 개인 또는 조직이 Git Repository를 관리하는 데 사용할 수 있다는 점에서 Github과 유사하며 비공개된 Github라고 생각하면 된다.

• Git : 소스 코드 버전 관리 시스템으로 로컬에서 변경 사항을 추적하고 원격 리소스에서 변경 사항을 Push, Pull 가능

 

---

 

 

GitLab 설치 방법 (CentOS 7)

공식 사이트에서 설치 방법을 자세히 소개하고 있으나, 유료 버전인 ee(Enterprise Edition)를 권장한답시고 ee 기준으로 설명하고 있으니 무료 버전인 ce(Community Edition)를 설치하려면 조금 신경써야 한다(설명 페이지로 들어가는 것 조차 어려움). 그래서 다음에 설치할 때 헷갈리지 않으려 포스팅해둠!

• ce(Community Edition) 설치가이드 : https://about.gitlab.com/install/?version=ce 

Download and install GitLab

 

1) 필수 의존성 패키지 설치

curl, policycoreutils-python, openssh-server, perl 해당 4가지 패키지를 설치하고 GitLab 접속을 위해 ssh 서비스 활성화 및 방화벽 설정을 마친다. 로컬에서만 이용할 거라면 ssh, 방화벽 관련 설치 설정은 생략해도 된다.

$ sudo yum install -y curl policycoreutils-python openssh-server perl

$ # Enable OpenSSH server daemon if not enabled: sudo systemctl status sshd
$ # enable로 설정할 경우 서버 부팅시마다 openssh 자동 실행
$ sudo systemctl enable sshd
$ sudo systemctl start sshd

$ # Check if opening the firewall is needed with: sudo systemctl status firewalld
$ # http, https에 대한 방화벽을 해제한 후 firewalld 서비스 재실행
$ sudo firewall-cmd --permanent --add-service=http
$ sudo firewall-cmd --permanent --add-service=https
$ sudo systemctl reload firewalld

메일 서버를 설치한다. 메일 서버는 GitLab에서 사용자 가입 인증이나 관리자에게 Alerts 등 기타 이유로 메일을 보낼 때 사용된다. sshd와 마찬가지로 systemctl에 enable하여 서버 부팅시 자동으로 postfix가 실행되도록 한다.

$ sudo yum install postfix
$ sudo systemctl enable postfix
$ sudo systemctl start postfix

 

2) GitLab Repository를 시스템 원본 목록에 추가

yum 패키지 관리자를 이용하여 GitLab ce를 설치할 것이므로, curl 명령을 입력하여 GitLab Package Repository를 추가한다. (curl은 단순히 패키지의 저장소를 등록하는 것으로, 설치가 되는 것은 아님)

$ curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash

만약 레포를 추가하지 않을 경우 다음과 같이 패키지를 찾을 수 없어 설치가 불가하다.

curl 미수행시 No package available

 

3) GitLab 패키지 설치

yum 도구를 이용하여 GitLab을 설치한다. EXTERNAL_URL 옵션을 입력하면 GitLab 웹사이트에 접속할 URL을 지정할 수 있다. 설치 단계에서는 생략하고 이후 설정 파일을 수정해도 되지만 지금은 이 방법을 이용한다.

$ sudo EXTERNAL_URL="{IP Address}:{Port}" yum install -y gitlab-ce

아래와 같이 자신의 서버 IP와 임의의 포트 번호를 입력하고 설치를 시작한다.

$ sudo EXTERNAL_URL="192.168.208.146:9000" yum install -y gitlab-ce

 

4) GitLab 실행

3번 과정에서 EXTERNAL_URL에 작성한 IP, Port를 웹 브라우저 URL창에 입력하면 GitLab 홈페이지로 접속된다. 최초 접속시 ID는 root, PW는 서버에 파일로 저장되어 있다. 초기 비밀번호이며 변경하여 사용하면 된다.

$ # 초기 비밀번호 조회
$ sudo cat /etc/gitlab/initial_root_password

• root 계정 비밀번호 변경 방법 : Menu > Admin > Admin Area > Overview > Users > Active > Name > Administrator -> Edit

 

---

 

GitLab 설정

GitLab 설정은 서버의 gitlab.rb 파일을 수정하면 된다. (/etc/gitlab/gitlab.rb)

$ sudo vi /etc/gitlab/gitlab.rb

• IP/Port 변경 : vi 편집기에서 /external_url 검색 > external_url 뒤 문자열 수정
  ※ 설치 과정에서 EXTERNAL_URL을 옵션으로 입력하였다면 해당 입력값이 등록되어 있음
• 업로드 파일 용량 변경 : nginx[‘client_max_body_size’] 항목에 '1G', '2G' 등 원하는 용량으로 변경

변경한 설정은 아래 명령을 입력하여 반영해야 한다.

$ sudo gitlab-ctl reconfigure