Redmine 설치 및 플러그인 적용

프로젝트 관리도구

Redmine 설치 및 플러그인 적용

레드마인은 웹 기반의 프로젝트 관리 와 버그 추적 기능을 제공하는 오픈 소스 프로그램으로 다중 프로젝트 지원, 유연한 이슈추적 기능, 간트 차트와 달력기능 제공, 이메일 알람기능 외에도 플러그인 기능 지원을 통해 상용 프로젝트 관리 도구 못지 않게 사용할 수 있다. CentOS 7에 Bitnami를 Redmine 설치 및 플러그인, 테마 적용하는 방법을 소개한다.

Redmine

레드마인(Redmine)은 오픈 소스 프로그램으로 웹 기반의 프로젝트 관리 와 버그 추적 기능을 제공하는 도구이다.

화면기반의 프로젝트 관리에 도움이 되도록 달력과 간트 차트를 제공하고 일정관리 기능을 제공한다.

또한 레드마인은 통합된 프로젝트관리 기능과 이슈추적, 여러가지 형상 관리 기능을 제공한다.

레드마인은 루비 온 레일즈에 기반하여 작성되었고 멀티 플랫폼을 지원하며 여러가지 종류의 데이터베이스 및 34개의 언어를 지원한다.

Bitnami

비트나미(Bitnami)는 가상 어플라이언스 및 웹 애플리케이션, 개발 스택용 소프트웨어 패키지 및 설치 라이브러리이다.
레드마인을 한 번의 클릭으로도 손쉽게 설치할 수 있도록 패키징하여 제공한다.

Bitnami Redmine 다운로드

아래 사이트에서 최신 버전의 설치파일을 다운 받을 수 있다.
https://bitnami.com/stack/redmine/installer

구버전 설치파일은 Bitnami comuunity 게시판에 요청하면 Bitnami 개발자들이 link를 알려준다.

Bitnami Redmine linux installer 3.4.6-5 :
https://downloads.bitnami.com/files/stacks/redmine/3.4.6-5/bitnami-redmine-3.4.6-5-linux-x64-installer.run
Bitnami Redmine linux installer 4.0.2-3 :
https://downloads.bitnami.com/files/stacks/redmine/4.0.2-3/bitnami-redmine-4.0.2-3-linux-x64-installer.run

CentOS Linux 7에 Bitnami Redmine 설치

# 최신버전을 아직 지원하지 않는 레드마인 플러그인이 있어 3.4.6-5 버전으로 설치
$ wget https://downloads.bitnami.com/files/stacks/redmine/3.4.6-5/bitnami-redmine-3.4.6-5-linux-x64-installer.run
$ chmod 775 bitnami-redmine-3.4.6-5-linux-x64-installer.run
$ ./bitnami-redmine-3.4.6-5-linux-x64-installer.run
Language Selection

Please select the installation language
[1] English - English
[2] Spanish - Español
[3] Japanese - 日本語
[4] Korean - 한국어
[5] Simplified Chinese - 简体中文
[6] Hebrew - עברית
[7] German - Deutsch
[8] Romanian - Română
[9] Russian - Русский
Please choose an option [1] : 4
----------------------------------------------------------------------------
Bitnami Redmine Stack 설치 마법사를 시작합니다.

----------------------------------------------------------------------------
설치할 구성 요소를 선택하십시오. 설치하지 않을 구성 요소는 선택을 취소하십시오. 계속할 준비가 되면 다음을 클릭하십시오.

Subversion [Y/n] :y

PhpMyAdmin [Y/n] :y

Redmine : Y (Cannot be edited)

Git [Y/n] :y

위의 선택이 정확합니까? [Y/n]: y

----------------------------------------------------------------------------
설치 경로

Bitnami Redmine Stack의 설치 경로를 선택하세요.

폴더 선택 [/opt/redmine-3.4.6-5]: /opt/redmine-3.4.6-5

----------------------------------------------------------------------------
Admin 계정 생성

Bitnami Redmine Stack 관리자 계정을 생성합니다.

이름 [User Name]: admin

이메일 주소 [user@example.com]: 이메일주소

로그인 계정명 [user]: admin

패스워드 :
패스워드를 재입력 :
# 여기서 입력한 비밀번호는 첫 로그인 후 다시 설정하게 된다.
----------------------------------------------------------------------------
기본 데이터 설정에 사용할 언어

기본 데이터 설정 시 사용할 언어를 선택하세요.

[1] Bosnian
[2] 불가리아어
[3] Catalan
[4] 체코어
[5] Danish
[6] 독일어
[7] 영어
[8] 스페인어
[9] 프랑스어
[10] Galician
[11] 히브리어
[12] Hungarian
[13] 이탈리아어
[14] 일본어
[15] 한국어
[16] Lithuanian
[17] 네덜란드어
[18] Norwegian
[19] 폴란드어
[20] 포르투갈어
[21] 루마니아어
[22] 러시아어
[23] Slovak
[24] Slovenian
[25] 세르비아어
[26] 스웨덴어
[27] Turkish
[28] Ukrainian
[29] Vietnamese
[30] 중국어
옵션을 선택하십시오. [15] : 15

사용하시겠습니까? [y/N]: y

----------------------------------------------------------------------------
SMTP 설정

어플리케이션에서 통보가 가능하도록 이메일 지원 기능을

기본 이메일 서비스 제공자

[1] GMail
[2] 사용자 정의
옵션을 선택하십시오. [1] : 1

----------------------------------------------------------------------------
SMTP 설정

This data is stored in the application configuration files and may be visible to
others. For this reason, it is recommended that you do not use your personal
account credentials.

GMail 주소 []: 이메일주소

GMail 패스워드 :
재입력 :
----------------------------------------------------------------------------
이제 컴퓨터에 Bitnami Redmine Stack을() 설치할 준비가 되었습니다.

계속하시겠습니까? [Y/n]: y

----------------------------------------------------------------------------
컴퓨터에 Bitnami Redmine Stack을() 설치하는 동안 기다려 주십시오.

 설치
 0% ______________ 50% ______________ 100%
 #########################################

----------------------------------------------------------------------------
컴퓨터에 Bitnami Redmine Stack 설치를 완료했습니다.

Redmine 어플리케이션 구동 [Y/n]: y

정보: To access the Bitnami Redmine Stack, go to
http://127.0.0.1:80 from your browser.
계속하려면 [Enter] 키 누르기:

Redmine 실행/중지

/opt/redmine-3.4.6-5/ctlscript.sh start
/opt/redmine-3.4.6-5/ctlscript.sh stop
/opt/redmine-3.4.6-5/ctlscript.sh restart

SMTP 설정

레드마인 메일알림을 이용하기 위해 SMTP 설정을 한다.

  • 설정파일 수정
vi /opt/redmine-3.4.6-5/apps/redmine/htdocs/config/configuration.yml
  • 하단 production 부분을 수정한다.
production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      enable_starttls_auto: true
      address: "smtp.gmail.com"
      port: 25
      domain: "smtp.gmail.com"
      authentication: :login
      user_name: "이메일주소"
      password: "비밀번호"
구글 보안 수준 변경 화면
보안 수준이 낮은 앱 허용을 사용으로 변경한다.
/opt/redmine-3.4.6-5/ctlscript.sh restart
  • 관리 > 설정 > 메일알림 페이지에서 테스트메일보내기
레드마인 테스트메일 보내기
성공시 상단에 “‘이메일주소’님에게 메일이 발송되었습니다.” 라는 문구가 나온다.

Plugin 설치

플러그인 다운로드 : https://www.redmine.org/plugins?page=1
레드마인 버전에 맞는 플러그인을 받아 사용한다.

  • 플러그인 다운받아 아래 경로에 압축 해제
/opt/redmine-3.4.6-5/apps/redmine/htdocs/plugins
  • 플러그인 다운 페이지에서 설명하는 이름으로 폴더명을 변경한다.
  • Bitnami Console 실행 후 ‘/apps/redmine/htdocs’ 경로에서 플러그인 설치 스크립트를 실행한다.
/opt/redmine-3.4.6-5/use_redmine
cd /opt/redmine-3.4.6-5/apps/redmine/htdocs
bundle install --without development test
rake redmine:plugins:migrate RAILS_ENV=production

레드마인 플러그인 : Progressive Projects List 설치

프로젝트들에 대한 진척도를 bar 형태로 표시해주며, 프로젝트의 version를 기준으로 issue 현황을 파악하는 플러그인
https://www.redmine.org/plugins/progressive-projects-list

프로젝트 화면
프로젝트들에 대한 진척도를 bar 형태로 표시
cd /opt/redmine-3.4.6-5/apps/redmine/htdocs/plugins
wget https://github.com/ergoserv/redmine-progressive-projects-list/archive/v4.0.0.tar.gz
tar -xvf v4.0.0.tar.gz
rm v4.0.0.tar.gz
mv redmine-progressive-projects-list-4.0.0 progressive_projects_list
/opt/redmine-3.4.6-5/use_redmine
cd /opt/redmine-3.4.6-5/apps/redmine/htdocs
bundle install --without development test
rake redmine:plugins:migrate RAILS_ENV=production
  • 오류 발생 시 아래 명령어 실행 후 다시 시도
bundle install --no-deployment
rake redmine:plugins:migrate RAILS_ENV=production
  • 레드마인 재실행
exit
/opt/redmine-3.4.6-5/ctlscript.sh restart

레드마인 플러그인 : CKEditor 설치

레드마인 문서 작성시 텍스타일 문법이 아닌 위지윅(WYSIWYG) 에디터인 CKEditor로 변경
https://www.redmine.org/plugins/redmine-ckeditor

cd /opt/redmine-3.4.6-5/apps/redmine/htdocs/plugins
wget https://github.com/a-ono/redmine_ckeditor/archive/1.1.7.tar.gz
tar -xvf 1.1.7.tar.gz
rm 1.1.7.tar.gz
mv redmine_ckeditor-1.1.7 redmine_ckeditor
/opt/redmine-3.4.6-5/use_redmine
cd /opt/redmine-3.4.6-5/apps/redmine/htdocs
bundle install --without development test
rake redmine:plugins:migrate RAILS_ENV=production
  • 오류 발생 시 아래 명령어 실행 후 다시 시도
bundle install --no-deployment
rake redmine:plugins:migrate RAILS_ENV=production
  • 레드마인 재실행
exit
/opt/redmine-3.4.6-5/ctlscript.sh restart
  • 레드마인 관리 > 설정 > 일반 > 본문 형식을 Ckeditor로 변경
레드마인 에디터 설정 화면
본문 형식을 Ckeditor로 변경 후 저장

CKEditor 플러그인 설치하기 : Paste image as base64 설치

문서 작성 시 클립보드에 있는 이미지를 그대로 붙일 수 있는 플러그인 https://ckeditor.com/cke4/addon/pastebase64

  • 플러그인을 다운받아 아래 경로에 넣기
cd /opt/redmine-3.4.6-5/apps/redmine/htdocs/plugins/redmine_ckeditor/assets/ckeditor-contrib/plugins
wget https://download.ckeditor.com/pastebase64/releases/pastebase64_1.0.zip
unzip pastebase64_1.0.zip
rm pastebase64_1.0.zip
  • CKEditor 설정파일 수정
vi /opt/redmine-3.4.6-5/apps/redmine/htdocs/plugins/redmine_ckeditor/assets/ckeditor/config.js

CKEDITOR.editorConfig에 “config.extraPlugins = ‘pastebase64’” 추가

CKEDITOR.editorConfig = function( config ) {
        config.extraPlugins = 'pastebase64'
};
  • CKEditor init.rb에 base64 allow 옵션 추가
vi /opt/redmine-3.4.6-5/apps/redmine/htdocs/plugins/redmine_ckeditor/init.rb

하단에 아래 구문 추가

Loofah::HTML5::WhiteList::ALLOWED_PROTOCOLS.add('data')
  • 폴더 및 파일 권한 변경
chmod 777 /opt/redmine-3.4.6-5/apps/redmine/htdocs/public/plugin_assets/redmine_ckeditor/ckeditor-contrib/plugins
chmod 777 /opt/redmine-3.4.6-5/apps/redmine/htdocs/public/plugin_assets/redmine_ckeditor/ckeditor/config.js
  • 레드마인 재실행
/opt/redmine-3.4.6-5/ctlscript.sh restart

Plugin 삭제

/opt/redmine-3.4.6-5/use_redmine
cd /opt/redmine-3.4.6-5/apps/redmine/htdocs
rake redmine:plugins:migrate NAME=플러그인명 VERSION=0 RAILS_ENV=production
exit
rm -rf /opt/redmine-3.4.6-5/apps/redmine/htdocs/plugins/플러그인명

Redmine Log 보기

tail -1000f /opt/redmine-3.4.6-5/apache2/logs/error_log
tail -1000f /opt/redmine-3.4.6-5/apps/redmine/htdocs/log/production.log

Redmine 테마 설치

테마 다운로드 : https://www.redmine.org/projects/redmine/wiki/Theme_List

  • 플러그인 다운받아 아래 경로에 압축 해제
/opt/redmine-3.4.6-5/public/themes/
  • 레드마인 재실행
/opt/redmine-3.4.6-5/ctlscript.sh restart
  • 관리 > 설정 > 표시방식에서 원하는 테마 선택
레드마인 테마 설정 화면
표시방식에서 원하는 테마 선택

다른 프로젝트 관리도구

레드마인 외에도 아래와 같은 관리도구들이 있다.

참고자료

Bitnami 레드마인 Installer : https://bitnami.com/stack/redmine/installer

Bitnami 커뮤니티 게시판 : https://community.bitnami.com

구글 계정 고객센터 : https://support.google.com/accounts/answer/6010255?hl=ko

레드마인 플러그인 다운로드 : https://www.redmine.org/plugins?page=1

레드마인 테마 다운로드 : https://www.redmine.org/projects/redmine/wiki/Theme_List

CKEditor 플러그인 다운로드 : https://ckeditor.com/cke4/addons/plugins/all

관련글

대화 및 토론