[DEBIAN] Using Redmine on Debian and Apache server, and Change a theme

프로젝트 관리 프레임워크는 아주 많은 종류가 있습니다.
그 중 Redmine, 즉 Rails로 만들어진 Ruby 기반의 프레임워크에 대해 이야기할까합니다. 간단하게 설치 과정에 대한 이야기로 진행하겠습니다.

Redmine

레드마인(Redmine)은 Ruby on Rails 기반의 Project Manager 및 Bug Tracking Framework입니다. 오픈소스이며 프로젝트 관리, 일정, 그래프 등등 여러가지를 지원하죠. 개인적으로는 UI는 GITHUB나 YOBI가 맘에들지만.. 그래도 Ruby Base란게 가장 큰 매력 포인트인 것 같습니다. (Ruby가 메인이라면!)

Redmine 홈페이지도 redmine 으로 만들어져 있고 테마나 부가기능없이 딱 기본 이미지 그대로 사용하기 때문에 처음 설치하면 http://www.redmine.org/ 과 동일한 화면을 만날 수 있을겁니다.

Install Redmine and passenger module

일단 Apache 서버에 설치하는 걸 기준으로 하기 때문에 Apache2 설치는 되어있다고 가정하겠습니다. 없어도 뭐.. apt-get install apache2로 쉽게 설치 가능하죠.

Redmine 또한 apt 패키지로 지원합니다. 아래와 같이 redmine과 passenger 모듈을 설치해줍니다.

#> apt-get install redmine libapache2-mod-passenger

참 쉽죠?

redmine의 기본 설치 디렉토리는 /usr/share/redmine 이며
rails 프레임워크로 하나 만들었을때랑 같은 구조의 파일이 존재합니다.

마지막으로 bundler를 이용해서 부족한 gem 파일 확인/설치를 진행해줍니다.

#> bundle install 

Run Redmine with Apache server

Redmine 자체는 Rails 의 WEBRick으로도 동작 가능하겠지만.. Apache를 이용해 redmine을 올리는 방법이 좋습니다. (WEBRick 성능이..)

먼저 remine의 public 디렉토리, 즉 ruby 코드 이외에 직접 접근 가능한 파일들이 들어있는(404.html, 500.html 등) 폴더를 apache 디렉토리로 옮겨줍니다.

Debian
#> ln -s /usr/share/redmine/public/ /var/www/redmine

Ubuntu
#> ln -s /usr/share/redmine/public/ /var/www/html/redmine

Debian과 Ubuntu 가 각각 웹 디렉토리 기본 루트가 약간 달라서 둘다 표기하겠습니다.

그다음 passenger.conf 를 수정합니다.
passenger 모듈이 연동에 필요하기 때문이죠.
#> vim /etc/apache2/mods-available/passenger.conf 

<IfModule mod_passenger.c>
  PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
  PassengerDefaultRuby /usr/bin/ruby
  PassengerDefaultUser www-data
</IfModule>

기본으로 들어있는 내용이 있어 저는 Defaultuser만 추가하였습니다.
(PassengerDefaultUser www-data)

다음 Apache에서 redmine 을 읽을 수 있도록 000-default.conf를 수정합니다.
#> vim /etc/apache2/sites-available/000-default.conf

<Directory /var/www/redmine>
 RailsBaseURI /redmine
 PassengerResolveSymlinksInDocumentRoot on
</Directory>
Alias /redmine /var/www/redmine

VirtualHost에 포함 시키시려면 <VirtualHost> 안에 넣어주시면 됩니다.

<VirtualHost *:80>
   ServerAdmin webmaster@localhost
   DocumentRoot /var/www/html
   ErrorLog ${APACHE_LOG_DIR}/error.log
   CustomLog ${APACHE_LOG_DIR}/access.log combined

 <Directory /var/www/redmine>
   RailsBaseURI /redmine
   PassengerResolveSymlinksInDocumentRoot on
 </Directory>
   Alias /redmine /var/www/redmine
</VirtualHost>

<Directory /var/www/redmine> 와 Alias /redmine /var/www/redmine 부분은 자신의 redmine 웹 디렉토리로 지정한 경로를 넣어주시면 됩니다.

apt 설치는 root 설치이기 때문에 Gemfile.lock의 권한을 www-data로 변경하여 줍니다.
#> chown www-data:www-data /usr/share/redmine/Gemfile.lock 

마지막으로 apache2를 재시작해줍니다.

#> service apache2 restart

Open Redmine

이제 준비는 끝났습니다. 브라우저를 열어서 redmine 페이지에 접근하면 아래와 같이 잘 나타납니다.
(http://127.0.0.1/redmine)

Change Redmine Theme

Redmine의 테마를 바꾸는 방법은 아주 간단합니다.
일단 아래 사이트에서 마음에 드는 테마를 하나 선택합니다.

http://www.redmine.org/projects/redmine/wiki/Theme_List

썸네일로 싹 보여주면 참 좋을텐데.. 하나하나 보셔야할거에요.
아무튼 맘에드는 테마를 찾으시면 다운로드 후 Redmine 디렉토리 내 public/themes 에 넣어줍니다.

그다음 서버를 재시작해주면 Redmine 관리 페이지에 테마가 생성됩니다.
관리 >> 설정 >> 표시방식 >> 테마

적용해주시면 다운로드 받은 테마가 Redmine 에 적용됩니다.

Reference

http://pogenhan.tistory.com/26
http://www.redmine.org/
https://ko.wikipedia.org/wiki/%EB%A0%88%EB%93%9C%EB%A7%88%EC%9D%B8
http://pseg.or.kr/pseg/infouse/3070

---

HAHWUL Security engineer, Gopher and H4cker!