Redmine Plugin 설치시 유의사항

새로운 편의기능을 추가할 수 있기에 새로운 플러그인을 설치한다는 것은 매우 매력적인 일 입니다.

하지만, 플러그인 설치로 인해 500번대 에러를 경험할 수 있고, 그로 인해 문제 해결이 불가능한 상황은 어렵지 않게 마주 할 수 있습니다. 대다수는 필요한 Gem 파일들과의 문제이지만, 원인을 알 수 없는 경우 복구에 매우 많은 시간이 소요됩니다. 

 

오늘은 플러그인 설치시에 주의해야할 사항에 대해 다루고자 합니다.

 

1. 레드마인 백업

DB와 File, 연결되어있는 저장소(Git, SVN등)의 백업은 필수 입니다.

문제가 발생될 수 있는 상황을 고려해 백업을 하거나, VM System의 경우 스냅샷을 필시 만들어 두길 권장합니다.

 

2. 플러그인 요구스펙 확인

• 플러그인 설치시 요구되는 Redmine의 버전인지 확인하세요. 
• 요구사항 보다 낮은 버전(3.x)의 경우 해당 버전에 최적화된 릴리즈 버전 또는 Tag을 검색해서 다운받으세요.
  • 대다수의 플러그인은 Redmine.org의 사이트에 Compatible 버전을 표기하고 있습니다. 해당 버전에 맞는 Tag를 Git에서 검색하세요.)

 

3. 현재 사용중인 Plugin과의 충돌 가능성 확인

Git Issue에서 자신이 사용중인 Plugin 과의 충돌관련한 이슈가 있는지 검색해 보길 권장합니다.

 

 

4. Plugin 설치

대부분의 공통적으로 진행되는 부분이며, 필요에 따라 수행해주어야 하는 구간도 있습니다. 기본 권장은 플러그인 별로 가이드 하고 있는 Install 가이드를 참고하기 바라며, 대부분 아래와 같은 절차로 진행되는 부분이니 참고하기 바랍니다.

.(필요에 따라 DB마이그레이션을 요구할 수도 있습니다.)

 

• 1. Plugin 다운로드

redmine $ cd plugins
redmine/plugins $ git clone clone -b v0.0.1 git://플러그인 주소 

 

• 2. 플러그인 마이그레이션 및 클린업

# DB 마이그레이션
redmine $  bundle exec rake db:migrate RAILS_ENV=production

# 플러그인 마이그레이션
redmine $  bundle exec rake redmine:plugins:migrate RAILS_ENV=production

# 클린업
redmine $  bundle exec rake tmp:cache:clear tmp:sessions:clear RAILS_ENV=production

 

• 3. WAS 재실행

redmine $  sudo service apache2 restart

 

이상 플러그인 설치에 대해 유의할 점과 설치하는 과정에 대해 알아보았습니다.