'backlogs'에 해당되는 글 1건

  1. 2013.03.04 Redmine Backlogs 설치
Software / Eclipse2013. 3. 4. 10:49

Redmine + Backlogs


Redmine을 이용해서 관리를 하는데 사실 거의 Text 기반으로 관리하기 때문에 심심하다.

요새같은 세상이 GUI가 그렇게 좋지 않은 것은 엄청난 흠결이다.


Text Editor도 WYSWYG이 아니기 때문에 문제가 있다.


이런 저런 PlugIn들이 많이 있어서 나름대로 보강을 해가며 사용할 수는 있지만, 의외로 Redmine에서는 버전 문제가 발목을 잡는 경우가 많다.


BackLogs는 Redmine을 Agile한 방법으로 운용할 수 있도록 도와주는 PlugIn이다.


http://www.redminebacklogs.net


특징은 아래와 같다.


  • Sort stories in your product and iteration backlogs
  • Track story points for each of your stories
  • Display burndown charts to show progress
  • Track tasks via your iteration’s taskboard
  • Produce printable task board cards
  • Track impediments within each iteration

설치


설치는 아래의 링크에서 참조한다.


http://www.redminebacklogs.net/en/installation.html


설치는 기존에 설치된 Redmine의 방식에 따라서 조금씩 틀리는데


generic

RHEL 5.x

Dreamhost

Bitnami Redmine stack


4가지 방법 중 한가지를 선택하여 할 수 있다.

공식적으로 설치하고 지원되는 버전은 
Redmine 2.0.4, 2.1.6 and 2.2.3

이다.


다른 버전도 설치되고 운용되지만, 지원은 하지 않는다.


Check Gems


설치하기 전에 BitNaMi 환경으로 준비되어 있는지 확인한다.


export GEM_HOME=<path to bitnami stack>/redmine-<version>/ruby/lib/ruby/gems/1.8/gems 
export PATH=<path to bitnami stack>/redmine-<version>/ruby/bin:$PATH
위의 방식에 따라서 아래와 같이 입력한다.

export GEM_HOME=/Applications/redmine-2.2.3-0/ruby/lib/ruby/gems/1.9.1/gems/
export PATH=/Applications/redmine-2.2.3-0/ruby/bin/:$PATH


GEM 1.0.4에서는 문제가 있어서 1.0.3 버전에서 Upgrade를 할 것을 권하고 있다.


freegearMBP:htdocs freegear$ gem install holidays --version 1.0.3

Successfully installed holidays-1.0.3

1 gem installed

Installing ri documentation for holidays-1.0.3...

Installing RDoc documentation for holidays-1.0.3...

freegearMBP:htdocs freegear$ gem install holidays

Successfully installed holidays-1.0.5

1 gem installed

Installing ri documentation for holidays-1.0.5...

Installing RDoc documentation for holidays-1.0.5...


일단 1.0.5 버전으로 Upgrade된다.

- BackLogs가 반드시 1.0.4를 요구하지 않고 있고 최신 버전이 1.0.5이므로 그냥 사용하기로한다.


Install Backlogs


설치 방식은 몇가지로 다시 나누어서 설명한다.


#Method 1

  이 방식은 git로 backlogs를 다운받아서 설치하는 것이다. git에 대해서 기본적인 지식이 있어야 하지만, 그렇게 심각하게 필요하지도 않다.


설치하기 위해서는 `vendor/plugins` 폴더에 위치하고 있어야 한다.

내 경우에는 

/Applications/redmine-2.2.3-0/apps/redmine/htdocs/plugins

에서 작업한다.


우선 git를 이용해서 backlogs를 다운로드 받는다. 커맨드는 아래와 같다.


git clone git://github.com/backlogs/redmine_backlogs.git



주의할 점은 받드시 폴더 이름을 바꾸면 안된다는 것이다.

그냥 redmine_backlogs를 그대로 사용하여야 한다.


freegearMBP:plugins freegear$ git clone git://github.com/backlogs/redmine_backlogs.git

Cloning into 'redmine_backlogs'...

remote: Counting objects: 19967, done.

remote: Compressing objects: 100% (6831/6831), done.

remote: Total 19967 (delta 13184), reused 19223 (delta 12563)

Receiving objects: 100% (19967/19967), 9.76 MiB | 148 KiB/s, done.

Resolving deltas: 100% (13184/13184), done.

freegearMBP:plugins freegear$ ls

README redmine_backlogs


우선 redmine_backlogs로 들어간다.


freegearMBP:plugins freegear$ ls

README redmine_backlogs

freegearMBP:plugins freegear$ cd redmine_backlogs/

freegearMBP:redmine_backlogs freegear$


이제 여기서 다운 가능한 버전을 확인한다. 


git tag 커맨드로 확인한다.


freegearMBP:redmine_backlogs freegear$ git tag

v0.6.20

v0.6.21

v0.6.22

v0.6.23

v0.7.0

v0.7.1

v0.7.2

v0.7.3

v0.7.4

v0.7.5

v0.7.6

.......

v0.9.4

v0.9.5

v0.9.6

v0.9.7

v0.9.8

v0.9.9


최신 버전은 0.9.9이다. 이버전을 다운받는다.


git checkout v0.9.9

(주: 이버전으로 하여 설치가 안되어서 0.9.36으로 설치하여 성공하였다)


로 다운 한다.



#Method 2


이것은 웹에서 ZIP 파일로 다운 받는 과정이다.

#1로 진행했으면 굳이 여기서는 설명하지 않는다.

(안되면 다시 #2를 진행해 보겠다.)


Pre-install Tasks


주의 : 기본적으로 별다른 언급이 없으면  development environment로 진행된다. 만약 특별히 이런 것에 문제가 있거나 싫다면 별도로 production으로 언급해주면 된다.


RAILS_ENV=production
export RAILS_ENV


다음은 redmine이 제대로 설치되었는지 확인하는 단계이다.

redmine이 설치된 top folder에서 다음 커맨드를 실행한다.


bundle exec rake db:migrate

설치된 폴더는 아래와 같다.


/Applications/redmine-2.2.3-0/apps/redmine/htdocs



위의 커맨드를 넣으면 오류가 아래와 같이 나온다.

freegearMBP:htdocs freegear$ bundle exec rake db:migrate

You cannot specify the same gem twice with different version requirements. You specified: test-unit (>= 0) and test-unit (= 1.2.3)

*(주) 관련된 오류에 대한 정보는 아래 링크에서 얻을 수 있다.

http://forum.redminebacklogs.net/Re-using-Baclogs-on-Redmine-2-2-0-td4025406.html



Root에 있는 Gemfile을 수정한다.


    gem "test-unit", :platforms => platforms


을 


     if RUBY_VERSION >= "1.9" 
      gem "test-unit", "=1.2.3" 
     else 
      gem "test-unit", :platforms => platforms 
     end 


으로 수정한다.


다시 실행하면 아래와 같은 에러가 나타난다.


freegearMBP:htdocs freegear$ bundle exec rake db:migrate

Could not find gem 'test-unit (= 1.2.3) ruby' in the gems available on this machine.

Run `bundle install` to install missing gems.




이 문제에 대한 해결 정보는 아래 링크에서 확인한다.

http://kadzusa.com/?p=122


아래의 커맨드로 설치한다.


gem install test-unit -v 1.2.3




freegearMBP:htdocs freegear$ gem install test-unit -v 1.2.3

Fetching: test-unit-1.2.3.gem (100%)

Successfully installed test-unit-1.2.3

1 gem installed

Installing ri documentation for test-unit-1.2.3...

Building YARD (yri) index for test-unit-1.2.3...

Installing RDoc documentation for test-unit-1.2.3...


이제 실행하면 다시 에러가 발생한다.



freegearMBP:htdocs freegear$ bundle exec rake db:migrate

Could not find gem 'holidays (= 1.0.3) ruby' in the gems available on this machine.



이제는 에러에 대해서 자연스럽게(?) 진행 가능한다

빠진 패키지를 넣고 실행한다.


freegearMBP:htdocs freegear$ gem install holidays -v 1.0.3

Fetching: holidays-1.0.3.gem (100%)

Successfully installed holidays-1.0.3

1 gem installed

Installing ri documentation for holidays-1.0.3...

Building YARD (yri) index for holidays-1.0.3...

[error]: ParserSyntaxError: syntax error in `lib/holidays/united_nations.rb`:(15,25): syntax error, unexpected ']', expecting tSTRING_CONTENT or tSTRING_DBEG or tSTRING_DVAR or tSTRING_END

[error]: Stack trace:

/Applications/redmine-2.2.3-0/ruby/lib/ruby/gems/1.9.1/gems/yard-0.8.1/lib/yard/parser/ruby/ruby_parser.rb:533:in `on_parse_error'

/Applications/redmine-2.2.3-0/ruby/lib/ruby/gems/1.9.1/gems/yard-0.8.1/lib/yard/parser/ruby/ruby_parser.rb:50:in `parse'

/Applications/redmine-2.2.3-0/ruby/lib/ruby/gems/1.9.1/gems/yard-0.8.1/lib/yard/parser/ruby/ruby_parser.rb:50:in `parse'

/Applications/redmine-2.2.3-0/ruby/lib/ruby/gems/1.9.1/gems/yard-0.8.1/lib/yard/parser/ruby/ruby_parser.rb:15:in `parse'

/Applications/redmine-2.2.3-0/ruby/lib/ruby/gems/1.9.1/gems/yard-0.8.1/lib/yard/parser/source_parser.rb:439:in `parse'

/Applications/redmine-2.2.3-0/ruby/lib/ruby/gems/1.9.1/gems/yard-0.8.1/lib/yard/parser/source_parser.rb:44:in `parse'


Installing RDoc documentation for holidays-1.0.3...


이제 다시 실행 해보자


freegearMBP:htdocs freegear$ bundle exec rake db:migrate

You have requested:

  gherkin = 2.6.8


The bundle currently has gherkin locked at 2.11.6.

Try running `bundle update gherkin`

Run `bundle install` to install missing gems.



일단 gherkin 이라는 GEM이 없다고 나온다. 이를 다시 설치한다.


Gemfile.lock 파일에서 gherkin 버전을 수정한다.


== WAS ==

 69     gherkin (2.11.6)

==  IS ==

 69     gherkin (2.6.8)


 그러면 아래와 같이 진행되고 새로운 오류가 나온다.


freegearMBP:htdocs freegear$ bundle exec rake db:migrate

Could not find gem 'hoe (= 1.5.1) ruby' in the gems available on this machine.

Run `bundle install` to install missing gems.



freegearMBP:htdocs freegear$ gem install hoe -v 1.5.1

Fetching: json_pure-1.7.7.gem (100%)

Fetching: rubyforge-2.0.4.gem (100%)

.....


<< 이런 부분에 대한 설명은 SKIP 계속 같은 패턴이다. >>



진행을 하다가 보면 앞서 gherkin에서 버전 번호를 강제로 바꾼 것이 문제가 발생하여 더이상 진행이 안된다.


이떄 다시 


bundle install


을 하여서 설치하고 


계속 같은 방식으로 진행하면 된다.


설치가 완료되면 


bundle exec rake tmp:cache:clear
bundle exec rake tmp:sessions:clear


으로 클리어를 시키고


cd path/to/redmine
bundle exec rake redmine:backlogs:install


으로 설치한다.


이때에도 몇가지 Gem File을 찾는데 설치하면 된다.


bundle exec rake redmine:backlogs:install parameter=value parameter=value ...


그런 뒤에 Redmine을 재실행한다.


이후 관리 -> 플러그인 을 클릭해서 들어가면 아래와 같은 창이 나타난다.


설정을 눌러서 내용을 설정한다.


설정 내용이나, 사용에 대해서는 다음에 다시 정리..






Posted by GUNDAM_IM