Ubuntu GitLab 설치 및 간단 사용법

팀 내 코드 관리를 위해, GitLab을 서버에 설치하게 되었다. 여기서는 Ubuntu OS에 GitLab을 설치하는 방법과, 간단한 명령어들을 소개한다. 

---

0. GitLab이란 ?

GitLab은 Git을 기반으로 한 웹 기반 DevOps 플랫폼으로, 소프트웨어 개발의 모든 과정을 하나의 애플리케이션에서 관리할 수 있도록 도와주는 도구이다. 단순한 소스 코드 저장소 역할을 넘어서, 다음과 같은 기능들을 제공한다.

• 버전 관리(Git)  - Git을 기반으로 협업과 코드 히스토리를 체계적으로 관리 가능 
• Merge Request & 코드 리뷰  - 팀원들과 코드 변경 내용을 검토하고 병합 가능 
• CI/CD 파이프라인  - GitLab 내에서 자동 빌드, 테스트, 배포까지 설정할 수 있음 
• 이슈 트래킹 & 프로젝트 관리  - 칸반보드, 이슈 관리, 마일스톤 설정 등도 GitLab 내에서 바로 수행 가능 
• 사용자 및 권한 관리  - 팀 단위의 권한 설정, 프로젝트 단위 접근 제어 가능 
• 자체 호스팅 & 클라우드 - gitlab.com에서 클라우드 기반으로 사용하거나, 자체 서버에 설치해 프라이빗하게 운영 가능 

 

1. 업데이트 및 의존성 패키지 설치

sudo apt update
sudo apt upgrade -y

sudo apt install -y ca-certificates curl openssh-server tzdata

 

2. GitLab CE 저장소 추가

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

 

3. GitLab CE Install

sudo apt install gitlab-ce

4. Edit External URL

sudo vi /etc/gitlab/gitlab.rb

external_url 부분을 내가 사용하고자 하는 url 주소로 입력해주면 된다. e.g) https://localhost:10000

변경 후, 다음 명령어를 실행해 GitLab을 재설정해주자. 

sudo gitlab-ctl reconfigure

 

5. Check Status

관련 서비스들이 잘 실행되고 있는지 확인하려면 다음 명령어를 입력하면 된다. 

sudo gitlab-ctl status

 

6. Login GitLab 

External URL로 설정한 주소로 접속하면 로그인 화면이 나오고, 로그인을 하고 나면 다음과 같이 프로젝트를 생성할 수 있는 GitLab 페이지로 넘어갈 수 있다. 

 

(Etc.) Error Fix 

만약 위 과정을 수행하다 설정 파일이 꼬여서 에러가 발생한다면, 다음 명령어들을 입력해보자. 

sudo apt install -f 
sudo dkpg --configure -a 
sudo gitlab-ctl restart

---

1. GitLab 사용자 로그인 허용하기 

처음 GitLab 로그인할 때, 관리자에게 승인을 받아야 한다며 대기 상태에 빠지는 것을 볼 수 있다.

대기중인 사용자들을 확인하려면 GitLab 서버에서 다음과 같이 Console에 접속해야 한다. 

sudo gitlab-rails console

접속까지는 시간이 꽤 걸리며, 콘솔 접속 후 승인 대기중인 사용자들을 확인해보자. 

User.where(state: 'blocked_pending_approval').each do |u|
  puts "#{u.id}: #{u.name} (#{u.username}, #{u.email})"
end

대기중인 사용자 ID를 확인한 후, 해당 사용자에 대해 가입을 승인해주자. 

user = User.find(user_id)
user.activate!

여러명의 사용자에 대해 허용하고 싶다면, 다음과 같이 수행하면 된다.

User.where(state: 'blocked_pending_approval').each do |u|
  u.activate!
  puts "Activated #{u.id}: #{u.name} (#{u.username}, #{u.email})"
end

 

2. GitLab 관리자 비밀번호 얻기

관리자 비밀번호는 다음을 통해 얻을 수 있다.

sudo cat /etc/gitlab/initial_root_password

---

Reference 

[1] [Gitlab] Ubuntu 20.04에 Gitlab CE 설치하기 - 1 (설치 과정)

[2] How To Install and Configure GitLab on Ubuntu