공식 홈페이지에 설치 가이드가 너무나 잘 나와 있다.
- https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md
아래 글은 거의 대부분 위의 가이드를 따르고 있다.
따라서 해보면서 조금 애매한 부분이거나 개인적인 환경에 맞추기 위해 일부 추가/수정했을 뿐이다.
01. 기본 에디터 설정
- 특이하게도 기본 에디터 설정부터 설명을 해준다. vim을 추천하긴 하는데, 필자같은 경우는 nano가 좋다 ^^
- vim을 사용하실 분들은 아래 설정을 참고하시고, 아니신 분은 그냥 무시 !
$ sudo apt-get install -y vim
$ sudo update-alternatives --set editor /usr/bin/vim.basic
02. 필수 패키지 설치
$ sudo apt-get install build-essential zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libreadline-dev libncurses5-dev libffi-dev curl openssh-server redis-server checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libicu-dev logrotate
03. Python
- 특정 버전의 Python을 요구한다.
$ sudo apt-get install python
$ python --version
- 2.x 버전이 설치되어있으면 OK
- 만약 3.x 버전이 설치되어 있으면 아래와 같은 과정 수행 필요
$ sudo apt-get install python2.7
$ sudo ln -s /usr/bin/python /usr/bin/python2
- 추가적으로 설치해야할 패키지
$ sudo apt-get install python-docutils
04. Git 설치
- v1.7.10 이상의 버전이 필요하다.
- 설치가 필요하다면 다음과 같이 하면 된다.
▷ http://whatwant.tistory.com/643
05. Ruby 설치
- 특정 버전의 Ruby가 필요하다.
$ sudo apt-get remove ruby1.8
$ cd /srv/install/ruby
$ wget
ftp://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p247.tar.gz
$ tar zxvf ruby-2.0.0-p247.tar.gz
$ cd ruby-2.0.0-p247
$ ./configure --disable-install-rdoc
$ make
$ sudo make install
$ sudo gem install bundler --no-ri --no-rdoc
06. 계정 만들기
$ sudo adduser --disabled-login --gecos 'GitLab' git
07. GitLab-Shell 설치하기
$ cd /home/git
$ sudo -u git -H git clone
http://github.com/gitlabhq/gitlab-shell.git
$ cd gitlab-shell
$ sudo -u git -H git checkout v1.7.1
$ sudo -u git -H cp config.yml.example config.yml
$ sudo -u git -H nano config.yml
- URL 부분을 수정해야 한다.
...
gitlab_url: "
http://localhost/"
...
- 설치 진행하자.
$ sudo -u git -H ./bin/install
08. Database
- 필자의 취향으로 일단 PostgreSQL로 진행해보자.
$ sudo apt-get install postgresql libpq-dev
$ sudo -u postgres psql -d template1
# CREATE ROLE git LOGIN ENCRYPTED PASSWORD 'password' NOINHERIT VALID UNTIL 'infinity';
# CREATE DATABASE gitlabhq_production OWNER git;
# \q
- 접속이 잘 되는지 테스트 함 해보자.
$ sudo -u git -H psql -d gitlabhq_production
09. GitLab 다운로드
$ cd /home/git
$ sudo -u git -H git clone
http://github.com/gitlabhq/gitlabhq.git gitlab
$ cd ./gitlab
$ sudo -u git -H git checkout 6-2-stable
10. GitLab 환경 설정
$ cd /home/git/gitlab
$ sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml
- 도메인을 지정하고 싶으면 다음처럼 수정 작업을 하면 된다.
$ sudo -u git -H nano config/gitlab.yml
...
host: localhost
...
- 권한 조정이 필요하다.
$ sudo chown -R git log/
$ sudo chown -R git tmp/
$ sudo chmod -R u+rwX log/
$ sudo chmod -R u+rwX tmp/
- satellites를 위한 디렉토리를 하나 생성하고, 필요한 디렉토리를 만들자.
$ sudo -u git -H mkdir /home/git/gitlab-satellites
- 필요한 디렉토리를 추가로 더 만들자.
$ cd /home/git/gitlab
$ sudo -u git -H mkdir tmp/pids/
$ sudo -u git -H mkdir tmp/sockets/
$ sudo chmod -R u+rwX tmp/pids/
$ sudo chmod -R u+rwX tmp/sockets/
$ sudo -u git -H mkdir public/uploads
$ sudo chmod -R u+rwX public/uploads
- 엄청 귀찮넹... 스크립트로 만들어서 제공하지....
- Unicorn 환경 설정을 진행하자.
$ sudo -u git -H cp config/unicorn.rb.example config/unicorn.rb
- 고성능이 필요하면 cluster mode를 활성화 하자. 방법은 간단하다 ?!
$ sudo -u git -H nano config/unicorn.rb
- worker_processes를 3으로 변경하면 된다 ?!
...
worker_processes 2
...
- 이번에는 Rack attack config를 진행하자.
$ sudo -u git -H cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb
- rack attack middleware를 설정하고 싶으면 다음과 같이 하자.
$ sudo -u git -H nano config/application.rb
- 주석처리된 부분을 찾아서 주석 표시를 지우면 된다고 한다. (뭘 하는지는 아직 모르겠다.)
...
# config.middleware.use Rack::Attack
...
11. 기본 사용자 설정
- Git 사용자 설정을 하자.
$ sudo -u git -H git config --global user.name "GitLab"
$ sudo -u git -H git config --global user.email "
gitlab@whatwant.com"
$ sudo -u git -H git config --global core.autocrlf input
- 위 설정은 다음의 설정에서도 적용이 필요하다.
$ sudo -u git -H nano config/gitlab.yml
12. Database 환경 파일 설정
- PostgreSQL을 사용하는 경우이다.
$ sudo -u git cp config/database.yml.postgresql config/database.yml
- git 계정에서만 읽어볼 수 있게 하기 위한 권한 설정을 하자.
$ sudo -u git -H chmod o-rwx config/database.yml
13. Install Gems
$ cd /home/git/gitlab
$ sudo gem install charlock_holmes --version '0.6.9.4'
- PostgreSQL 사용자들은 다음과 같이...
$ sudo -u git -H bundle install --deployment --without development test mysql aws
14. Database 생성
$ sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production
- 설치과정 끝에 나오는 메시지를 잘 확인해야 한다.
...
Administrator account created:
login............admin@local.host
password.....5iveL!fe
15. Init Script 설정하기
$ sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab
$ sudo chmod +x /etc/init.d/gitlab
$ sudo update-rc.d gitlab defaults 21
16. log 관리하기
$ sudo cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab
17. 환경 설정이 잘 되었는지 점검
- 환경 설정이 잘 되었는지 확인을 해야하는데...
- 우선 우리는 기본 설정값과 다른 git 경로부터 수정하고 확인을 하자.
$ sudo -u nano config/gitlab.yml
...
git:
bin_path: /usr/local/bin/git
...
- git 경로를 제대로 적어주고나서 환경 설정 값들을 확인해보자.
$ sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
18. 시작
- 이후 부터는 재부팅 될 때 자동으로 실행이 되겠지만, 지금은 직접 한 번 실행을 해보자.
$ sudo service gitlab start
Starting the GitLab Unicorn web server...
Starting the GitLab Sidekiq event dispatcher...
The GitLab Unicorn webserver with pid 1478 is running.
The GitLab Sidekiq job dispatcher with pid 1506 is running.
GitLab and all its components are up and running.
19. 상태 점검
- green으로 나오면 좋은 것이다 ^^
$ sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
20. Nginx
- 개인적으로 Apache2의 대용품(?)으로 좋아하다가 요즘은 살짝 관심을 끊은 Nginx ... ^^
- GitLab은 공식적으로 웹서버로 Nginx를 추천한다고 한다.
$ sudo apt-get install nginx
- 설정도 진행을 하자.
$ sudo cp lib/support/nginx/gitlab /etc/nginx/sites-available/gitlab
$ sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/gitlab
- 수정할 것도 있다.
$ sudo nano /etc/nginx/sites-available/gitlab
...
server_name localhost;
...
- 재시작 !
$ sudo service nginx restart
21. 사이트 테스트
- [ http://localhost/ ] 접속
- ID / Password = [ admin@local.host / 5iveL!fe ]
- 패스워드 재설정 창이 나온다.
- 여기에서 재설정을 하면 다시 로그인 창이 나온다. 다시 로그인을 하면 된다.
- 드디어 제대로 된 화면이 나왔다 !!!
헥헥... 너무 힘들다.... 이거, 반드시 스크립트 제공해줘야 한다 !!!
여하튼 일단 페이지 빵! 뜨는 것 까지는 성공~
