Onionmixer: Gentoo 에서 nginx + thin + redmine 3.4 + mysql + redmine_git_hosting 사용하기 문서 내용 추가

2018-03-12T09:38:58Z

Gentoo 에서 nginx + thin + redmine 3.4 + mysql + redmine_git_hosting 사용하기 문서 내용 추가

New page

;Gentoo 에서 nginx + thin + redmine 3.4 + mysql + redmine_git_hosting 사용하기(20180312)

==개요==

이 문서는 Gentoo linux 에서 redmine 과 mysql 을 ruby 의 gem 을 통해서 설치하는 내용을 다룬다. 시스템은 openrc(기존의 initrd 스타일) 를 사용하는 것으로 전제로 하며, systemd 를 사용하는 경우에 대해서는 별도의 설명을 하지는 않는다.

이 문서는 *설치* 에 대해서만 다루고 있다. redmine 설치 이후의 plugin 사용등에 대한 내용은 인터넷을 참고하도록 한다.

==전제==

시스템에서의 ruby 버전 및 linux system account 에 대한 전제 사항 및 요구사항을 나열한다.

===system infomation===

# redmine account
#* id : redmine
# account home(redmine software base location)
#* /home/redmine

이 redmine 계정은 향후 thin 이라는 ruby container 에서도 사용되기 때문에 유의하는것이 좋다.

===software version===

* ruby 2.2.9
* rubygems 2.6.14
* thin 1.7.2(gem 을 통해서 설치)
* mysql 5.6.x
* redmien 3.4.4
* nginx 1.12.2

===database 정보===

* mysql account
* mysql database name
** redminedb
* mysql database id
** redmine
* mysql database passwd
** redminepw

==redmine 소프트웨어 설치 및 세팅==

===Gentoo 시스템의 준비===

Gentoo Linux 에서 ruby 를 설치할때 필요없는 ruby 에 대한 USE flag 를 설정한다.

* /etc/portage/make.conf

<syntaxhighlight lang="text">
RUBY_TARGETS="ruby22"
</syntaxhighlight>

* /etc/portage/package.use/ruby

<syntaxhighlight lang="text">
dev-lang/ruby -rdoc -socks5
</syntaxhighlight>

다음의 명령을 이용해서 ruby 를 설치한다. 다만 ruby 는 2.2 가 아닌 다른 버전이 설치될 수도 있기 때문에 설치되는 ruby 의 버전을 반드시 신경쓰도록 한다.

<syntaxhighlight lang="text">
emerge --nodeps ruby rubygems
emerge eselect-ruby
</syntaxhighlight>

다음의 명령을 이용해서 이후에 사용할 mysql 을 설치하도록 한다.

<syntaxhighlight lang="text">
USE="-perl" emerge mysql
</syntaxhighlight>

이제 redmine 을 사용하기 위한 redmine 계정을 Gentoo Linux 에 추가하도록 한다. 굳이 비번을 따로 지정할 필요는 없다.

<syntaxhighlight lang="text">
adduser -m redmine
</syntaxhighlight>

===redmine 소스의 세팅===

아래의 주소에서 redmine 소스를 다운로드 받도록 한다. 이 문서에서는 3.4.4 버전을 사용하도록 한다.

* https://www.redmine.org/projects/redmine/wiki/Download

다운로드 받은 파일의 압축을 푸는데, 이때 풀리는 압축은 /home/redmine 디렉토리에 바로 해제되어야 한다. 권한은 root 로 진행해도 상관없다.

<syntaxhighlight lang="text">
cd /home/redmine
tar xvf redmine-3.4.4.tar.gz —strip-components=1
</syntaxhighlight>

압축을 풀고나면 /home/redmine 아래에 다음의 내용이 비슷하게 있어야 한다.

<syntaxhighlight lang="text">
CONTRIBUTING.md
Gemfile
Gemfile.lock
README.rdoc
Rakefile
app
appveyor.yml
bin
config
config.ru
db
doc
extra
files
lib
log
plugins
public
script
test
tmp
vendor
</syntaxhighlight>

===데이터베이스 세팅===

데이터베이스는 다음의 값으로 준비하도록 한다. 위쪽의 내용을 참고해서 자신에게 알맞는 값으로 수정하는 것이 좋다.

<syntaxhighlight lang="sql">
CREATE DATABASE redminedb CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'redminepw';
GRANT ALL PRIVILEGES ON redminedb.* TO 'redmine'@'localhost';

FLUSH PRIVILEGES;
</syntaxhighlight>

===redmine 의 설정파일 세팅===

기본 설정파일을 복사하도록 한다.

<syntaxhighlight lang="text">
cd /home/redmine/config
cp configuration.yml.example configuration.yml
cp database.yml.example database.yml
</syntaxhighlight>

이중에서 configuration.yml 은 본인의 구미에 맞게 설정하도록 하자. 사용하는 VCS 등에 따라서 설정해야할 내용이 많다. 본인의 경우에는 대략 다음과 같이 설정하였다.

* configuration.yml

<syntaxhighlight lang="text">
production:
delivery_method: :smtp
smtp_settings:
address: localhost
port: 25
domain: KKKK.net
authentication: :none
enable_starttls_auto: false
openssl_verify_mode: 'none'

scm_git_command : /usr/bin/git
</syntaxhighlight>

이제 위에 지정한 상황에 맞는 database.yml 파일을 세팅하도록 한다. 본인은 producton 하나의 case 에 대해서만 설정 내용을 남겼다.

* database.yml

<syntaxhighlight lang="text">
production:
adapter: mysql2
database: redminedb
host: localhost
username: redmine
password: "redminepw"
encoding: utf8
</syntaxhighlight>

이제 redmine 에 대한 기본 설정파일을 저장하고 이후의 과정을 진행하도록 한다.

===redmine 을 위한 gem package 의 설치===

일단 gentoo 의 경우는 어떤 gem package 가 설치되어 있을지도 모르기때문에 해당되는 gem package 를 모두 지우도록 한다. 이후에 ruby gem 을 사용하는 유용한 의존성 패키지 관리 시스템인 bundle 만을 설치하도록 한다.

<syntaxhighlight lang="text">
gem uninstall --all --force
gem install bundle
</syntaxhighlight>

이제 redmine 소스가 있는 디렉토리로 이동해서 이후의 gem 패키지 설치를 진행하도록 한다.

<syntaxhighlight lang="text">
cd /home/redmine

bundle lock --add-platform x86-mingw32 x64-mingw32 x86-mswin32
bundle lock --add-platform java

echo "gem 'thin'" >> Gemfile
</syntaxhighlight>

위의 과정을 진행한 이후에 redmine 디렉토리의 Gemfile 내용을 조금 수정하도록 한다. 이 문서를 작성하는 시점에서 redmine_git_hosting 은 redcarpet(gem) 을 3.3.2 를 요구하지만, redmine 은 3.4.0 을 설정하고 있기 때문에 설치 과정에서 오류가 발생하게 된다. 어차피 redmine 에서 markdown 을 사용할일은 그리 많지 않기 때문에 해당되는 부분을 찾아서 수정하도록 하자.

* /home/redmine/Gemfile
** Gemfile 에서 redcarpet 지정부분을 3.4.0 에서 3.3.2 버전으로 수정

이제 gem 패키지를 bundle 을 통해 진행하도록 하자.

<syntaxhighlight lang="text">
bundle install --without development test
</syntaxhighlight>

===기본 gem 패키지 설치 이후의 redmine 설정===

redmine 의 운영에 사용될 token 을 생성하도록 한다.

<syntaxhighlight lang="text">
cd /home/redmime
bundle exec rake generate_secret_token
</syntaxhighlight>

토큰 생성이 종료되었다면 이제 database 의 초기 내용을 집어넣어야 한다.

<syntaxhighlight lang="text">
cd /home/redmine
bundle exec rake db:migrate RAILS_ENV="production"
</syntaxhighlight>

이제 이후의 동작을 위해 redmine 아래쪽의 모든 파일에 대한 권한을 redmine 으로 이관한다.

<syntaxhighlight lang="text">
cd /home/redmine
chown -R redmine:redmine *
</syntaxhighlight>

기본 데이터 베이스가 생성되었다. 이제 redmine 이 정상구동되는지 확인해볼 차례다. 다음의 명령어를 통해 임시로 thin 을 실행해 보도록 한다.

<syntaxhighlight lang="text">
RAILS_ENV=production bundle exec thin start
</syntaxhighlight>

앞쪽의 ENV 를 지정하지 않으면 redmine 은 developer mode 를 찾으며 정상구동되지 않는다. 별다른 문제 없이 정상 구동이 되었다면 웹브라우저를 열어서 redmine 이 세팅된 서버의 3000 포트로 접근해서 redmine 의 초기 화면 및 login 여부를 확인하도록 한다. 기본 값은 admin/admin 이다.

* http://aaa.bbb.ccc.ddd:3000

==plugin 의 설치==

git 연동을 위해서 redmine_git_hosting plugin 을 사용할 것이다. 다른 Plugin 은 github 등과 연결되지만, 별도로 git repository 를 관리하는 경우라면 redmine_git_hosting 외에는 대안이 없다. 글을 작성하는 시점에서는 *1.2.3* 버전이 최신이다.

일단 시스템에서 redmine 계정을 얻는다

<syntaxhighlight lang="text">
su - redmine
</syntaxhighlight>

redmine 권한을 취득했다면 다음의 명령을 실행해서 plugin 을 다운로드 받는다.

<syntaxhighlight lang="text">
cd ~/plugins
git clone https://github.com/jbox-web/redmine_bootstrap_kit.git
cd redmine_bootstrap_kit/
git checkout 0.2.5

cd ~/plugins
git clone https://github.com/jbox-web/redmine_git_hosting.git
cd redmine_git_hosting/
git checkout 1.2.3
</syntaxhighlight>

plugin 파일의 다운로드가 끝났다면, 다시 root 계정으로 이동해서 다음의 작업을 진행한다.

<syntaxhighlight lang="text">
cd /home/redmine
bundle install --without development test
bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=redmine_git_hosting
</syntaxhighlight>

여기까지 진행한 다음에 다시 위쪽의 *thin start* 부분을 실행해서 redmine 의 동작을 확인한다.

==thin 의 설정==

일단 다음의 명령어로 thin 이 gem 을 통해 정상적으로 설치되었는지를 확인한다.

<syntaxhighlight lang="text">
gem list | grep thin
</syntaxhighlight>

thin 의 설치가 확인되었으면 thin binary 의 위치를 확인하도록 한다.

<syntaxhighlight lang="text">
shell# gem contents thin | grep bin
/usr/local/lib64/ruby/gems/2.2.0/gems/thin-1.7.2/bin/thin
</syntaxhighlight>

openrc 를 사용하는 시스템을 전제로 했기 때문에 init.d 에 스크립트를 만들어줘야 한다. 다음의 내용으로 스크립트를 생성한다.

* /etc/init.d/thin

<syntaxhighlight lang="text">
#!/sbin/openrc-run
# Copyright 1999-2016 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2

SERVER=${SVCNAME#*.}
if [ ${SERVER} != thin ]; then
CONFIG=${CONFIG:-/etc/thin/${SERVER}.yml}
else
CONFIG=${CONFIG:-/etc/thin/}
fi
NOCONFIG=${NOCONFIG:-0}
RUBY=${RUBY:-/usr/bin/ruby}
DO_BUNDLER=${DO_BUNDLER:-0}
CHDIR=${CHDIR:-}
THIN_USER=${THIN_USER:-root}
THIN_GROUP=${THIN_GROUP:-root}
THIN_PID=${THIN_PID:-/var/run/thin/thin.pid}
THIN_OPTS=${THIN_OPTS:-}

depend() {
need localmount
}

checkconfig() {
if [ -n ${CHDIR} ]; then
cd "${CHDIR}"

if [ $? -ne 0 ]; then
eerror "Cannot cd into requested directory"
return 1
fi
fi

[ ${SERVER} = thin -o ${NOCONFIG} != 0 ] && return 0

if [ ! -f ${CONFIG} ]; then
eerror "Unable to find the server configuration."
eerror "Please set the CONFIG variable in /etc/conf.d/${SVCNAME} or"
eerror "set NOCONFIG there to 1 to disable looking for a config file."
return 1
fi
}

buildargs() {
if [ ${NOCONFIG} = 0 -a ${SERVER} != thin ]; then
echo -n "-C ${CONFIG} "
fi

echo -n "${THIN_OPTS}"
}

action() {
checkconfig || return 1

[ ${DO_BUNDLER} -ne 0 ] && RUBY="${RUBY} /usr/bin/bundle exec"

if [ ${SERVER} = thin ]; then
ebegin "$2 all thin servers in ${CONFIG}"
${RUBY} /usr/local/lib64/ruby/gems/2.2.0/gems/thin-1.7.2/bin/thin $1 $(buildargs) --all ${CONFIG}
eend $?
else
ebegin "$2 thin server ${SERVER}"
${RUBY} /usr/local/lib64/ruby/gems/2.2.0/gems/thin-1.7.2/bin/thin $(buildargs) --tag ${SERVER} $1
eend $?
fi
}

start() {
action start 'Starting'
}

stop() {
action stop 'Stopping'
}

restart() {
action restart 'Restarting'
}

start_pre() {
# If the path to the pidfile is /var/run/thin/foo/thin.pid
# then checkpath will fail if /var/run/thin/ does not exist.
# This caught infra...
d=$(dirname ${THIN_PID})
mkdir -p "$d"
checkpath -d -m 0775 -o ${THIN_USER}:${THIN_GROUP} "$d"
}
</syntaxhighlight>

해당되는 스크립트에 chmod +x 등으로 실행 권한을 부여한다. 다만 주의할 점이 있는데 당신의 환경에 따라 thin binary 의 위치가 달라질 수 있다. 이 경우 위의 스크립테에서 해당되는 부분을 앞에서 알아낸 thin 경로로 바꿔주면 된다.

이 스크립트는 /etc/thin 이라는 디렉토리 안쪽에 있는 yml 확장자의 내용을 읽어들여 실행한다.

===thin 을 위한 yml 설정===

thin 을 구동시키기 위해 redmine 을 위한 yml 을 생성하도록 한다.

* /etc/thin/redmine.yml

<syntaxhighlight lang="text">
pid: /home/redmine/tmp/pids/thin.pid
group: redmine
wait: 30
timeout: 30
log: /var/log/thin.log
max_conns: 1024
require: []

environment: production
max_persistent_conns: 512
servers: 4
daemonize: true
user: redmine
socket: /tmp/thin.sock
chdir: /home/redmine
</syntaxhighlight>

위의 내용에서 참고해야할 부분은 다음과 같다.

* log 파일의 위치
* 서버의 수동 개수
* socket 이 생성되는 위치
** 이 부분은 이후의 nginx 설정과도 연관되기 때문에 매우 중요하다.
* redmine 홈 디렉토리의 위치

이제 thin 을 daemon 형태로 openrc 에서 관리하기 위한 준비는 끝났다. 다음의 명령을 통해 thin 의 구동을 확인하자.

<syntaxhighlight lang="text">
/etc/init.d/thin start
</syntaxhighlight>

==thin 을 위한 nginx 의 설정==

당신의 Gentoo linux 시스템에 nginx 가 설치되어 있지 않다면, 일단 nginx 부터 설치한다.

<syntaxhighlight lang="text">
emerge nginx
</syntaxhighlight>

이 문서에서는 자세한 nginx 설정을 다루지는 않는다. 해당되는 부분은 인터넷을 통해 추가로 학습하기를 권한다.

여기서는 nginx 의 proxy 기능을 이용해서 thin 과의 연결을 생성한다. 이를 위햇 proxy 에 대한 내용을 담고있는 파일을 우선적으로 생성한다.

* /etc/nginx/sites/proxy.include

<syntaxhighlight lang="text">
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

proxy_connect_timeout 90;
proxy_send_timeout 90;
proxy_read_timeout 90;

proxy_buffer_size 4k;
proxy_buffers 4 32k;
proxy_busy_buffers_size 64k;
proxy_temp_file_write_size 64k;
</syntaxhighlight>

이제 thin 을 위한 thin cluster upstream 및 가상호트스를 세팅하도록 한다.

* /etc/nginx/01_redmine.conf

<syntaxhighlight lang="text">
upstream thin_cluster {
server unix:/tmp/thin.0.sock;
server unix:/tmp/thin.1.sock;
server unix:/tmp/thin.2.sock;
server unix:/tmp/thin.3.sock;
}

server {
listen 8080;
server_name 당신의redmine도메은;

include sites/proxy.include;
root /home/redmine;
proxy_redirect off;

location / {
try_files $uri/index.html $uri.html $uri @cluster;
}

location @cluster {
proxy_pass http://thin_cluster;
}

access_log /var/log/nginx/redmine-proxy-access;
error_log /var/log/nginx/redmine-proxy-error;

}
</syntaxhighlight>

생성한 conf 파일을 nginx.conf 에서 불러들이도록 한다.

정상적으로 thin 과 nginx, 그리고 mysql 이 실행되어 있다면 손쉽게 redmine 화면을 확인할 수 있다.

==참고==

이 문서는 redmine_git_hosting 을 redmine 과 사용하기 위해 어떤 세팅을 거쳐야 하는지는 다루지 않는다. 해당되는 부분은 인터넷을 통해 학습하기 바란다.

==tip==

* thin 서버 외에도 현재의 redmine 을 확인할 수 있는 다른 방법도 있다.

<syntaxhighlight lang="text">
bundle exec rails server webrick -e production
</syntaxhighlight>

* gem 에서 현재 설치된 패키지 외에, gem repository 에 등록된 모든 패키지를 확인할 수 있다.

<syntaxhighlight lang="text">
gem list haml --remote --all
</syntaxhighlight>

* gem 에서 특정 패키지가 여러 버전이 설치되어있거나 등의 상황에서 명령어를 통해 특정패키지만 설치/삭제 도 할 수 있다.

<syntaxhighlight lang="text">
gem install builder -v 3.3.3
gem uninstall builder -v 3.3.3
</syntaxhighlight>

==참고자료==

* thin with systemd
** https://github.com/macournoyer/thin/pull/184
* redmine download
** https://www.redmine.org/projects/redmine/wiki/Download
* thin into Gemfile
** https://github.com/macournoyer/thin/issues/115
* Redmine Bootstrap Kit Plugin
** https://github.com/jbox-web/redmine_bootstrap_kit/tree/devel
* Redmine Git Hosting Plugin
** http://redmine-git-hosting.io/how-to/install-redmine/
** https://github.com/jbox-web/redmine_git_hosting
* Redmine Install
** http://www.redmine.org/projects/redmine/wiki/redmineinstall
* Redmine - git repository 연결하기
** http://www.whatwant.com/450
* Redmine + Git Remote 연동
** https://jistol.github.io/its/2018/01/23/redmine-git/
* Redmine Plugin
** http://www.redmine.org/projects/redmine/wiki/Plugins
* Docker Redmine + Mysql 설치 및 Plugin 설치하기
** https://jistol.github.io/its/2018/01/25/redmine-mysql-in-docker/

Gentoo redmine git2 - Revision history

Onionmixer: Gentoo 에서 nginx + thin + redmine 3.4 + mysql + redmine_git_hosting 사용하기 문서 내용 추가