개인용 Java 기반 프로젝트 환경 설치 - (4) Redmine 과 Mercurial, MyLyn, Email 연동

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/projects/redmine/wiki/EmailConfiguration

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을 재시작하고, "관리 > 설정 > 메일 알림"으로 접속하여 하단의 "테스트 메일 보내기"로 메일 테스트를 수행해본다.