모두의 지식 저장고

Gitlab 사용시 자주 사용하는 다양한 명령어 사용법에 대해 작성한 글입니다. 

Gitlab 버전 정보 확인

gitlab-rake gitlab:env:info

gitlab 서비스 상태 확인 

gitlab-ctl status

Gitlab Log 확인

gitlab 사용시 로그 확인 방법에 대해 알아봅니다. 

gitlab 웹 로그 확인 

/var/log/gitlab/gitlab-rails/production.log  에 로그가 남습니다. tail 로 실시간 로그를 확인 할수 있습니다. 

tail -f  /var/log/gitlab/gitlab-rails/production.log

gitlab 서비스 로그 확인 

gitlab-ctl tail 명령을 통해  gitlab 서버에서 남기는 각종 로그를 확인할수 있습니다. 

• gitlab-ctl tail [service 명]
• 서비스명은 gitlab-ctl status 로 확인되는 서비스명입니다. 

gitlab-ctl tail
gitlab-ctl tail postgresql
gitlab-ctl tail ngix

깃랩의 기본 사용 방법에 대해 알아보겠습니다. 

GitLab 그룹 만들기 

• + 버튼 클릭후 New group 버튼을 클릭 합니다. 

• Create group 을 선택 합니다. 

group 생성 화면이 나오면 group name 을  작성 합니다. 

그룹 접근 권한을 설정 설정합니다. 

Visibility Level 

• Private :프로젝트 그룹 권한이 있는 유저만 접근 가능 합니다. 
• Internal:Gilab 사용자 모두 접근 가능 합니다. 
• Public : 접속 계정이 없어도 모두 사용 가능 합니다. 

Inviate another member

• 작업을 함께할 유처를 초대합니다. 

위와 같이 기본 설정을 마치면 아래 화면 처럼 devOpsmini 로 그룹 이 생성 됩니다. 

GitLab User 만들기 

1.일반 사용자 계정 생성

gitlab user 유저를 등록 하기 위해서는 회원? 가입 철차가 필요 합니다. 

Register now 버튼을 누른후 사용자 계정을 만듭니다. 

2.Admin 계정에서 일반 사용자 접속 허용 

gitlab 계정에 등록만 해서는 일반유저가 gitlab 에 접속 할수 없습니다. 

Admin 계정에서 유저 계정에 대한 접속을 승인해주어야 합니다. 

gitlab Memu 버튼 클릭후 Admin 계정에서 일반 유저 생성 계정 접속을 허용해 줍니다. 

• Admin(root)계정 접속 
• Menu ->Admin 클릭 
• Users 매뉴 클릭 후 등록된 사용자 접속 허용 처리 

3.일반 계정 재 접속 진행 

admin(root) 계정에 일반 유저 접속 허용 승인처리가 완료 되었다면 

일제 일반 유저 계정 으로 접속이 가능 합니다. 

4.Admin 계정에서 유저 계정생성 

User 접속 승인 화면을 유심히 보셨다면 파란색 New user 버튼을 보셨을 겁니다. 

해당 버튼을 클릭해서 유저를 만들수  있습니다. 

신규 생성된 유저의 비밀번호는 초기 비밀번호로 셋팅이 되고 

최초 접속시 사용할수 있습니다. 

추후 변경 하면 됩니다. 

GitLab 프로젝트 만들기 

테스할 목적으로 프로젝트를 만들어 보겠습니다. 

저는 게시판 개발 목적의 프로젝트를 만들어 보겠습니다. 

• Create project ->Create blank project 

• 프로젝트 명을 입력하고 프로젝트 접근 허용 범위를 설정 합니다. 

sts-board 라는  이름으로 신규 프로젝트가 생성이 되었습니다. 

이제 개발하고 소스를 관리할 저장소가 생겼습니다. 

clone 버튼을 눌러서 git 레파지토리를 확인하세요 

추후 이클립스와 같은 개발 환경에서 git repository 와 연동 하시면 됩니다. 

GitLab 설치 버전 확인 

Ubuntu 20.04.4 LTS 버전에서 에서 GitLab 설치하는 방법에 대해 알아보겠습니다. 

설치는 우분투 공식 홈페이지 자료를 이용해 설치 하는 내용을 담아 보겠습니다. 

우분투 GiltLab 설치 가이드 (공식)

GitLab 는 EE(Enterprise Edition)  버전과 CE(Community Edition) 버전은로 나뉘는데 EE 버전은 30일 무료 사용후 유료 정책으로 전환 된다고 합니다. 

다만 30일 이후 유료로 전환 하지 않으면 CE 버전으로 자동 전환 된다고 합니다. 

그래서 저는 그냥 EE 버전을 사용해서 30일 이후 CE 버전으로 변경되는지 확인해 보겠습니다. 

GitLab  라이센스 쟁책

• GitLab CE : Core (무료)
• GitLab EE : Core ->STARTER ->  PREMIUM ->  ULTIMATE

GitLab-ee 설치

GitLab-ee 버전 설치하는 방법에 대해 자세히 알아보겠습니다. 

잘따라오시면 쉽게 설치가 가능 합니다. 

1.GitLab dependencies 팩키지 설치 

sudo apt-get update
sudo apt-get upgrade -y

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

sudo apt-get install -y postfix

2.GitLab 팩키지 레파지토리 추가 및 설치

• gitlab 레파지토리 추가

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

• gitlab  설치

sudo apt-get install gitlab-ee

3.GitLab 환경파일 수정 (gitlab.rb)

/etc/gitlab/gitlab.rb 파일을 열어서 external_url 을 변경 합니다. 

해당 url 은 웹에서 접속할 URL 설정입니다. 

• external_url 'http://116.121.154.196:6060'

4.GitLab 환경 파일 적용 및 상태 확인 

gitlab-ctl reconfigure 명령을 통해 환경파일을 재구성 하고 Gitlab 을 재시작 합니다. 

/etc/gitlab/gitlab.rb 파일이 변경 되었다면 gitlab-ctl reconfigure 명령을 수행해야만 적용이 됩니다. 

• gitlab-ctl reconfigure :gitlab 변경 파일 재구성및 재기동 
• gitlab-ctl stop :gitlab 중지
• gitlab-ctl start :gitlab 시작
• gitlab-ctl restart :gitlab 재시작 

gitlab-ctl status 명령으로 현재 gitlab 상태를 확인 합니다. 

웹서버 및 database 가 설치 되었습니다. 

gitlab 웹 접속이 안될때는 항상 상태를 먼저 확인해보세요 

5.GitLab 접속

최초 설치 후 접속시 아래 initial_root_password 라는 파일에 패스워드가 작성됩니다.

• root 접속 패스워드: /etc/gitlab/initial_root_password

external_url 에 설정했던 URL로 접속 합니다. 

접속은 root/[initial_root_password]파일 비밀번호 입니다. 

정상적으로 설치가 되고 접속이 된다면 이제 gitlab 을 사용할 준비가 끝났습니다. 

6.Gitlab 비밀번호 변경 

initial_root_password 를 기억하고 관리 하는 사람은 없겠죠?

마지막으로 root 비밀번호를 변경 하겠습니다. 

우측 상단 계정 관리 버튼을 눌러서 Edit Profile을 설정해서 비밀번호를 변경 합니다. 

관리계정 버튼 클릭 ->Edit Profile -> Password -> 비밀번호 변경 

7.GitLab 삭제 

Gitlab 재설치를 혹은 삭제를 하고자 할경우 사용하세요! 

sudo gitlab-ctl cleanse
sudo gitlab-ctl uninstall
sudo apt remove gitlab-ee
sudo apt purge gitlab-ee


rm -rf  /opt/gitlab 
rm -rf  /var/opt/gitlab 
rm -rf  /etc/gitlab 
rm -rf  /var/log/gitlab