레드마인은 플러그인 구조를 채택하여 기능을 확장할 수 있으며 이를 이용하여 많은 사용자들이 자발적으로 플러그인을 만들어서 제공하고 있다.

이번 절에서는 레드마인에서 플러그인을 설치하고 삭제하는 방법을 알아보고 레드마인 사용을 편리하게 도와 주는 대표적인 플러그인에 대해서 살펴 보자.

 

설치와 삭제

어떤 플러그인들이 있는지 사용자들의 평가는 어떤지는 레드마인의 플러그인 페이지(http://www.redmine.org/plugins) 에서 찾아볼 수 있다. 대부분의 플러그인은 여기에 등록되며 그외에 git 기반의 소스 호스팅 사이트인 github.com 를 통해 개발되는 플러그인도 다수 있다.

github 에서는 키워드를 "redmine plugin" 으로 검색하면 상당의 많은 수의 플러그인 프로젝트가 출력되니 이중에서 독자가 필요로 하는 플러그인이 있는지 확인해 보자.

 

설치

레드마인 2.x 대부터는 플러그인 설치 디렉터리가 vendor/plugins 에서 plugins 디렉터리로 변경이 되었다. 거의 대부분의 플러그인은 표준화된 설치와 삭제 과정을 통해 관리할 수 있다.

 

설치는 일반적으로 다음 3단계를 거치면 되며 2와 3 단계는 플러그인마다 다르므로 플러그인 설치 항목에서 따로 설명하도록 하겠다.

 

  1. 플러그인의 소스를 git 이나 서브버전 저장소로부터 체크 아웃하거나 또는 zip 이나 tar.gz 로 제공되는 패키지를 다운로드 한후에 plugins 디렉터리에 압축을 해제
  2. 레드마인 설치 디렉터리에서 번들 명령어로 데이타 이관을 실행한다.

    bundle exec rake redmine:plugins:migrate RAILS_ENV=production

  3. 루비 서드파티 라이브러리(gem) 가 필요한 플러그인일 경우 번들 명령어로 설치한다. 

    bundle install --without development test

  4. 레드마인을  재구동한다.

삭제

삭제는 매우 간단하다. 

  1. 레드마인 설치 디렉터리에서 번들 명령어를 실행한다. plugin_name 에는 삭제할 플러그인의 이름을 적어준다.

    bundle exec rake redmine:plugins:migrate VERSION=0 RAILS_ENV=production NAME=plugin_name

  2. plugins/ 내 플러그인 디렉터리를 삭제한다. (옵션)
  3. 레드마인을 재구동한다.

 

이제 설치와 삭제 방법을 알았으니 플러그인을 설치해 보자.

redmine ckeditor

제일 먼저 소개할 플러그인은 유명한 웹 에디터인 ckeditor 를 레드마인에 적용하여 WYSIWYG  방식으로 글을 작성할 수 있게 하는 redmine_ckeditor 플러그인이다.

레드마인의 텍스타일 마크업 대신 ckeditor 를 적용하여 편리하게 글을 작성할 수 있어서 비개발 부서원의 참여를 이끌어 내는데는 유용한 플러그인이지만 2가지 큰 단점이 있다.

하나는 프로젝트별로 ckeditor 사용 여부를 결정할 수 없고 전역적으로 설정해야 한다는 점이다.

그리고 나머지 하나는 더 큰 단점으로 ckeditor 플러그인이 텍스타일 문법으로 변환해 주는게 아니고 HTML 문법을 사용하므로 기존에 텍스타일로 작성한 모든 글은 제대로 표시가 되지 않는다는 문제가 있다.

이는 텍스타일에서 ckeditor 로 혹은 그 반대로 이관할 때 기존에 작성한 문서의 형식이 모두 깨지게 되므로 어떤 방식을 채택하든 한 번 결정하게 되면 변경이 매우 힘들게 된다.


위와 같은 제약을 충분히 알아두고 플러그인을 설치해 보자.

  1. 먼저 소스를 github 에서 체크아웃 받는다.

    git clone https://github.com/a-ono/redmine_ckeditor.git plugins/redmine_ckeditor

  2. 데이타 이관을 실행한다.

    bundle exec rake redmine:plugins:migrate RAILS_ENV=production

  3. 레드마인을 재구동한다.

    ./redmine_unicorn.sh restart

     

"관리" -> "플러그인" 항목에 들어가 보면 설치된 플러그인 목록을 볼 수가 있으며 개별 설정은 목록에서 "설정" 버튼을 누르면 된다.

플러그인 목록

 ckeditor 플러그인 사용 여부는 "관리" -> "설정" -> "일반" 탭에서 본문 형식 리스트 박스에서 설정할 수 있다. 기본 값인 Textile 대신 CKEditor 를 선택하면 모든 글쓰기의 에디트 창이 ckeditor 로 변경된다.

ckeditor 편집기

위와 같이 위지위그 방식으로 쉽게 글을 작성할 수 있지만 텍스타일 숙련자는 오히려 속도가 느려질 수 있으며 본문 형식을 텍스타일로 변경할 경우 기작성 문서가 아래와 같이 태그가 그대로 보인다는 것을 알아 두고 사용해야 한다.

본문 형식 변경

 

Redmine screenshot paste plugin

레드마인 이슈를 작성할 때 오류 화면 등을 캡춰해서 첨부하면 이슈 처리에 도움이 될 것이다. 오류 화면은 PC 에서 캡춰후 파일로 저장한 다음에 이슈 등록시 "파일 찾기" 로 PC 에 있는 파일을 찾아서 첨부해야 한다.

스크린샷 페이스트 플러그인은 Java 의 Applet 으로 동작하는 플러그인으로  스크린 샷을 바로 이슈에 첨부할 수 있게 해주는 플러그인이다.

설치는 github 에서 체크아웃 한 후 레드마인을 재기동하면 된다.

git clone https://github.com/undx/redmine_screenshot_paste.git plugins/redmine_screenshot_paste

 

설치가 완료되고 이슈 등록 화면에 들어가면 다음과 같이 "스크린샷" 버튼이 생기고 이를 클릭하면 바로 붙여 넣기가 가능하다.

스크린 샷 플러그인 동작 화면

JRE 의 강화된 보안때문에 자체 서명된 애플릿은 구동이 안 될 수 있다. 이럴 경우 1.7.51 이상의 JRE 를 설치한 후에 윈도의 "제어판" - "자바 제어판" 으로 들어간 후에 "보안" 의 "사이트 목록 편집" 에 레드마인 URL 을 넣어주어야 한다.

JRE 예외 추가

 

Redmine Lightbox plugin

레드마인은 이미지를 이슈에 첨부할 수 있지만 첨부 파일을 보려면 클릭해야 하고 또 새 창으로 뜨므로 예전 페이지로 다시 돌아가야 하는 불편함이 있다.

라이트박스 플러그인은 이슈에 첨부된 이미지를 썸네일로 바로 보여주며 클릭하면 현재 창에서 보여주며 다음 이미지와 이전 이미지를 볼 수 있는 기능을 제공하는 간단하고 유용한 플러그인이다.

 

설치는 github 에서 소스를 클론한 후에 데이타 이관을 하고 레드마인을 재구동하면 된다.

git clone https://github.com/thorin/redmine_lightbox.git plugins/redmine_lightbox
bundle exec rake redmine:plugins:migrate RAILS_ENV=production 

이슈내 첨부된 이미지

 

redmine_dashboard

대시보드 플러그인은 이슈의 상태, 버전, 담당자별로 한 눈에 보기 좋게 대시보드로 표시해 주는 플러그인이다.

등록된 이슈는 드래그앤 드랍으로 이슈의 상태를 손쉽게 변경할 수 있다.


설치는 다음 절차에 따르면 되고 별도의 데이타베이스 마이그레이션은 필요없고 루비 서드파티 라이브러리가 필요하므로 bundle install 을 실행해야 한다.


  1. 프로젝트 소스를 플러그인  복제한 후에 안정 버전으로 체크아웃 한다.

    git clone https://github.com/jgraichen/redmine_dashboard.git plugins/redmine_dashboard
    cd plugins/redmine_dashboard
    git checkout v2.3.3
    cd ../..

     

  2. 루비 서드파티 라이브러리가 필요하므로 bundle install 을 실행한다.

    bundle install --without development test

  3. 레드마인을 재기동한다.

 

설치가 완료됐다면 대시보드를 사용할 프로젝트에서 "설정" -> "모듈" 에서 Dashboard 를 체크해 주면 되며 이슈를 마우스로 끌어다 놓으면 상태가 변경된다.

대시보드 화면

 

레드마인의 플러그인 설치 방법과 몇 가지 유용한 플러그인에 대해서 알아 보았다. 이외에도 다양한 플러그인이 있으니 레드마인 플러그인 저장소나 github 에서 검색 및 설치하여 레드마인의 기능을 확장하기를 바란다. 





blog comments powered by Disqus