이전에 다루었던 Redmine과 함께 회사에서 소스관리툴로 GIT을 많이 사용하고 있다.
Redmine으로 이슈 트래킹을 하고 작업한 소스는 GIT을 통해서 관리하면 아무래도 보다 효율적인 회사 산출물 관리가 가능하다. 하지만 GIT은 개인사용자 이외 회사가 사용하려면 비용이 발생할 수 밖에 없다. 그러면 소규모 회사 또는 소규모 단체의 경우에 추가적인 비용이 발생되므로 사용이 어려울 수 밖에 없다.
그래서 소규모 랩이나 업체에서는 무료로 사용할 수 있는 GITLAB 커뮤니티 버전을 이용하여 GIT 서버 환경을 구축할 수 있다. 독자가 회사에 들어가서 직접 GIT 서버를 관리하는 경우는 드물겠지만, 회사에서 체계를 구축하는 업무를 어쩔수 없이 맞이하였을 때 도움이 될 수 있도록 설치방법과 간단한 사용방법에 대해서 알려드리고자 한다.
이 문서도 미리 작성되어있는 문서에서 설치과정만 요약한 정리본이다.
0. 준비사항
- 필자는 Windows가 설치된 PC에 VMware를 설치 후 Ubuntu 18.04를 게스트OS로 구동하여 설치를 진행 하였다.
- 사용하는 Guest OS는 인터넷 연결이 가능하여야 한다.
1. GITLAB 및 참조패키지 설치
(1) 참조 패키지 설치
$ sudo apt-get install curl openssh-server ca-certificates postfix |
설치 중 메일서버와 관련된 설정인 Postfix Configuration 화면이 표시되면 No configuration을 선택한다.
(다음항목을 선택하려면 TAB을 누르면 아래의 선택 항목으로 내려갈 수 있다.)
(2) GITLAB 패키지 저장소 추가
GITLAB을 다운로드 받기위한 저장소를 추가한다.
$ curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash |
(3) 추가된 저장소 업데이트
$ sudo apt-get update |
(4) GITLAB Community Edition 설치
Gitlab EE는 상용버전이므로 무려버전인 Gitlab CE를 설치한다.
$ sudo apt-get install gitlab-ce |
정상적으로 설치가 완료되면 다음과 같은 표시가 터미널에 출력된다.
2. GITLAB 설정
(1) 초기 설정 진행
$ sudo vim /etc/gitlab/gitlab.rb |
해당 설정 파일에서 다음과 같이 사용할 서버의 IP와 포트를 지정한다. (24번 라인)
19 ## GitLab URL 20 ##! URL on which GitLab will be reachable. 21 ##! For more details on configuring external_url see: 22 ##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab 23 #external_url 'http://gitlab.example.com' 24 external_url 'http://192.168.0.51:19090' |
다음은 gitlab workhorse 설정을 진행한다.
675 ################################################################## 676 ## GitLab Workhorse 677 ##! Docs: https://gitlab.com/gitlab-org/gitlab-workhorse/blob/master/README.md 678 ################################################################## 679 680 # gitlab_workhorse['enable'] = true 681 # gitlab_workhorse['ha'] = false 682 # gitlab_workhorse['listen_network'] = "unix" 683 # gitlab_workhorse['listen_umask'] = 000 684 # gitlab_workhorse['listen_addr'] = "/var/opt/gitlab/gitlab-workhorse/socket" 685 # gitlab_workhorse['auth_backend'] = "http://localhost:8080" 686 gitlab_workhorse['auth_backend'] = "http://localhost:8081" |
그리고 unicon 관련 설정을 진행한다.
741 ################################################################### 742 ## GitLab Unicorn 743 ##! Tweak unicorn settings. 744 ##! Docs: https://docs.gitlab.com/omnibus/settings/unicorn.html 745 ################################################################## 746 747 # unicorn['enable'] = true 748 # unicorn['worker_timeout'] = 60 749 unicorn['worker_timeout'] = 60 750 ###! Minimum worker_processes is 2 at this moment 751 ###! See https://gitlab.com/gitlab-org/gitlab-foss/issues/18771 752 # unicorn['worker_processes'] = 2 753 754 ### Advanced settings 755 # unicorn['listen'] = 'localhost' 756 # unicorn['port'] = 8080 757 unicorn['port'] = 8081 758 # unicorn['socket'] = '/var/opt/gitlab/gitlab-rails/sockets/gitlab.socket' 759 # unicorn['pidfile'] = '/opt/gitlab/var/unicorn/unicorn.pid' 760 # unicorn['tcp_nopush'] = true 761 # unicorn['backlog_socket'] = 1024 |
(2) 설정 적용
변경한 설정을 적용하기 위해서 설정을 갱신하고 Gitlab Ctrl을 재시작한다.
$ sudo gitlab-ctl reconfigure $ sudo gitlab-ctl restart |
2. GITLAB 동작 확인
호스트에서 GITLAB이 정상적으로 동작하는지 확인한다. 확인 방법은 터미널에서 firefox를 실행하여 GITLAB을 실행시키거나 혹은 가상머신의 메뉴에서 FireFox를 실행하여 시스템 IP에 접속하면 된다. 또는 외부 접근을 확인하려면 windows의 인터넷 브라우저를 이용하여 주소를 입력하고 접속하면 된다.
(1) 호스트에서 실행
터미널에서 아래와 같이 firefox 명령 뒤에 로컬(시스템 자신) 주소를 입력한다.
$ firefox localhost:19090 |
(2) 외부에서 실행
Windows에서 커스텀 OS의 가상머신 ip를 웹부라우저에서 입력한다.
(3) 관리자 패스워드 지정
gitlab에 관리자 패스워드가 등록되어있지 않으면 관리자 패스워드 생성 화면이 표시된다. 잊어버리지 않을 정도의 암호를 지정한다.
다음 게시물에서는 GITLAB을 프로젝트를 생성하고 사용하는 방법에 대해서 이야기 하도록 하겠다.
# GITLAB 설치 종료...
최근댓글