Redmine + Git

1. Redmine?

Redmine은 여러 Platform과 Database를 지원하는, Project 관리를 위한 Open-source Web Application입니다.

Redmine은 다음과 같은 기능을 지원합니다.

• 여러 Project 생성 가능
• Issue(Bug) 관리 System
• Gantt Chart와 Calendar 지원
• News, 문서, File 관리, Wiki, Forum 지원
• SCM과 Project 통합 (SVN, CVS, Git, Mercurial, Bazzar, Darcs)

개인적으로 생각하기에 MS Project와 같은 상용 Project 관리 Tool 보다는 부족한 기능을 갖고 있지만, 비교적 규모가 작은 Project를 RAD로 개발하는 경우에 유용한 것 같습니다. 특히 Eclipse의 Mylyn Plugin과의 연동은 개발자를 행복하게 만들어 줍니다.

Redmine의 보다 자세한 기능을 알기 원한다면 http://m.redmine.org에서 Demo 계정을 통해 관리자 권한으로 접속하여 사용해 보기 바랍니다.

2. 설치

Redmine은 Web Application이기 때문에 Web Server를 먼저 구축한 다음, Redmine을 설치해야 합니다. 설치하는 방법은 다음과 같습니다.

2.1. LAMP 설치

Ubuntu를 설치한 System를 Web Server로 만들기 위해 LAMP(Linux, Apache, MySQL, PHP) Stack을 설치합니다. 다음과 같이 Terminal에서 입력합니다.

1 2	$ sudo apt-get install tasksel $ sudo tasksel install lamp-server

Setting up MySQL root password

설치 중간에 위와 같은 화면이 나오면 MySQL의 관리자 계정에 대한 Password를 입력하고, 확인을 위해 한번 더 입력하면 됩니다.

2.2. Redmine 설치

Web Server는 LAMP Stack을 통해서 간단히 설치했으니, 이제 Redmine을 설치해 봅시다.

Ubuntu Repository에도 Redmine Package가 존재하지만 Version이 낮기 때문에, 최신의 Redmine을 설치하기 위하여 Launchpad PPA를 사용합시다. Terminal에서 다음과 같이 입력합니다.

• Precise Pangolin 12.04 이하의 경우:

  1 2 3

  $ sudo add-apt-repository ppa:ondrej/redmine $ sudo apt-get update $ sudo apt-get install redmine redmine-mysql

• Quantal Quetzal 12.10의 경우: PPA가 아직 지원되지 않습니다. Repository의 1.x version을 설치합니다.

  1	$ sudo apt-get install redmine redmine-mysql

Using dbconfig-common

설치 도중에 위와 같은 화면이 나오면 dbconfig-commmon을 사용하여 DB를 설정하기 위해 예를 선택하고 Enter를 누릅니다.

Setting up Redmine's DB type

Redmine에서 사용할 DB의 종류를 선택하는 화면에서 mysql을 선택하고 확인을 누릅니다.

Input MySQL root password

LAMP Stack을 설치할 때 입력했던 MySQL 관리자 계정의 암호를 입력합니다.

Input MySQL password for Redmine

MySQL에서 Redmine의 정보를 저장하는 DB 계정에 대한 Password를 입력하고, 확인을 위하여 한번 더 입력하면 설치가 완료됩니다.

이제 Web Server와 연동하기 위해서 Apache의 DocumentRoot인 /var/www에 Redmine 접속을 위한 Directory를 다음과 같이 Link합니다.

1	$ sudo ln -s /usr/share/redmine/public /var/www/redmine

2.3. Passenger 설치

그 다음, Apache와 Redmine에서 Base로 사용하는 언어인 Ruby를 연동하는 Module인 Passenger를 설치합시다.

2.3.1. Precise Pangolin 12.04이하의 경우

기존에는 libapache2-mod-passenger를 통해서 설치가 가능했지만, Precise Pangolin의 Passenger Module의 Version이 낮아서 최신 설치되는 버전인 Redmine 2.1.2가 제대로 동작하지 않습니다. (no such file to load — dispatcher Error가 발생함.)

이미 libapache2-mod-passenger를 설치했다면 다음과 같이 입력하여 Package를 System에서 제거합니다.

1	$ sudo apt-get remove libapache2-mod-passenger

최신 Version의 Passenger는 Ruby Gem을 통해서 설치할 수 있습니다. 다음과 같이 Terminal에서 입력합니다.

1	$ sudo gem install passenger

Passenger 설치가 완료되었다면, Apache와 연동하기 위한 Module을 Build해야 합니다. 다음과 같이 입력합니다.

1 2	$ sudo apt-get install libcurl4-openssl-dev libssl-dev zlib1g-dev apache2-prefork-dev libapr1-dev libaprutil1-dev $ sudo passenger-install-apache2-module

passenger-install-apache2-module을 실행하면 설명이 나오는데 그냥 Enter를 눌러서 진행하면 됩니다.

Build가 모두 완료되면, 다음과 같은 Message가 나올 것입니다.

1 2 3

LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-3.0.17/ext/apache2/mod_passenger.so PassengerRoot /var/lib/gems/1.8/gems/passenger-3.0.17 PassengerRuby /usr/bin/ruby1.8

위의 내용은 Apache 설정에 추가해야 할 내용들을 적어놓은 것이기 때문에, Mouse로 선택하여 Ctrl + Shift + C로 복사하여 다른 곳에 저장해 놓습니다.

NOTE: Ruby Gem으로 설치할 경우, 최신의 Passenger를 설치하기 때문에 위의 경로는 약간 다를 수 있습니다.

이제 Apache에 Passenger관련 설정을 해 봅시다. Module Loading을 위해 다음과 같이 입력합니다.

1 2 3

$ sudo vi /etc/apache2/mods-avaliable/passenger.load  LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-3.0.17/ext/apache2/mod_passenger.so

LoadModule의 경로는 방금 전 복사한 내용의 것을 입력해야 합니다. 그리고 Passenger Module의 설정을 위해 다음과 같이 입력합니다.

1	$ sudo vi /etc/apache2/mods-available/passenger.conf

1 2 3 4 5

<IfModule mod_passenger.c>     PassengerRoot /var/lib/gems/1.8/gems/passenger-3.0.17     PassengerRuby /usr/bin/ruby1.8     PassengerDefaultUser www-data </IfModule>

마찬가지로 PassengerRoot와 PassengerRuby도 방금 전 복사한 내용의 것으로 입력하면 됩니다.

2.3.2. Quantal Quetzal 12.10의 경우

Quantal Quetzal의 경우는 libapache2-mod-passenger를 통해서 설치해야 합니다. 다음과 같이 입력합니다.

1	$ sudo apt-get install libapache2-mod-passenger

설치된 후, Passenger 설정을 변경하기 위해서 다음과 같이 입력합니다.

1	$ sudo vi /etc/apache2/mods-available/passenger.conf

1 2 3 4 5

<IfModule mod_passenger.c>   PassengerRoot /usr   PassengerRuby /usr/bin/ruby   PassengerDefaultUser www-data </IfModule>

2.4. Apache 설정 및 실행

그리고 Apache의 Default Site에 대한 설정을 수정하기 위해 다음과 같이 입력합니다.

1	$ sudo vi /etc/apache2/sites-available/default

<VirtualHost>와 </VirtualHost> 사이에 다음과 같은 Line을 추가합니다.

1 2 3 4

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

그리고 마지막으로 다음과 같이 입력하여 Apache를 재시작하면 Redmine의 설치가 완료됩니다.

1 2	$ sudo a2enmod passenger $ sudo service apache2 restart

2.5. Firewall 설정

Ubuntu의 UFW 방화벽을 사용한다면 다른 Client의 접속을 위해서 방화벽 설정을 변경해야 합니다.

UFW를 편리하게 설정할 수 있는 Gufw를 사용하여 방화벽 설정을 변경해 봅시다. 설치 방법은 Oneiric Ocelot 11.10의 경우 이 Post를, Precise Pangolin 12.04의 경우에는 이 Post를 참고하기 바랍니다.

Gufw

Gufw를 실행한 다음, 새로운 규칙을 추가하기 위해서 + Button을 누릅니다.

Gufw - Add rule

Add Rule Dialog에서 편리하게 Tab의 Service, HTTP를 선택하고 추가를 누르면 다른 Client에서 Web Server로 접속하기 위한 Rule이 UFW에 추가됩니다.

2.6. Troubleshooting

1. No such file or directory – /etc/redmine/default/session.yml

   Redmine 2.1.2를 설치할 때 위와 같은 Error가 발생한다면, 다음과 같이 입력합니다.

   1	$ sudo vi /usr/share/redmine/config/application.rb

   application.rb에서 아래의 내용을 주석처리합니다. (70번째 줄에 내용이 위치함.)

   1 2 3

   #sessionconfig = YAML::load_file(filename) #config.session_store :cookie_store, :key => sessionconfig[Rails.env]['key'], :path => (relativeUrlRoot.blank?) ? '/' : relativeUrlRoot #config.secret_token = sessionconfig[Rails.env]['secret']

   그리고 아래와 같이 입력하여 실패한 Redmine 설치를 완료합니다.

   1	$ sudo apt-get install -f

   설치가 완료된 다음에는 application.rb의 주석처리한 내용의 주석을 제거하여 원래대로 저장하기 바랍니다.

2. superclass mismatch for class MysqlAdapter

   위와 같은 Error가 발생한 경우에는 다음과 같이 입력합니다.

   1	$ sudo vi /usr/share/redmine/config/initializers/10-patches.rb

   10-patches.rb에서 다음의 내용을 (7째줄에 위치함.),

   1	class MysqlAdapter < AbstractAdapter

   아래와 같이 변경하고 저장합니다.

   1	class MysqlAdapter < AbstractMysqlAdapter

   설치 시에 문제가 발생했다면, 다음과 같이 입력하여 설치를 완료합니다.

   1	$ sudo apt-get install -f

3. Plugins in vendor/plugins (/usr/share/redmine/vendor/plugins) are no longer allowed.

   Update시에 위와 같은 Error가 발생할 수 있습니다.

   Redmine 2.x에서는 Plugin Directory가 (Redmine Home)/vendor/plugins에서 (Redmine Home)/plugins로 변경되었기 때문에 발생하는 Error입니다.

   또한 1.x의 Plugin은 동작하지 않을 수 있으니 기존에 설치된 Plugin은 다음과 같이 입력하여 삭제하고 Update를 다시 진행하면 됩니다.

   1 2	$ sudo rm -rf /usr/share/redmine/vendor/plugins $ sudo apt-get install -f

3. Redmine 설정

Redmine의 설치를 완료했으니 이제 Redmine을 사용하기 위한 기본 설정을 해 봅시다. 지면상 여기서는 모든 설정을 설명하지 않고 사용하는데 필요한 몇가지만 설명합니다.

Redmine을 설치한 Server에서 Web Browser를 실행한 다음, http://localhost/redmine을 입력하여 Redmine에 접속합니다.

Redmine - Index page

제대로 설치가 되었다면 위와 같은 Page를 표시할 것입니다. 관리자로 접속하기 위해서 오른쪽 위에 로그인을 Click합니다.

Redmine - Login

Login Page에서 다음과 같이 ID와 Password를 입력합니다.

• 로그인: admin
• 비밀번호: admin

Redmine - Index (Login)

관리자로 Login이 되었다면 먼저 관리자 ID인 admin의 Password를 변경해야 합니다. 오른쪽 위에 My Account를 Click합니다.

Redmine - My account

Password를 변경하기 위해서 Change password를 Click합니다.

Redmine - Change password

Password에는 기존의 Password인 admin을 입력하고, New password와 Confirmation에 새로운 Password를 입력하고 Apply를 누릅니다.

Redmine - My Account (Langauge)

그 다음에는 사용할 언어를 변경하기 위해서 Language를 한국어(Korean)으로 변경하고 Save를 누릅니다.

Redmine - Administration (Settings)

그 다음, Redmine의 기본 설정을 변경하기 위해서 왼쪽 위의 관리를 누른 다음, 설정을 누릅니다.

Redmine - Settings (Language)

사용자가 Redmine을 사용할 때 표시할 기본 언어를 변경하기 위해서 표시방식 Tab에서 기본 언어를 한국어(Korean)으로 변경하고 저장을 누릅니다.

Redmine - Settings (Encodings)

그리고 일반 Tab의 Attachments and repositories encodings는 첨부한 File이나 SCM과 연동하여 저장소 File의 내용을 Redmine에서 표시할 때 사용할 Encoding을 설정합니다.

한글을 제대로 표시하기 위해서 여기에 UTF-8,EUC-KR을 입력하고 저장을 누릅니다.

Redmine - Settings (Authentication required)

만약, 인증된 일부의 사용자만 Redmine을 사용할 수 있도록 설정하기 원한다면 인증 Tab에서 인증이 필요함을 Check하고 저장을 누르면 됩니다.

4. 마치면서…

기존의 내용이 너무 길어서 내용을 분리하여 Post를 나누었습니다. Part 2에서는 Redmine과 SCM을 연동하는 방법, Gantt Chart를 PNG로 Export하는 방법과 Backup에 대해서 설명합니다.

Changelog

• Ubuntu Quantal Quetzal 12.10 Test 완료. (2012-11-08)
  (apache2-mpm-prefork 2.2.22, libapache2-mod-passenger 3.0.13, mysql-server 5.5.27, redmine 1.4.4, ruby 1.9.3, rails 2.3.14)
• Ubuntu Precise Pangolin 12.04 Test 완료. (2012-11-07)
  (apache2-mpm-prefork 2.2.22, Passenger 3.0.17, mysql-server 5.5.22, redmine 1.3.3 & 1.4.3 & 2.1.2, ruby 1.8.7, rails 2.3.14)
• Ubuntu Oneiric Ocelot 11.10 Test 완료. (2012-03-01)
  (apache2-mpm-prefork 2.2.20, libapache2-mod-passenger 2.2.11, mysql-server 5.1.58, redmine 1.3.0 & 1.3.2 & 1.3.3, ruby 1.8, ruby-rails 2.3.14)

5. Redmine과 SCM 연동하기

Redmine의 장점은 SCM과 Project 관리 System을 연동해서 사용할 수 있다는 것입니다. Project 저장소의 Code를 확인하거나 Revision간의 차이점을 확인할 수도 있으며, Redmine 내의 Wiki나 Issue에서 SCM의 Source를 참조할 수도 있습니다.

Redmine의 Project와 여러 SCM(SVN, CVS, Git, Mercurial, Bazzar, Darcs)을 연동할 수 있지만, 여기서는 그 중의 Subversion과 Git을 연동하는 방법을 알아보도록 하겠습니다.

5.1. Subversion

5.1.1. Subversion Client 설치

Subversion 저장소와 연동하는 Redmine Server에서도 내부적으로 Subversion을 사용하기 때문에 Subversion을 먼저 설치해야 합니다. 다음과 같이 Terminal에서 입력합니다.

1	$ sudo apt-get install subversion

Redmine - Settings (SCM)

Subversion이 설치되었다면 Redmine에 Admin으로 접속한 다음, 관리 -> 설정 -> 저장소에서 위와 같이 Subversion이 Check되어 있는지 확인합니다.

5.1.2. 서로 다른 Server에서 SVN과 Redmine을 Service하는 경우

Subversion 저장소와 Redmine Server를 따로 운영할 경우에는 먼저 Subversion 저장소를 구성해야 합니다. Subversion 저장소를 구성하는 방법은 Ubuntu에서 Subversion Server 구성하기 Post를 참고하기 바랍니다.

Redmine - Project Settings (Repository)

Subversion 저장소와 연동할 Redmine의 Project에서 설정 -> 저장소를 누른 다음, 형상관리시스템에 Subversion을 선택합니다.

URL에는 접근할 Subversion Project 저장소의 URL을 입력합니다. file, http, https, svn, svn+ssh와 같은 Protocol을 지원하지만 Subversion 저장소가 다른 관계로 http, https, svn만 사용할 수 있습니다.

로그인과 비밀번호에는 Subversion Project 저장소에 접근하기 위한 ID와 Password를 입력하고 만들기를 누릅니다.

Redmine - Project Repository

Subversion 저장소가 정상적으로 연동되면 위와 같은 화면이 표시됩니다.

5.1.3. 동일한 Server에서 SVN과 Redmine을 Service하는 경우

Subversion 저장소와 Redmine Server를 따로 운영하는 것보다는 동일한 Server에서 운영하는 것이 더 유용합니다.

동일 Server를 사용할 경우, Redmine의 인증을 사용하여 Subversion Project 저장소에 접근할 수 있는 사용자를 관리할 수 있습니다. 또한 Redmine에서 Project를 생성하면 Project를 위한 Subversion Project 저장소를 자동으로 만들도록 설정할 수도 있습니다.

5.1.3.1. Subversion 저장소를 Redmine과 통합하기

먼저, Subversion을 설치하고 Subversion을 위한 저장소를 만들어야 합니다. Ubuntu에서 Subversion Server 구성하기의 1. Subversion설치를 참고하기 바랍니다.

그 다음, Subversion을 http Protocol로 접근하기 위해서 다음과 같은 Package를 설치합니다.

1	$ sudo apt-get install libapache2-svn libapache-dbi-perl libapache2-mod-perl2

그리고 Redmine의 인증에 접근하기 위한 Perl Script를 Link하고 Perl의 CPAN을 사용하여 Digest::SHA1 Module을 설치합니다.

1 2 3 4

$ sudo ln -sf /usr/share/redmine/extra/svn/Redmine.pm /usr/lib/perl5/Apache/Redmine.pm $ sudo ln -sf /usr/share/redmine/extra/svn/Redmine.pm /usr/lib/perl5/Apache2/Redmine.pm $ sudo -s -H $ perl -MCPAN -e'install Digest::SHA1'

perl 명령 실행 시에 CPAN 설정을 위해 나오는 질문이 표시된다면 그냥 Enter를 누르면 됩니다.

Precise Pangolin 12.04, Quantal Quetzal 12.10에서 Perl 명령 실행 시에 다음과 같은 질문이 표시된다면,

1 2	What approach do you want?  (Choose 'local::lib', 'sudo' or 'manual')  [local::lib]

sudo를 입력하고 Enter를 누르면 됩니다.

그 다음, Subversion과 Apache를 연동하기 위해서 Terminal에서 다음과 같이 입력합니다.

1	$ sudo vi /etc/apache2/conf.d/svn.config

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30

PerlLoadModule Apache::Redmine <Location /svn>   DAV svn   SVNParentPath "/home/svn"   Order deny,allow   Deny from all   Satisfy any   PerlAccessHandler Apache::Authn::Redmine::access_handler   PerlAuthenHandler Apache::Authn::Redmine::authen_handler   AuthType Basic   AuthName "Redmine Subversion Repository"   #read-only access    <Limit GET PROPFIND OPTIONS REPORT>     Require valid-user     Allow from 192.168.0.1     Satisfy any   </Limit>   #write acces    <LimitExcept GET PROPFIND OPTIONS REPORT>     Require valid-user   </LimitExcept>   # for mysql   RedmineDSN "DBI:mysql:database=redmine_default;host=localhost"   RedmineDbUser "redmine"   RedmineDbPass "password" </Location>

위의 내용에서 상황에 맞게 수정해야 할 부분은 다음과 같습니다.

• Line 17: Allow from 다음에 http Protocol로 Subversion 저장소에 Read-only 접근을 허용할 Client의 IP를 적어줍니다. (Redmine Server의 IP를 적어주면 됨.)
• Line 29: RedmineDbPass의 따옴표 안에 Redmine 설치 시에 입력했던 MySQL redmine 계정의 비밀번호를 입력합니다.

위의 내용은 설치 시에 dbconfig-common을 사용하여 Database를 설정한 경우에만 적용됩니다. Redmine을 수동으로 설치하거나 dbconfig-common을 사용하지 않았다면 RedmineDSN, RedmineDbUser는 다를 수 있습니다.

저장했다면 다음과 같이 입력하여 Apache에 적용합니다.

1 2	$ sudo a2enmod dav_svn $ sudo service apache2 restart

마지막으로 설정이 제대로 적용되었는지 확인하기 위해서 Terminal에서 다음과 같이 입력합니다.

1 2 3 4 5

$ sudo svnadmin create /home/svn/test $ sudo chown www-data:subversion /home/svn/test -R $ svn ls http://localhost/svn/test 인증 영역(realm): <http://localhost:80> Redmine Subversion Repository 'root'의 암호:

위의 명령은 Test의 Project 저장소를 Subversion 저장소에 만들고 http Protocol로 접근이 가능한지 확인하는 것입니다.

새로 만들어진 Project 저장소에 접근하기 위한 URL은 다음과 같습니다.

1	http://<Domain 이름 또는 IP>/svn/<생성한 Project 이름>

위와 같이 svn ls를 통해 암호 입력하는 Prompt가 표시되면 정상적으로 설정이 된 것입니다. 아직 어떠한 암호로도 접근이 불가능할텐데 그 이유는 다음 항목에서 설명합니다.

5.1.3.2. Redmine에서 Subversion Project 저장소를 생성하기

Redmine의 Project를 위한 Project 저장소를 생성하기 위해서는 Redmine SCM Plugin을 설치해야 합니다.

다음 URL에서 최신 Version의 Plugin을 Download합니다.

• Download: http://projects.andriylesyuk.com/projects/scm-creator/files

Download한 Plugin을 설치하기 위해서 다음과 같이 입력합니다.

1. Redmine 2.x의 경우:

   1 2 3 4

   $ sudo mkdir /usr/share/redmine/plugins $ sudo tar xvfj redmine_scm*.tar.bz2 -C /usr/share/redmine/plugins $ cd /usr/share/redmine $ sudo rake redmine:plugins:migrate RAILS_ENV=production

2. Redmine 1.4 이하일 경우:

   1 2 3

   $ sudo tar xvfj redmine_scm*.tar.bz2 -C /usr/share/redmine/vendor/plugins $ cd /usr/share/redmine $ sudo rake db:migrate:plugins RAILS_ENV=production

그 다음, Plugin을 위한 설정 File을 편집하기 위해서 Terminal에서 다음과 같이 입력합니다.

1	$ sudo vi /usr/share/redmine/config/scm.yml

1 2 3 4 5 6 7 8 9 10 11

production:    auto_create: false    deny_delete: true    pre_create: /usr/local/bin/pre-create.sh    post_create: /usr/local/bin/post-create.sh    pre_delete: /usr/local/bin/pre-delete.sh    post_delete: /usr/local/bin/post-delete.sh    svn:      path: /home/svn      svnadmin: /usr/bin/svnadmin      url: svn

위의 내용은 Subversion을 위한 설정만 적용한 것입니다. path에는 Subversion 저장소의 Directory Path, url에는 http를 통해 접근하기 위한 URL을 입력합니다.

그리고 auto_create를 true로 설정하면 Redmine에서 Project를 생성할 때 Project에 대한 Subversion Project 저장소가 자동으로 생성됩니다. (Redmien의 Project 생성 Form에서 자동으로 생성할 SCM을 선택할 수 있음.)

만약 다른 SCM을 사용하기 위해 Plugin을 설정하기 원한다면 Plugin Homepage의 Wiki를 참고하기 바랍니다.

저장한 다음, 설정을 적용하기 위해서 Apache를 다시 시작합니다.

1	$ sudo service apache2 restart

Redmine - Plugins

Plugin이 제대로 설치되었다면 Redmine의 Admin 계정으로 접속했을 때, 관리 -> 플러그인에서 위와 같이 SCM Creator가 표시될 것입니다.

Redmine - Project Settings (Repository)

Redmine에서 Project를 생성한 후, 설정 -> 저장소에서 Subversion을 선택하면 위와 같이 Create new repository Button이 표시됩니다. 먼저 Create new repository를 눌러 Project 저장소를 생성하면, 위와 같이 file Protocol의 URL이 입력됩니다. 그 다음, 만들기(저장)를 누릅니다.

물론 다른 Subversion Server의 Project 저장소를 연결하려면 Create new repository를 누르지 않으면 됩니다. 그리고 기본으로 설정된 URL을 변경하고 Create new repository를 누르면 Project 저장소에 접근하기 위해 Redmine 인증을 사용할 수 없으니 주의하기 바랍니다.

NOTE: Redmine 1.4.3이상에서 Redmine SCM Plugin 0.4.1이상을 사용할 때 Create new repository를 누르면 바로 저장소 생성이 완료되니 주의하시기 바랍니다.

Redmine - Saved Project Settings (Repository)

Project 저장소가 제대로 생성되었다면 위의 그림과 같이 URL을 수정할 수 없게 변경되면서 아래에 Project 저장소에 접근하기 위한 URL이 표시됩니다.

URL은 Redmine의 설정 때문에 실제 URL과 다르게 표시될 수 있습니다. 실제 접속하기 위한 URL은 다음과 같습니다.

1	http://<Domain 이름 또는 IP>/svn/<Project의 식별자>

여기서 Project의 식별자는 Project를 생성할 때 입력하는 식별자를 의미합니다. 위 그림과 같은 예일 경우 URL은 http://localhost/svn/hello가 됩니다.

Server에 생성된 Project 저장소의 Directory Path는 다음과 같습니다.

1	/home/svn/<Project의 식별자>

Redmine - Project Repository

정상적으로 Project 저장소가 생성되었다면, 저장소 Tab은 위의 그림과 같을 것입니다.

Redmine - Project Settings (Members)

이전 항목에서도 잠깐 이야기 했지만, 생성된 Project 저장소에 접근하기 위해서는 Redmine의 인증을 사용합니다. 때문에 Project 저장소에 접근을 허용할 User를 지정하기 위해서 Redmine의 Project에서 설정 -> 담당자를 Click합니다.

위의 화면에서 담당자를 선택한 다음, 역할을 관리자 또는 개발자로 설정하여 추가하면 해당 사용자의 ID와 Password를 사용하여 Project 저장소에 접근할 수 있습니다.

담당자를 추가했다면 Test를 위해 다음과 같이 Terminal에서 입력합니다. (생성한 Project의 식별자가 hello이고, 사용자 ID가 foo인 경우의 예)

1 2 3 4

$ svn ls http://localhost/svn/hello --username foo 인증 영역(realm): <http://localhost:80> Redmine Subversion Repository 'foo'의 암호:  체크아웃된 리비전 0.

위와 같이 정상적으로 접근이 가능하면 연동이 완료된 것입니다. 한가지 유의할 점은 이렇게 생성된 Project 저장소는 연동한 Redmine의 Project를 삭제할 때 같이 삭제된다는 것입니다.

Redmine SCM Creator Plugin에 대한 더 자세한 내용은 Plugin Page의 Wiki를 참고하기 바랍니다.

5.2. Git

Git과의 연동은 SVN의 경우와는 달리, Redmine 계정으로 Git Repository에 접근하는 것과 같은 통합을 지원하지 않습니다.

그 이유는 Git의 경우 자체 인증을 가지고 있지 않고, 또한 Web Service를 실행하는 System 계정인 www-data가 해당 Repository에 SSH Protocol로 접근할 수 있는 방법이 없기 때문입니다. (우회할 수 있는 방법이 있는 것 같지만, 보안상 추천하지 않습니다.)

이 외에도 Git 관리까지 Redmine에서 할 수 있는 몇 가지 Plugin이 존재하지만, Redmine 2.x에서는 제대로 동작하지 않아서 사용할 수가 없었습니다. 

그래서 이번 항목에서는 간단하게 Redmine Project에 Git Repository를 연동하는 방법에 대해서 알아봅니다.

5.2.1. Git Client 설치

먼저, Redmine과 Git을 연동하기 위해서는 Redmine Server에 Git이 설치되어 있어야 합니다. 다음과 같이 Terminal에서 입력합니다.

1	$ sudo apt-get install git-core

Redmine – Settings (SCM)

설치 후, Redmine의 관리 > 설정 > 저장소에서 위의 그림과 같이 Git을 Check하고 저장을 누르면 Git과 연동할 기본적인 준비가 완료됩니다.

5.2.2. 동일한 Server에서 Git과 Redmine을 Service하는 경우

동일한 Server에서 Git과 Redmine을 Service하는 경우, Redmine이 간단하게 Local 경로를 통해 Git Repository에 접근할 수 있도록 만들어 주면 됩니다. 다음과 같이 Terminal에서 입력합니다.

NOTE: 아래의 Command는 Ubuntu에서 Git Server 구성하기를 통해 Git Server를 구성하였을 경우를 예로 들어 설명한 것입니다. Git Server를 다르게 구성했을 경우에는 계정이나 Directory 경로가 다를 수 있습니다.

1	$ sudo usermod -a -G www-data git

위의 명령을 통해 Git Server의 기본 계정인 git 계정이 www-data Group에 추가되어, www-data 계정이 Git의 Directory, File에 접근 가능하게 됩니다.

그 다음, Git Server 구성 방법에 따라 다음과 같이 입력하여 Repository에 Group 권한을 설정해 줍니다.

• Simple Way: /home/git 안에 있는 모든 Repository가 Group 접근 권한을 갖도록 설정합니다. Repository가 생성될 때마다 실행해 주어야 합니다.

  1 2	$ sudo su - git $ chmod g+rx *.git -R

• Gitolite: /home/git/repositories 안에 있는 모든 Repository가 Group 접근 권한을 갖도록 설정합니다. Gitolite의 경우는 한 번만 실행해 주면 됩니다.

  1 2 3 4 5 6 7

  $ sudo su - git $ vi ~/.gitolite.rc $REPO_UMASK = 0027 $ chmod g+r ~/projects.list $ chmod g+rx ~/repositories -R

Project – Settings (Repository)

권한이 설정되었다면, 이제 Redmine과 연동해 봅시다. Project의 설정 > 저장소 > 저장소 추가를 누르면 위와 같은 화면이 나옵니다. 각 항목에 다음과 같이 설정합니다.

• 형상관리시스템: Git
• 주 저장소: 여러 저장소를 설정할 수 있기 때문에 해당 저장소를 Main 저장소로 설정하려면 Check합니다.
• 식별자: 저장소를 구분하기 위한 식별자를 입력합니다. Redmine 내에서 저장소 구분을 위해 사용합니다.
• 저장소 경로: Git Repository의 System 경로를 입력합니다. 예를 들어 Hello Project의 Repository를 연동한다면,Simple Way의 경우는 /home/git/hello.git, Gitolite의 경우는 /home/git/repositories/hello.git으로 입력하면 됩니다.
• 경로 인코딩: Path를 찾아가기 위해서 System의 Encoding($LANG)을 설정합니다. Ubuntu의 경우, 특별한 변경이 없다면 UTF-8을 설정하면 됩니다.
• 파일이나 폴더의 마지막 제출을 보고: Check할 경우, 저장소 Page에서 해당 File이나 Directory의 저작자, Comment, Revision 등의 정보를 확인할 수 있습니다.

NOTE: Redmine SCM Creator Plugin을 사용할 경우, 제대로 추가되지 않고 Error(“Adding local repositories was denied by the administrator”)가 발생할 수 있습니다. 해당 Plugin을 다음과 같이 입력하여 지우고 다시 설정하면 됩니다.

• Redmine 1.4.x 이하의 경우:

  1 2 3 4

  $ cd /usr/share/redmine $ sudo rake db:migrate:plugin NAME=redmine_scm VERSION=0 RAILS_ENV=production $ sudo rm -rf vendor/plugins/redmine_scm $ sudo service apache2 restart

• Redmine 2.x의 경우:

  1 2 3 4

  $ cd /usr/share/redmine $ sudo rake redmine:plugins:migrate NAME=redmine_scm VERSION=0 RAILS_ENV=production $ sudo rm -rf plugins/redmine_scm $ sudo service apache2 restart

Redmine – Project Repository

저장소 추가가 완료된 후, Project의 저장소 Page에 들어가면 위의 그림과 같이 내용이 표시될 것입니다.

5.2.3. 서로 다른 Server에서 Git과 Redmine을 Service하는 경우

서로 다른 Server에서 Git과 Redmine을 Service한다면, 설정이 조금 복잡해 집니다.

이전에 언급했다시피, Redmine에서 SSH Protocol을 사용해 해당 Git Repository를 접근할 수 있는 방법이 없기 때문에, Git Repository를 Redmine Server에 Mirroring해서 저장하고, 저장된 Repository를 Redmine에서 Local로 접근하여 설정하는 방법을 사용할 수 밖에 없습니다.

먼저 Redmine과 연동할 Git Repository를 Mirroing하기 위해 다음과 같이 입력합니다. (SSH Protocol로 dev.example.com의 hello Repository를 Mirroing하는 경우의 예)

1	$ git clone --mirror git@dev.example.com:hello.git

Mirroring을 통해 생성된 Repository는 Bare Repository 형태를 띱니다. 이것을 Web Service 계정인 www-data가 접근 가능하도록 설정하기 위해 다음과 같이 입력합니다.

1 2 3

$ sudo mkdir /srv/git $ sudo mv hello.git /srv/git $ sudo chown www-data:www-data /srv/git/hello.git -R

그리고, Source의 변경이 Repository에 반영될 수 있도록 다음과 같이 Cron 작업을 추가합니다. (매 분마다 hello.git을 Fetch하는 경우의 예)

1 2 3

$ sudo crontab -e */1 * * * * cd /srv/git/hello.git && /usr/bin/git fetch -q

그 다음, Redmine의 Project에 저장소를 추가합니다. 추가하는 방법은 동일한 Server에서 Git과 Redmine을 연동하는 경우와 같습니다. 다만, 저장소의 경로가 /home/git에서 /srv/git으로 변경된 것을 유의하기 바랍니다.

6. Gantt Chart를 PNG로 Export하기

Redmine에 입력한 일감은 Gantt Chart를 통해 한 눈에 일정을 확인할 수 있습니다. Redmine은 Gantt Chart를 PDF와 PNG로 Export할 수 있습니다. 하지만 PNG Export의 경우는 따로 Package를 설치해야 합니다.

Terminal에서 다음과 같이 입력합니다.

1 2	$ sudo apt-get install librmagick-ruby $ sudo service apache2 restart

Redmine - Information (RMagick available)

Redmine의 admin 계정으로 접속한 다음, 관리 -> 정보에서 위와 같이 RMagic 사용 가능 (선택적)이 Check 표시로 나타난다면 정상적으로 설치된 것입니다.

Redmine - Project (Gantt Chart)

Gantt Chart를 Export할 Project에서 Gantt 챠트 Page 밑에 PNG를 Click하면 PNG로 Export된 Image를 얻을 수 있습니다.

6.1. PNG의 한글이 ?로 표시될 경우

Gantt Chart - PNG Export (before)

일감에 한글이 포함되어 있다면 위의 그림과 같이 한글이 ?로 표시될 것입니다. 이것은 Redmine에서 RMagick으로 Image를 만들 때 Font 설정 때문에 발생하는 문제인데, Google 검색으로 이것을 해결한 Post를 찾을 수 있었습니다.

하지만 해당 Post의 내용은 Windows에서 Bitnami Stack으로 Redmine을 설치한 경우이기 때문에, Ubuntu에서 PPA를 사용하여 Redmine을 설치한 경우를 위해 Post의 내용을 참조하여 Patch를 만들어 봤습니다.

• Redmine 1.3.0: rmagick_font-1.3.0.patch
• Redmine 1.3.2, 1.3.3: rmagick_font-1.3.2.patch
• Redmine 1.4.3: rmagick_font-1.4.3.patch
• Redmine 1.4.4: rmagick_font-1.4.4.patch
• Redmine 2.1.2: rmagick_font-2.1.2.patch

NOTE: Redmine을 새로 설치한 경우나 Update한 경우에는 Patch를 다시 적용해야 합니다. 또한 설치된 Redmine과 Patch가 Version이 서로 맞지 않는다면 Patch 시에 문제가 발생할 수 있습니다.

Download한 Patch를 설치된 Redmine Source에 적용하기 위해서 다음과 같이 Terminal에서 입력합니다.

1 2 3 4

$ sudo mv rmagick_font*.txt /usr/share/redmine/rmagick_font.patch $ cd /usr/share/redmine $ sudo patch -p0 < rmagick_font.patch $ sudo service apache2 restart

Redmine - Settings (RMagick Font)

Redmine에 admin 계정으로 접속한 다음, 관리 -> 설정 -> 표시방식을 Click하면 RMagic 글꼴(PNG Export) 설정이 새로 표시되는 것을 확인할 수 있습니다.

RMagick 글꼴에 한글이 제대로 표현되는 Font를 선택한 다음 저장을 누릅니다. 여기서 Font는 Redmine Server에 설치된 Font의 List가 표시됩니다.

만약, 원하는 Font를 설치하고 싶다면 /usr/share/fonts/truetype에 Font를 복사하거나 나눔글꼴과 같은 Font Package를 설치하면 됩니다. (Precise Pangolin 12.04의 경우 나눔글꼴이 Default로 설치되어 있으므로 따로 설치할 필요가 없음)

Gantt Chart - PNG Export (after)

설정을 저장했다면 Project의 Gantt 챠트에서 PNG로 Export해 봅시다. Font를 제대로 설정했다면 위의 그림과 같이 한글이 제대로 표시되는 것을 확인할 수 있습니다.

7. Backup & Restore

Redmine 내에 첨부된 File들과 DB에 저장된 내용을 Backup 해 두면, 새로 System을 구축하거나 Server를 옮길 때에 손쉽게 Redmine을 복구할 수 있습니다.

Redmine에서 기본적으로 Backup Program을 지원하지 않기 때문에, Local에 Backup File을 저장하는 Script를 간단하게 만들어 보았습니다.

• Download: redmine_bak

NOTE: Backup Script는 Redmine 1.2.x ~ 2.1.2에서 Test 되었습니다. 위에 설명한 것과 같이 PPA로 Redmine을 설치하고, dbconfig-common을 통해 DB를 설정한 경우에만 제대로 동작합니다.

이 외에 Version에서도 충분히 실행은 가능하나 Test를 하지 못했기 때문에 Backup의 안정성을 보장할 수 없음을 참고하기 바랍니다.

Download한 Backup Script를 설치하기 위해서 다음과 같이 Terminal에서 입력합니다.

1 2	$ sudo mv redmine_bak.txt /usr/local/bin/redmine_bak $ sudo chmod 755 /usr/local/bin/redmine_bak

7.1. Backup

Redmine의 Data를 Backup 하기 위해서는 -b Option을 사용합니다. Option 뒤에 반드시 Backup File을 저장할 Directory Path를 적어야 합니다. (/backup/redmine에 Backup File을 저장하는 예)

1	$ sudo redmine_bak -b /backup/redmine

위의 명령을 통해 Backup한 File은 redmine-년-월-일.tar.gz의 이름을 가집니다.

Cron을 사용하여 일정한 시간에 Backup Script를 실행하도록 만들수도 있습니다. 다음은 매일 새벽 5:00에 /backup/redmine에 Backup을 저장하는 예입니다.

1 2 3

$ sudo crontab -e 0 5 * * * /usr/local/bin/redmine_bak -b /backup/redmine

7.2. Restore

Backup File의 내용을 복구하려면 Redmine이 설치되지 않은 깨끗한 System에서 복구를 수행해야 합니다. 만약 설치되어 있는 상태에서 Backup File로 복구할 경우 이전의 내용은 모두 삭제됩니다.

깨끗한 System에 Redmine을 설치한 후, Subversion Server와 Redmine이 동일한 Server에 위치했었다면 Subversion과 Apache를 연동합니다. 그리고 Plugin과 Patch를 설치한 것이 있다면 그대로 설치합니다.

그 다음 Backup Script를 설치한 후, Backup File의 내용을 Redmine에 적용하기 위해서 -r Option을 사용하여 복구합니다. (Backup File인 /backup/redmine/redmine-2012-02-01.tar.gz를 가지고 복구하는 예)

1 2 3 4

$ sudo redmine_bak -r /backup/redmine/redmine-2012-02-01.tar.gz $ cd /usr/share/redmine $ sudo rake db:migrate RAILS_ENV=production $ sudo service apache2 restart

Subversion과 Redmine을 동일 Server에서 운영할 경우, Subversion 저장소는 Redmine Backup Script로 Backup 되지 않습니다. Backup을 원한다면, /home/svn Directory를 압축해서 저장했다가 복구 시에 동일한 Directory에 압축을 풀어주면 됩니다.

Changelog

• Ubuntu Quantal Quetzal 12.10 Test 완료. (2012-11-08)
  (apache2-mpm-prefork 2.2.22, libapache2-mod-passenger 3.0.13, mysql-server 5.5.27, redmine 1.4.4, ruby 1.9.3, rails 2.3.14, subversion 1.7.5, redmine_scm 0.4.1, git-core 1.7.10.4)
• Ubuntu Precise Pangolin 12.04 Test 완료. (2012-11-07)
  (apache2-mpm-prefork 2.2.22, Passenger 3.0.17, mysql-server 5.5.22, redmine 1.3.3 & 1.4.3 & 2.1.2, ruby 1.8.7, rails 2.3.14, subversion 1.6.17, redmine_scm 0.3.0 & 0.4.1, git-core 1.7.9.5)
• Ubuntu Oneiric Ocelot 11.10 Test 완료. (2012-03-01)
  (apache2-mpm-prefork 2.2.20, libapache2-mod-passenger 2.2.11, mysql-server 5.1.58, redmine 1.3.0 & 1.3.2 & 1.3.3, ruby 1.8, ruby-rails 2.3.14, subversion 1.6.12, redmine_scm 0.3.0)