1. 개요


  레드마인은 서브버전, 머큐리얼 등 소스 버전 관리 툴과 연동할 수 있는 기능을 제공한다. 현재 BitNami Redmine은 다음과 같은 저장소와의 연계를 기본적으로 지원한다. 

  • Subversion
  • Darcs
  • Mercurial
  • CVS
  • Bazzar
  • Git
  또한, 레드마인은 이클립스 플러그인인 MyLyn과 연동이 가능하고, 메일을 연동하여 매 변동사항을 관련자에게 메일로 전달할 수 있다.
  이번 포스팅에서는 Redmine에 아래와 같은 설정을 하는 절차를 알아본다.
  • Mercurial 저장소를 연동하여 Redmine에서 소스 관리가 가능하도록 한다. 
  • Eclipse MyLyn Plug-in 과 연동하여, Redmine의 일감을 MyLyn과 동기화한다. 
  • Redmine에 메일을 연동하여, 일감이 변경될 때마다 관련자에게 메일을 전송하게 한다. 


2. 레드마인과 머큐리얼 연동

  • 레드마인과 머큐리얼을 연동하기 위해 먼저 샘플 프로젝트를 생성한다. 


  • 생성한 프로젝트에서 설정 > 저장소로 들어간 후, 연동할 머큐리얼 저장소의 물리 위치를 설정한다. 
※ 저장소의 경로는 물리 경로를 의미한다. (C:\...)


  • 프로젝트의 "저장소" 탭으로 접속하여 이력이 정상적으로 동기화되는지 확인한다.



3. 레드마인과 이클립스 MyLyn 연동


  Bitnami redmine과  이클립스 MyLyn간의 연동에 관해 설명한 포스팅이 있어 이를 참고하였다. (출처 : 위클립스 - Redmine + Mylyn 조합 사용하기) 여기에서는 출처의 내용 중 내가 수행한 내용을 간략히 요약만 할 예정이다. 


  1) RESTful API 설치

  1. 시작 > 프로그램 > BitNami Redmine Stack에서 "BitNami Redmine Stack 사용" 선택 (또는 bitNami Redmine 설치 디렉토리의 use_redmine.bat 파일 실행)
  2. 콘솔에서 "[레드마인 설치경로]/apps/redmin/htdocs/plugins" 로 이동
  3. 아래의 명령 실행
> git clone git://github.com/danmunn/redmine_mylyn_connector.git
> gem install libxml-ruby
> bundle install --without development test
> rake redmine:plugins:migrate RAILS_ENV=production
※ 3번째 줄은 실행하지 않아도 무방하다.

  4. redmine을 재구동한다. 
     (프로그램 > BitNami Redmine Stack에서 "redmine manager tool" 참고)
  5. 재구동 이후 "관리 > 플러그인" 메뉴에서 플러그인이 보인다면 성공



  2) Redmine MyLyn Connector 설치

  1. 이클립스에서 다음 사이트 주소를 추가하여 커넥터 설치 (http://redmin-mylyncon.sourceforge.net/update-site/N/)
※ 가끔 업데이트 사이트에 연결되지 않아 설치가 진행되지 않는 경우가 있다. 적당히 시간이 지난 후 업데이트를 수행하면 재대로 설치된다. 


3) Eclipse MyLyn에서 Redmine 연동


  이제 MyLyn에 Task Repository를 등록하는 일이 남았다. 등록을 위해 수행해야 하는 작업은 아래와 같다. 


(1) 먼저 앞에서 설치한 RESTful API를 활성화해야 한다. Redmine에서 관리자 계정으로 로그인한 후, "관리 > 설정 > 인증"으로 차례로 접근한 후, "REST 웹 서비스 활성화"를 체크하고 저장한다.




(2) 로그인 상태에서 Redmine 상단 우측의 "내 계정"을 선택하면, 우측부분에 "API 접근키" 항목이 생겼다. "보기"를 누르고 해당 API 키를 복사한다. 



(3) 이클립스의 MyLyn에서 "New Task" 선택시 표시되는 창에서 "Add Task Repository" 버튼을 클릭한다. (또는 Task Repository View를 열고, 여기서 추가 가능) 다음 창에서 Redmine 을 선택한 후, Next를 누르면, 아래와 같은 창이 나타난다. 입력할 항목은 다음과 같다. 

  • Redmine 주소 (http://[ip]:[port]/redmine)
  • Label : 작업 저장소 이름
  • API-Key의 Enable을 체크하고, (2)에서 복사한 값을 붙여넣는다. 
모두 입력했으면 Validate Settings 버튼을 클릭하고, 정상적으로 연결됨을 확인한 후, Finish를 누른다. 


(4) 이제 MyLyn에서 새로운 Task를 연결된 Redmine에 등록할 수 있게 되었다. 테스트로 하나의 작업을 등록한 후, Submit을 눌러 등록한다. 




(5) 웹에서도 입력한 내용을 볼 수 있는지 확인한다. 




4. Redmine 메일 설정


  메일 설정과 관련된 자세한 내용은 아래의 주소들을 참고하여 작성하였다. 레드마인 2.x 버전 이후로 Gmail과 관련된 TLS 관련 설정에 변경이 생긴 듯하다. 

  1. 별도의 플러그인 설치 필요 없음
  2. 설정할 파라미터가 변경 (tls: true --> enable_starttls_auto: true)
자세한 내용은 아래 참고 주소를 참고한다.
http://www.redmine.org/boards/2/topics/30670 (맨 아래쪽, 답변자가 한국인임...-_-)
  • Redmine의 "관리 > 설정 > 메일 알림"에서 메일 알림과 관련된 옵션을 알맞게 편집한다.


  • configuration.yml 파일의 이메일 부분을 아래와 같이 편집한다. configuration.yml 파일은 [BitNami Redmine 설치 경로]/apps/redmine/htdocs/config 내에 존재한다. 
※ 해당 예제는 Gmail을 송신 메일로 설정할 때의 예시이며, 기타 사설 메일이나 다른 메일을 사용할 시에는 메일 공급자에 알맞은 정보를 입력해주면 된다. 
※ 설정 파일을 입력할 때 주의사항 
  (1) 앞쪽 공란은 Tab 키 대신 공란 2개를 사용해야 한다(설정파일의 주의사항)
  (2) user_name외의 값은 ""를 사용하지 말 것 
# default configuration options for all environments
default:
  # Outgoing emails configuration (see examples above)
  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: "[송신 이메일 주소]"
      password: [송신 이메일 비밀번호]
  • Redmine을 재시작하고, "관리 > 설정 > 메일 알림"으로 접속하여 하단의 "테스트 메일 보내기"로 메일 테스트를 수행해본다. 






  1. 글 감사합니다. 도움이 많이 되었습니다.
    다른 글들은 고민과 실수를 많이하게되는데..
    이 글은 그저 따라가기만 하면 무안히 끝나네요.

    그리고 굳이 필요없지만 찜찜한
    sudo bundle install --without development test
    는 sudo 빼고
    bundle install --without development test
    실행하면 되네요.

1. 개요


  레드마인은 PMS(Project Management System)의 한 종류로, 루비 온 레일즈(Ruby on Rails)를 기반으로 작성된 시스템이다. 레드마인은 프로젝트 관리, 일정 관리, 형상 관리 통합, 이슈 추적 등의 기능을 지원하며, 다양한 플랫폼과 데이터베이스를 지원하고 있다. 

  레드마인에 대한 자세한 내용은 공식 홈페이지(http://www.redmine.org/)를 통해 확인 가능하다. 공식 홈페이지 역시 Redmine로 되어있으므로, 사용 전에 미리 리뷰를 하고 싶다면, 이 사이트를 통해 기능들을 확인하면 되겠다. 




  개인적으로 사용하면서 Trac과 유사한 환경이여서 사용에 그다지 어려움을 느끼지 못했으며, 기능이나 디자인 면에서는 Trac보다 오히려 나은 느낌을 받았다. 다만 Ruby on Rails라는  (지극히 주관적으로) 생소한 언어 기반으로 만들어져있다보니 설치가 만만치 않았다.


  앞에서도 언급했지만 이 포스팅은 어디까지나 "개인적인" 프로젝트 환경을 설치하는 것이 목적이고, 설치 과정보다는 활용에 그 목적을 두고 있다. 따라서, Redmine을 직접 설치하는 것 보다는, BitNami(http://bitnami.com/)에서 제공하는 패키지 버전인 BitNami Redmine을 설치하도록 한다. 


  설치에 앞서 간단히 알아보자면, BitNami는 오픈 소스에 대한 인스톨러나 패키지를 제공하는 Open Source Project이며, Bitrock이라는 우리에겐 다소 생소한 업체(개인적인 생각은, 매우 훌륭한 업체라는 생각이 들고... 상을 주고 싶다... ㅋㅋ)에서 관리되고 있다.(출처: http://en.wikipedia.org/wiki/BitNami)




  BitNami는 Redmine 외에도 Subversion, JBoss, Mantis, Tomcat, Trac 등 다양한 오픈 소스에 대한 인스톨러를 제공한다. 제공되는 방식에 따라 3가지 정도의 버전을 확인할 수 있다. 

  • Native Installers
    • 일반적인 PC나 서버에 설치하기 위한 인스톨러
    • Stand-alone Stack 형태로 제공되거나, Module 형태로 제공
      • Stand-alone Stack : 설치 시 단독으로 돌 수 있는 형태의 인스톨러
      • Module : 이미 설치된 Stack이 있다면 module을 설치하여, 기존 Stack의 기능에 결합할 수 있음
    • 윈도우, 리눅스, 맥OS 등의 플랫폼 지원
  • Virtual Machines
    • VMWare 또는 VirtualBox 등에 설치를 위한 인스톨러를 지원
  • Cloud Templates
    • Cloud Hosting에 설치할 수 있는 버전을 제공
  더 자세한 내용을 알고 싶다면, 공식 홈페이지(http://bitnami.com/learn_more/partners)를 참고한다. 

  이 포스팅에서는 BitNami Redmine 2.3.0 window용 인스톨러(stand-alone, native installer)를 이용하여 설치하는 과정을 간단히 살펴본다.


2. Bitnami-redmine-2.3.0-0-windows-installer.exe 설치


  먼저 공식 사이트에서 Redmine 인스톨러를 다운로드 받는다. 현재(2013.04.14) 2.3.0 버전이 사용 가능하며, 이 버전은 다음과 같이 구성되어 있다. 
  • Redmine 2.3.0
  • Apache 2.2.24
  • ImageMagick 6.7.5
  • MySQL 5.5.29
  • Subversion 1.7.5
  • Git 1.7.11.3
  • Ruby 1.9.3-p392
  • Rails 3.2.13
  • RubyGems 1.8.12

  다운로드 받은 인스톨러를 이용하여 설치를 시작한다. 설치 과정은 한국어를 지원하며, 대부분 Default 값을 적용하여 Next를 누르는 과정이므로, 다른 부분은 별도로 설명하지 않는다. 


※ 예전 아래 설정에서 이름을 한글로 넣었더니 Redmine이 작동을 재대로 하지 않아 애를 먹었던 적이 있었다. 되도록이면 영어로 설정하는 것을 추천한다. 

※ 이메일 지원 기능 역시 되도록이면 설치 이후에 설정파일을 통해 설정하는 것을 추천한다. 설정이 재대로 되지 않아 애를 많이 먹었던 것 같다.




  설치가 완료된 후, 다음과 같이 어플리케이션을 구동시키면 설치가 완료된다. 



  설치가 완료되면, 브라우져에서 localhost:[설정한 포트]로 접속을 시도한다. 이 때, 아래와 같은 화면을 확인할 수 있으며, 여기서 Access BitNami Redmine Stack 을 클릭하면 레드마인 페이지를 확인할 수 있다. 




  초기화면에서 로그인한 후, 다른 계정과 프로젝트를 등록하거나 기타 작업을 수행함으로써 Redmine을 사용할 수 있다. 





+ Recent posts