[GitLab] CentOS 7에 GitLab (ce) 설치하기 - 오프라인(수동) 설치

GitLab 온라인 설치는 이전에 포스팅했었는데, 알 수 없는 이유로 curl 명령을 사용할 수 없어(무응답) 오프라인으로 설치하고자 알아봤던 내용들을 정리한다. 오프라인 설치는 로컬에서 설치 파일을 받아 서버에 넣고 install하는 방식이다. 때문에 인터넷이 되지 않는 서버 환경에서도 설치가 가능하다.

 

---

 

GitLab 오프라인 설치 방법 (CentOS 7)

GitLab 공식 홈페이지에서 자신의 OS(커널) 버전에 맞는 패키지 파일을 다운로드하고 Install하는 과정이다.

 

1) 설치 파일 다운로드

GitLab ce버전 패키지 다운로드 홈페이지에서 자신의 OS 버전에 맞는 파일을 다운로드한다. 만약 자신의 OS 배포판 버전과 호환되지 않는 GitLab 패키지를 가져온 경우 설치 중 Dependency 라이브러리 불일치 또는 미존재로 인해 설치가 불가하다.

• GitLab 패키지 다운로드 링크 : https://packages.gitlab.com/gitlab/gitlab-ce/

gitlab/gitlab-ce - Packages · packages.gitlab.com

 

참고) OS 버전 확인

만약 본인의 OS 버전을 모른다면 서버에 아래 명령어들을 입력하여 확인할 수 있다.

1. 커널 버전 확인

$ uname         # OS 확인(Linux, Windows ...)
$ uname -a      # OS 관련 모든 정보 확인
$ uname -r      # 커널 버전 확인

1. uname

uname 명령 입력시 나온 출력값은 커널 버전.메이저 버전.마이너 버전-릴리즈 버전.배포판 버전이다. 3.10.0-862.el7.x86_64라면 아래와 같다.

• 커널 버전 : 3
• 메이저 버전 : 10
• 마이너 버전 : 0
• 릴리즈 버전 : 862
• 배포판에서 지정한 버전 : el7.x86_64

 

2. Linux 배포판 버전 확인

$ lsb-release -a

lsb-release -a 명령 입력시 '명령을 찾을 수 없습니다' 에러 발생하는 경우 아래와 같이 패키지를 설치한다.

2. lsb_release

설치가 완료되면 파일 내용을 읽어 릴리즈 버전을 확인할 수 있음.

$ cat /etc/redhat-release

3. cat

release 파일을 조회한 결과로 CentOS 버전 정보가 출력되었는데, 7.9.2009를 해석하면 다음과 같다.

• 프로젝트 버전 : 7 (Windows XP, 7, 10, 11과 같음)
• 릴리즈 버전 : 9 (프로젝트 문제점을 개선 또는 최적화하며 부여된 버전)
• 릴리즈 날짜 : 2009 (= 20'20'년 '09'월)

조금 더 상세하게 조회하고 싶다면 release 파일을 모두 읽으면 된다.

$ cat /etc/*release*
CentOS Linux release 7.9.2009 (Core)
Derived from Red Hat Enterprise Linux 7.9 (Source)
cat: /etc/lsb-release.d: 디렉터리입니다
NAME="CentOS Linux"
VERSION="7 (Core)"
ID="centos"
ID_LIKE="rhel fedora"
VERSION_ID="7"
PRETTY_NAME="CentOS Linux 7 (Core)"
ANSI_COLOR="0;31"
CPE_NAME="cpe:/o:centos:centos:7"
HOME_URL="https://www.centos.org/"
BUG_REPORT_URL="https://bugs.centos.org/"

CENTOS_MANTISBT_PROJECT="CentOS-7"
CENTOS_MANTISBT_PROJECT_VERSION="7"
REDHAT_SUPPORT_PRODUCT="centos"
REDHAT_SUPPORT_PRODUCT_VERSION="7"

CentOS Linux release 7.9.2009 (Core)
CentOS Linux release 7.9.2009 (Core)
cpe:/o:centos:centos:7

 

현재 내 서버의 OS 버전(GitLab에서 요구하는 것이 CentOS 배포판 버전)은 el7이므로 ce, el7을 선택해서 다운로드한다.

el7 버전의 ce

 

GitLab 패키지 홈페이지에서 원하는 버전을 클릭하면 우측에 명령어를 이용한 설치 방법이 표시되는데, 네트워크 연결이 필요하다. 나의 경우 curl 명령이 알 수 없는 이유로 먹통이 되어.. 수동 설치를 하기로 했으므로 패스한다.

GitLab Website

만약 온라인 설치를 희망하는 경우 홈페이지에 제시된 대로 아래 명령을 입력하거나

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

이전에 포스팅한 온라인 설치 가이드 참고!

 

3. Requires

GitLab을 이용하기 위해서는 추가 의존성 패키지가 필요한데, 버전을 선택하면 이동되는 홈페이지에 나열되어 있다. 네트워크를 이용해서 설치하는 경우 yum 명령으로 쉽게 가능하나 오프라인으로 설치할 경우 동일하게 바이너리를 찾아 Install해야함. (포스팅이 길어질 것 같아 이부분은 생략)

 

 

2) 설치 파일(rpm) Install

먼저 다운받은 파일(gitlab-ce-15.10.2-ce.0.el7.x86_64.rpm)을 서버에 올린다. 위치는 편의상 홈 디렉토리 아래로 지정하였다. 1-2GB 정도의 작지는 않은 파일이라 시간이 조금 소요되는데, 파일 업로드가 완료되었다면 아래 명령을 입력하여 GitLab을 Install한다.

$ cd {rpm 파일을 업로드한 디렉토리}
$ sudo yum install gitlab-ce-15.10.2-ce.0.el7.x86_64.rpm

저장소에서 패키지를 검색하여 설치하는 것이 아니라, 서버에 업로드한 패키지 파일로 설치하는 것이므로 해당 위치에서 파일명을 확장자까지 정확하게 입력하여 설치해야 한다. 설치하겠냐는 메시지가 뜨면 'y' 입력해 설치를 시작한다.

yum install ypm

 

설치가 완료되면 GitLab 아이콘이 그려진 화려한 터미널을 볼 수 있다.

Install Complete

 

 

3) GitLab 접속을 위한 설정

GitLab 설정은 gitlab.rb 파일을 수정해야 한다.

$ sudo vi /etc/gitlab/gitlab.rb

# external_url 'http://gitlab.example.com' << 주석처리
external_url 'http://{IP}:{Port}'  # GitLab 서버 IP, Port
puma['listen'] = '127.0.0.1'       # 주석 해제
puma['port'] = 9001                # 주석 해제, 원하는 Listen Port

GitLab Setting 1) external_url

GitLab Setting 2) Advanced Settings

 

설정 파일 수정이 완료되었다면 변경점을 반영해야 한다. 많은 메시지와 함께 꽤나 긴 시간이 소요된다.

$ sudo gitlab-ctl reconfigure

gitlab Reconfigured! 메시지가 출력되면 설정 반영이 완료된 것이다.

GitLab Setting Success) gitlab Reconfigured!

 

깃랩 서비스를 재시작한다.

$ sudo gitlab-ctl restart

GitLab Restart

$ sudo gitlab-ctl status

GitLab Status

 

 

4) GitLab 접속

GitLab은 Github처럼 웹에 접속해서 사용하는 방식이다. 다만 서버에 설치하여 직접 관리한다는 점이 차이점!

• GitLab URL : gitlab.rb 파일의 external_url 옵션에 작성한 URL (http://192.168.208.146:9000)

GitLab 접속

 

초기 비밀번호는 서버 내에 파일로 저장되어 있다. (ID : root)

$ sudo cat /etc/gitlab/initial_root_password

# WARNING: This value is valid only in the following conditions
#          1. If provided manually (either via `GITLAB_ROOT_PASSWORD` environment variable or via `gitlab_rails['initial_root_password']` setting in `gitlab.rb`, it was provided before database was seeded for the first time (usually, the first reconfigure run).
#          2. Password hasn't been changed manually, either via UI or via command line.
#
#          If the password shown here doesn't work, you must reset the admin password following https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Password: JVGJ6gama4zo828Y0N2eUYaX0Nr1fGc2z+flDtCATO4=

# NOTE: This file will be automatically deleted in the first reconfigure run after 24 hours.

GitLab 로그인

 

root 계정 비밀번호는 Menu > Admin > Admin Area > Overview > Users > Active > Name > Administrator > Edit 순서로 메뉴를 클릭하여 변경할 수 있다.