Ubuntu(18.04)에 GitLab 설치하고 설정하기

개요

GitLab CE 는 Git 저장소를 호스팅할 수 있는 오픈소스 어플리케이션 입니다. GitLab을 사용하지 않더라도 Git 저장소를 운영할 수 있으나 GitLab은 여기에 사용자를 위한 편의 기능을 제공하여 좀더 간편하게 Git 을 사용할 수 있도록 합니다.

이번 포스트에서는 Ubuntu 18.04 서버에 GitLab을 설치하고 설정해보도록 하겠습니다.

사전준비사항

• Ubuntu 18.04 서버버전을 Oracle VM VirtualBox (버전 5.2.4 r119785 (Qt5.6.2)) 에 설치하였습니다.

설치

관련패키지 설치

본격적인 Gitlab 설치에 앞서, 설치를 하는 동안 사용하게 되는 의존성 있는 프로그램들을 설치하도록 합니다. 이 프로그램들은 Ubuntu 의 패키지 저장소에서 다운로드 받아서 쉽게 설치할 수 있습니다.

다음의 명령을 Ubuntu의 Terminal에 순차적으로 입력합니다.

$ sudo apt-get update
$ sudo apt-get install -y curl openssh-server ca-certificates

다음으로는 공지 메일을 발송할 수 있도록 Postfix 를 설치합니다.

$ sudo apt-get install -y postfix

Postfix 를 설치하는 동안 설정을 위한 화면이 표시됩니다. 이 때, ‘Internet Site’ 를 선택한 후 ‘Enter’ 를 누릅니다. Use your server’s external DNS for ‘mail name’ and press enter. 이후의 화면에서는 기본값으로 설정하기 위해서 enter 를 누릅니다. 아래의 그림을 참고하면 됩니다.

▼ Postfix 설치 1.

▼ Postfix 설치 2.

GitLab 패키지 저장소 추가 및 패키지 설치

GitLab 패키지 저장소를 추가하도록 합니다.

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

다음으로, GitLab 패키지를 설치합니다.

아래의 http://gitlab.example.com 항목은 GitLab 을 접속할 때 사용할 URL 로 변경합니다.

$ sudo EXTERNAL_URL="http://gitlab.example.com" apt-get install gitlab-ce

저의 경우는 외부에서 사용할 것이 아니므로, Domain 이 없습니다. 때문에 VM Machine 의 내부 IP 를 직접 입력하였습니다.

$ sudo EXTERNAL_URL="http://10.0.2.15" apt-get install gitlab-ce

설치가 진행된 후, 설정한 외부 주소로 접속됩니다.

로그인하기

최초 접속시 패스워드 초기화화면으로 이동하게 됩니다. 초기 관리자 계정에 대한 암호를 설정합니다. 이를 완료하면 로그인 화면으로 이동됩니다. 기본 계정의 사용자 이름인 root 를 사용하여 로그인합니다.

▼ GitLab 접속화면

※ 저는 Virtual Box 에 GitLab을 설치하였기 때문에 해당 IP 주소(192.168.142.1)를 입력하여 접속하였습니다. 또한 Virtual Box 외부에서 접속할 수 있도록 Port Forwarding(9999)을 설정하였습니다.

추가

gitlab 설치 후, 설정 변경하기

gitlab 을 설치하는 과정에서 EXTERNAL_URL 을 설정할 수 있었습니다. 혹시 설치가 완료된 후 이 값을 변경하고자 할 경우는 다음과 같이 진행합니다.

1. 예를 들어, 외부접속주소에 포트번호를 추가하고 싶다면 아래와 같이 진행합니다. gitlab.rb 파일을 편집합니다.

$ sudo -e /etc/gitlab/gitlab.rb

2. external_url 항목에 포트번호(9999)를 추가합니다.

external_url  "http://gitlab.example.com:9999"

3. 마지막으로 수정한 내용을 적용합니다.

$ sudo gitlab-ctl reconfigure

참고

• Installation methods for GitLab
• Omnibus GitLab documentation