ubuntu

우분투에 GitLab 설치 사용하기 1 [설치]

소화자/ editor

  • 3 comments
  • 8,323 views
  • 2017년 12월 3일

우분투에 오픈소스인 gitlab 커뮤니티 에디션
gitlab-ce를 설치하고 사용법을 알아봅니다.

시작하기 전에


리누스 토발즈가 Git을 만든 후,현재까지 많은 사람들이 Git을 이용하고 있으며,
GitHub는 Git을 바탕으로 Public은 무료, Private은 유료 서비스 정책 으로 수익을 거두고 있으며,
Google도 개발자 소스를 GitHub로 옮기고 있다는 이야기도 들려옵니다.

Enterprize 버젼은 유료이지만, Community 버젼은 Private 서비스 조차 무료인 GitLab을
사용하시는 분들도 점점  늘어가고 있는 것으로 알고 있습니다.

GitLab의 Community 버젼은 완전 오픈소스 라이센스라서 , 과정이 길고 험난하긴 하겠지만
심지어 수정하셔서 제품으로 팔거나,  상업적 서비스를 하셔도 문제가 없는 것으로 알고 있습니다.

사실 큰 프로젝트가 아니면, Git의  버젼 컨트롤 기능보다는  저장소(스토리지) 기능으로
사용하시는 분들이 더 많지 않을까 생각됩니다. (제가 저장소로만 사용 ^^)
익숙해 지시면 생각보다 아주 많이 편리합니다.

Private이라 해도 정서적으로 자료를 외부서버에 저장하고 싶지 않다거나,
Git만 설치해서는 GUI가 없어 맘에 안 드신다거나 등등의 이유를  역동적으로  묶어서
오늘은 Git을 베이스로 한  GitLab Community 버젼,  최신 gitlab-ce를 우분투에  설치하고,
기본 사용법관련 제 경험을 공유하고자 합니다.

GitLab은 문서도 오픈소스치고는 꽤 잘 되어있는 편이어서 , 영어와 눈이 마주쳐도 울렁증 없으시면,
GitLab-CE 도큐먼트 참고 하시면 많은 도움 되실 겁니다.

그럼 달려 보겠습니다.
참고로 제 우분투 버젼은 64비트 14.04 LTS 입니다.

 

설치


설치는 소스 컴파일/옴니버스 방식 2가지가 있는데,  많이 편한 옴니버스 방식으로 해 보겠습니다.
아래 코드대로 진행합니다.( gitlab 사이트 내용 참고 하였습니다)

$ sudo apt-get install curl openssh-server ca-certificates postfix
## postfix는 일단 그냥 No Configuration으로 선택합니다. 
## sudo dpkg-reconfigure postfix 명령으로 언제든지 설정 가능합니다.
$ curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
## Running apt-get update... 메세지 ...약간 시간 걸림
## 메세지 The repository is setup! You can now install packages. 가 보임

$ sudo apt-get install gitlab-ce
## 화면에 노란 별로 그린 마크와 빨간색으로 쓴 GitLab 글자 밑에 
## 메세지로 sudo gitlab-ctl reconfigure 를 실행하라고 알려줌 

$ sudo gitlab-ctl reconfigure
## 화면에 글자들이 올라가면서 잠시 시간 걸림 
## 설정파일 수정 후에는 항상 이 명령을 해주어야 함

$ gitlab-ctl -help 
## gitlab-ctl 명령뒤에 사용할 수 있는 옵션(start..stop..upgrade 등등) 확인

$ sudo gitlab-ctl upgrade
## 그냥 한번 해 보았습니다. 이상하게 동작하면 restart하라는 메세지가 보입니다.

설치가 되고 나면 /etc/gitlab/ 디렉토리에 설정관련 파일(gitlaba.rb)이
/var/opt/gitlab 디렉토리에 gitlab을 구성하는 프로그램 파일과 설정 파일들이,
/opt/gitlab/embedded/service/gitlab-rails/app/views 디렉토리에 프론트-엔드 부분
커스터마이징(합리적 개인적 추측^^) 할 수 있는 파일들이 보입니다.

 

 설정


째끔 폼나게 사용하시려면,  아래와 같은 추가 설정을 해줍니다.
메일보내기(smtp) 설정은 관리자(root)가 사용자 등록을 하고, 자동으로 인증절차 메일이 발송되는 등등의
기능을 사용하지 않을거라면 필요없습니다만, 없으면 격이 많이 떨어 지므로
gitlab-smtp 설정 참고하시어 Gmail로라도 설정하시길 추천 드립니다.

gitlab-smtp 설정 페이지 맨 아래에 smtp 설정 뒤에 터미널에서
gitlab-rails console 명령으로 메일 설정 테스트할 수 있는  부분도  있습니다.

[Gmail의 경우 설정외에 메일계정 로그인하시어 환경설정에서 "전달 POP /IMAP" 메뉴에서
기본적으로 막혀있는 프로토콜을 Open하셔야 연동이 가능합니다.
구글에서 보안관련 메일이 올 수 있습니다.^^]
$ cd /etc/gitlab
## 즐겨 사용하시는 에디터로 gitlab.rb 파일에서 아래 내용(저의 경우) 참고 수정
## ip:port 또는 host:port 식으로  외부접속  URL 설정
external_url 'http://192.168.0.111:9000' 

## 타임 존 맞게 설정
gitlab_rails['time_zone'] = 'Asia/Seoul'

## smtp 부분 설정, 아래 라인 부터 시작
gitlab_rails['smtp_enable'] = true

 

설정 적용 &  재시작

$ sudo gitlab-ctl reconfigure
$ sudo gitlab-ctl restart 
$ sudo gitlab-ctl status
## run: 붙은 메세지가 10개 조금 넘으면 OK! 입니다.

 

접속 테스트


이제 설치와 기본 설정이 끝났으니,  웹 브라우져에서 설정한 IP:포트넘버로 접속하시면
아래와 같이 암호를 설정하라는 화면이 보이실 겁니다.

GitLab 초기 화면[/caption]

8자리 이상 새 암호를 지정하시고, Sign in으로 로그인 하시어
Welcome to GitLab, New Group, New Project 화면이 보이시면 잘 동작하는 것입니다.

이제 나만의 GitHub를 가졌다는 기쁜 마음으로, 이것 저것 메뉴를 눌러보시는,
GitLab서버와 친해지는 시간을 가져봅니다.

마무리


만약 어떤 이유로 삭제 하시고프면

sudo gitlab-ctl stop
sudo gitlab-ctl uninstall

또는

sudo gitlab-ctl stop
sudo apt-get autoremove gitlab-ce

제 개인적 경험으로는 2번째 방법을 추천드립니다

만일 root 암호를 잊어버리셨다면,  root  암호 재설정법 페이지를 참고 하시면 됩니다.
[gitlab-rails console production 명령은 sudo gitlab-rails console production 식으로 sudo를 붙여줍니다]

우분투에 gitlab 설치 사용하기 2 에서 기본 사용법을 알아보도록 하겠습니다.

 

이 글이 누군가에겐 조금이나마 도움이 되었으면 하는 작은 바람입니다.

소화자

존재를 드러내지 않고 무림의 배후를 조정하는 전설로만 전해지는 무엇이든 소화하는... 갑 오징어~^-^

3
Leave a Reply

avatar
2 Comment threads
1 Thread replies
0 Followers
 
Most reacted comment
Hottest comment thread
3 Comment authors
user소화자나그네 Recent comment authors
newest oldest most voted
나그네
Guest
나그네

아직 해보진 않았지만 좋은 정보 감사합니다.
좋은하루 도세요.

user
Guest
user

감사합니다. 덕분에 빨리 설치 했습니다.