쉬는 동안 뭔가 재밌는 일이 없을까.. 궁금해하던 차에 전에 있던 회사에서 나름 괜찮게 사용했던 redmine과 사용해볼 기회가 없었던 git을 연동해서 프로젝트를 관리해보는 방법을 익혀보기로 했다.


수많은 삽질 후에 정리해두는 차원에서 적어보기로 한거라.. 혹시나 이 블로그를 보고 질문할 사항은 Google 신에게 여쭤볼 것을 권한다. (나는 내 블로그에 자주 들어오지 않는 관계로.. ㅋ)


1. SSH 설치하기

이미 설치되어 있다면 당연히 이 과정은 생략해도 무방하다.

root $ apt-get install ssh


2. LAMP 설치하기

Redmine을 설치하기 전에 먼저 기본이 되는 아파치 서버와 MySQL을 먼저 설치해야 한다.

apt 를 이용한 패키지로 설치해도 되지만 일단 손쉽게 설치하기 위해 tasksel을 이용하여 LAMP (Linux Apache MySQL PHP)를 설치하도록 한다.

root $ apt-get install tasksel

root $ tasksel install lamp-server

root $ apt-get install libmysqlclient-dev libmagickcore-dev libmagickwand-dev

위 과정에서 MySQL root 패스워드를 물어본다. 적당한걸로 하자.

사실 여기까지는 기존에 있는 것이 있다면 그냥 쓰면 된다.


3. Redmine 및 Gitolite 사용자 추가하기.

여러번의 삽질 끝에 가장 관리하기 편한 방법이라고 생각되는 것이 각 계정 사용자를 통한 관리였다.

그래서 Redmine 과 Gitolite 사용자를 추가하여 관리하는 방식으로 처리하도록 하겠다.

root $ adduser --system --shell /bin/bash --gecos 'Git Administrator' --group --disabled-password --home /opt/gitolite git

root $ adduser --system --shell /bin/bash --gecos 'Redmine Administrator' --group --disabled-password --home /opt/redmine redmine

어차피 사용자 계정도 아니므로 /opt 디렉토리에 홈을 생성하는 방식을 취한다.


4. Redmine 설치.

Redmine을 설치하기 위해서는 RVM (Ruby Version Manager)를 설치하여 시스템에 영향을 끼치지 않는 방향으로 진행하도록 한다.

root $ apt-get install curl

root $ su - redmine

redmine $ curl -L https://get.rvm.io | bash


이후, /opt/redmine/.profile 파일을 수정하여 다음과 같이 환경변수를 적용한다.

# set PATH so it includes rvm bin if it exists

if [ -d "$HOME/.rvm/bin" ] ; then

  PATH="$PATH:$HOME/.rvm/bin"

fi


if [ -s "$HOME/.rvm/scripts/rvm" ] ; then

  source "$HOME/.rvm/scripts/rvm"

fi


if [ -s "$HOME/.rvm/scripts/completion" ] ; then

  source "$HOME/.rvm/scripts/completion"

fi


Ruby를 설치하기 전에 편의를 위해 다음과 같은 내용을 /etc/sudoers에 추가하도록 하자.

이 과정을 생략하게 되면 설치시 퍼미션 문제로 설치가 정상적으로 수행되기 어렵다.

root $ visudo

# 인스톨 완료후 삭제해야 할 필드.

redmine ALL=(ALL)           NOPASSWD:ALL


# add redmine + git permission

www-data ALL=(git)      NOPASSWD:ALL

www-data ALL=(redmine)  NOPASSWD:ALL

git      ALL=(redmine)  NOPASSWD:ALL

git      ALL=(www-data) NOPASSWD:ALL

redmine  ALL=(git)      NOPASSWD:ALL

redmine  ALL=(www-data) NOPASSWD:ALL


# If you have the requiretty set in the Defaults directive

Defaults:www-data !requiretty

Defaults:git     !requiretty

Defaults:redmine !requiretty


위 과정을 마치고 이제 Ruby를 설치하도록 하자.

root$ su - redmine

redmine$ rvm install 2.0.0-p247


제법 오래 걸렸다. 이제 드디어 Redmine을 설치하도록 하자. Redmine 역시 우분투 패키지로 설치하지 않는다. Redmine에서 배포하는 녀석을 설치하도록 하자. 

redmine $ wget http://www.redmine.org/releases/redmine-2.3.4.tar.gz

redmine $ tar xvzf redmine-2.3.4.tar.gz

redmine $ mv redmine-2.3.4/* .

redmine $ rm -rf redmine-2.3.4*


이제, MySQL에 사용자와 데이터베이스를 등록하도록 하자. 사용자는 redmine, 비밀번호도 redmine이다. 비밀번호를 변경하고 싶을 경우 아래의 붉은색으로 칠해진 부분을 원하는 비밀번호로 설정하면 된다.

redmine $ mysql -u root -p

mysql> CREATE DATABASE redmine CHARACTER SET utf8;

mysql> CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'redmine';

mysql> GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';


Redmine의 설정파일을 수정하도록 하자.

redmine $ cd /opt/redmine/config

redmine $ cp database.yml.example database.yml

redmine $ cp configuration.yml.example configuration.yml

각각의 파일의 내용은 다음과 같다.

/opt/redmine/config/database.yml

production:

  adapter: mysql2

  database: redmine

  host: localhost

  username: redmine

  password: "redmine"

  encoding: utf8


development:

  adapter: mysql2

  database: redmine_development

  host: localhost

  username: redmine

  password: "redmine"

  encoding: utf8


test:

  adapter: mysql2

  database: redmine_test

  host: localhost

  username: redmine

  password: "redmine"

  encoding: utf8

/opt/redmine/config/configuration.yml

# 메일 설정. (Ex. gmail)

default:

  email_delivery:

    delivery_method: :smtp

    smtp_settings:

      enable_starttls_auto: true

      address: smtp.gmail.com

      port: 587

      domain: smtp.gmail.com

      authentication: :plain

      user_name: "wtf@gmail.com"

      password: "what the freak"


# 첨부파일 설정

  attachments_storage_path: /opt/redmine/files

# git 설정

  scm_git_command: /usr/bin/git


위 설정까지 마친 후 Redmine과 연동할 plugin assets 디렉토리를 미리 생성한다.

redmine $ cd ~

redmine $ mkdir public/plugin_assets


자 이제 Redmine 설치준비가 대략 끝났다. 이제 설치하자.

redmine $ gem install bundler

redmine $ bundle install --without development test postgresql sqlite rmagick

redmine $ rake generate_secret_token

redmine $ RAILS_ENV=production rake db:migrate

redmine $ RAILS_ENV=production rake redmine:load_default_data

마지막 명령 수행 후 언어를 설정하는 부분에서 한국어(ko)를 선택하면 된다.


5. Redmine + Gitolite 연계

Gitolite와 연계를 하기 위해서는 먼저 Gitolite의 관리자를 Redmine이 하기 위해 공개키를 생성해야 한다. 그러기 위해서 다음과 같은 일을 수행하도록 하자.

redmine $ mkdir ~/.ssh

redmine $ cd ~/.ssh

redmine $ ssh-keygen -t rsa -N '' -f gitolite_admin_id_rsa

redmine $ ls

gitolite_admin_id_rsa  gitolite_admin_id_rsa.pub

redmine $ ln -s gitolite_admin_id_rsa id_rsa

위와 같이 두개의 파일이 생성되어 있을 것이다.


Redmine에 Gitolite와 연계할 plugin인 redmine_git_hosting plugin을 설치하도록 하자.

redmine $ sudo apt-get install git git-core gitolite

redmine $ cd /opt/redmine/plugins

redmine $ git clone https://github.com/jbox-web/redmine_git_hosting.git

redmine $ git clone https://github.com/jbox-web/redmine_plugin_views_revisions.git

redmne $ cd ~

redmine $ bundle install

redmine $ RAILS_ENV=production rake redmine:plugins:migrate

redmine $ RAILS_ENV=production rake redmine:plugins:process_version_change

redmine $ rake redmine_git_hosting:install_scripts RAILS_ENV=production WEB_USER=redmine

이로써 Redmine 설치와 관련된 패키지들은 모두 설치가 된 상태이다.


이젠 Gitolite에 대한 설정을 수행하도록 하자.

redmine $ sudo dpkg-reconfigure gitolite

======= 다음의 사항을 입력한다.

user: git

repos path: /opt/gitolite

admin ssh-key: /opt/redmine/.ssh/gitolite_admin_id_rsa.pub

======= 입력 끝.

redmine $ ssh -v git@localhost

....

hello admin, this is gitolite 2.2-1 (Debian) running on git 1.7.9.5

the gitolite config gives you the following access:

     R   W gitolite-admin

    @R_ @W_ testing

....

위와 같이 표시가 된다면 설정이 잘 된 것이다.


6. Apache mod_passenger 설치 및 실행.

Apache를 통해 서비스 하는 것이 아무래도 관리하기가 편하다. Ruby로 개발된 Redmine을 동작시키기 위해서는 mod_passenger 라는 Apache 확장 모듈이 필요하므로 해당 모듈을 설치해서 적용하도록 하자.

redmine $ gem install passenger

redmine $ sudo apt-get install libcurl4-openssl-dev libssl-dev zlib1g-dev apache2-prefork-dev libapr1-dev libaprutil1-dev

redmine $ passenger-install-apache2-module

이제 컴파일이 시작된다. 물어보는 단계에서는 그냥 엔터치면 된다.


마지막에 나오는 내용이 매우 중요하다. 해당 내용은 아마 다음과 같을 것이다.

--------------------------------------------

The Apache 2 module was successfully installed.


Please edit your Apache configuration file, and add these lines:


   LoadModule passenger_module /opt/redmine/.rvm/gems/ruby-2.0.0-p247/gems/passenger-4.0.33/buildout/apache2/mod_passenger.so

   PassengerRoot /opt/redmine/.rvm/gems/ruby-2.0.0-p247/gems/passenger-4.0.33

   PassengerDefaultRuby /opt/redmine/.rvm/wrappers/ruby-2.0.0-p247/ruby


After you restart Apache, you are ready to deploy any number of web

applications on Apache, with a minimum amount of configuration!


Press ENTER to continue.


자 이제 위 내용을 Apache 설정에 적용하도록 하자. (파일이 없으면 생성하고, 있으면 수정하면 된다.)

/etc/apache2/mods-available/passenger.load

LoadModule passenger_module /opt/redmine/.rvm/gems/ruby-2.0.0-p247/gems/passenger-4.0.33/buildout/apache2/mod_passenger.so

/etc/apache2/mods-available/passenger.conf

<IfModule mod_passenger.c>

    PassengerRoot /opt/redmine/.rvm/gems/ruby-2.0.0-p247/gems/passenger-4.0.33

    PassengerDefaultRuby /opt/redmine/.rvm/wrappers/ruby-2.0.0-p247/ruby

    PassengerDefaultUser www-data

</IfModule>

붉은색 내용이 추가된 내용이니 잊지 말고 추가하자.


마지막으로 아파치 설정을 다음과 같이 하도록 하자.

redmine $ sudo su -

root $ cd /var/www

root $ ln -s /opt/redmine/public redmine

/etc/apache2/sites-available/redmine

RailsBaseURI /redmine

PassengerUserSwitching on

PassengerUser redmine

PassengerGroup redmine


모든 설정이 끝났으면 이제 적용하고 재시작 하도록 하자.

root $ a2enmod passenger

root $ a2ensite redmine

root $ service apache2 restart


Maybe source will be with you.

저작자 표시 비영리 동일 조건 변경 허락
신고
Posted by miro


티스토리 툴바