CentOS 7에 Redmine을 설치하는 방법

• 전제 조건
• 아파치 설치
• PostgreSQL 설치
• 루비 설치
• 승객 설치
• Redmine 설치
• 아파치 설정
• SSL을 암호화하여 Apache 보안

Redmine은 무료이며 오픈 소스 인 웹 기반 프로젝트 관리 도구입니다. Ruby on Rails로 작성되었으며 데이터베이스 저장을 위해 여러 데이터베이스 서버를 지원합니다. 여러 프로젝트, 역할 기반 ACL 및 문제 추적 시스템을 지원하는 풍부한 기능의 응용 프로그램입니다. 또한 Gantt 차트 및 캘린더 지원, 파일 관리, 프로젝트 위키 및 포럼, 기타 여러 기능이 있습니다. Git, SVN 또는 CVS와 같은 버전 제어 시스템을 지원합니다. 또한 49 개 언어를 지원하는 다국어입니다.

이 안내서는 Redmine 3.4.4 용으로 작성되었지만 최신 버전에도 적용될 수 있습니다.

전제 조건

• Vultr CentOS 7 서버 인스턴스
• sudo는 사용자 .
• 서버를 가리키는 도메인 이름

이 자습서에서는 192.168.1.1퍼블릭 IP 주소와 redmine.example.comVultr 인스턴스를 가리키는 도메인 이름으로 사용합니다. 예제 도메인 이름 및 IP 주소의 모든 항목을 실제 이름으로 바꾸십시오.

CentOS 7 업데이트 방법 안내서를 사용하여 기본 시스템을 업데이트하십시오 . 시스템이 업데이트되면 종속성 설치를 진행하십시오.

아파치 설치

Redmine은 Ruby on Rails로 작성되었으므로 애플리케이션을 제공하기 위해 Phusion Passenger이 Apache 웹 서버와 통합되어야합니다. Apache를 설치하십시오.

sudo yum -y install httpd httpd-devel libcurl-devel

Redmine 응용 프로그램을 빌드하려면 몇 가지 개발 도구가 필요합니다. 필요한 도구를 설치하십시오.

sudo yum -y install ImageMagick ImageMagick-devel git libxml2-devel libxslt-devel gcc bzip2 openssl-devel zlib-devel gdbm-devel ncurses-devel autoconf automake bison gcc-c++ libffi-devel libtool patch readline-devel sqlite-devel glibc-headers glibc-devel libyaml-devel libicu-devel libidn-devel

PostgreSQL 설치

Redmine은 MySQL, PostgreSQL 및 MSSQL과 같은 여러 유형의 데이터베이스 서버를 지원합니다. 이 튜토리얼에서는 PostgreSQL을 사용하여 Redmine 데이터베이스 서버를 호스팅합니다.

PostgreSQL은 객체 관계형 데이터베이스 시스템입니다. 기본 yum리포지토리에는 이전 버전의 PostgreSQL이 포함되어 있으므로 PostgreSQL 리포지토리를 시스템에 추가하십시오.

sudo yum -y install https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-7-x86_64/pgdg-centos10-10-1.noarch.rpm

PostgreSQL 데이터베이스 서버를 설치하십시오.

sudo yum -y install postgresql10-server postgresql10-contrib postgresql10 

데이터베이스를 초기화하십시오.

sudo /usr/pgsql-10/bin/postgresql-10-setup initdb

PostgreSQL 서버를 시작하고 부팅시 자동으로 시작되도록합니다.

sudo systemctl start postgresql-10
sudo systemctl enable postgresql-10

기본 PostgreSQL 사용자의 비밀번호를 변경하십시오.

sudo passwd postgres

PostgreSQL 사용자로 로그인하십시오.

sudo su - postgres

Redmine에 대한 새 PostgreSQL 사용자를 작성하십시오.

createuser redmine

대신 사용자 이름을 사용할 수 있습니다 redmine. PostgreSQL은 psql데이터베이스에서 쿼리를 실행하기 위한 셸을 제공 합니다. PostgreSQL 셸로 전환하십시오.

psql

Redmine 데이터베이스에 대해 새로 작성된 사용자의 비밀번호를 설정하십시오.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

DBPassword안전한 비밀번호로 교체하십시오 . Redmine 설치를위한 새 데이터베이스를 작성하십시오.

CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

psql쉘 에서 나갑니다.

\q

sudo사용자로 전환하십시오 .

exit

pg_hba.confMD5 기반 인증을 사용 하도록 파일을 편집하십시오 .

sudo nano /var/lib/pgsql/10/data/pg_hba.conf

다음 줄을 찾아 값을 변경 peer하고 ident에 METHOD에 열을 trust하고 md5각각.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    all             all             ::1/128                 ident

업데이트되면 구성은 다음과 같아야합니다.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5

변경 사항을 적용하려면 PostgreSQL을 다시 시작하십시오.

sudo systemctl restart postgresql-10

필요한 몇 가지 PostgreSQL 종속성을 설치하십시오.

sudo yum -y install libpqxx-devel protobuf-devel

루비 설치

권한이없는 사용자를 사용하여 응용 프로그램을 실행하여 다른 시스템과 격리되도록하는 것이 좋습니다. Redmine의 새 사용자를 작성하고 새로 작성된 사용자로 전환하십시오.

sudo adduser redmine
sudo su - redmine

Ruby 버전 관리자 또는 RVM을 사용하여 최신 버전의 Ruby를 설치합니다. 여러 버전의 Ruby를 설치하고 관리하는 데 사용됩니다.

RVM의 GPG 키를 서버에 추가하십시오.

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

RVM을 설치하십시오.

curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

사용 가능한 Ruby 버전 목록을 가져옵니다.

rvm list known

Ruby 버전의 긴 목록이 표시됩니다.

[redmine@vultr ~]$ rvm list known
# MRI Rubies

[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.7]
[ruby-]2.3[.4]
[ruby-]2.4[.1]
ruby-head

...

목록에서 최신 버전의 Ruby를 설치하십시오.

rvm install 2.4

설치된 Ruby 버전을 사용하십시오.

rvm use 2.4

버전을 확인할 수 있습니다.

ruby -v

비슷한 결과가 나타납니다.

[redmine@vultr ~]$ ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]

Ruby 애플리케이션의 종속성 관리자 인 번 들러를 설치하십시오.

gem install bundler

이제 루비가 설치되었습니다. Redmine을 설치하기 전에 Phusion Passenger을 설치해야합니다.

승객 설치

승객을 설치하려면 다음 명령을 실행하십시오.

gem install passenger

redmine사용자 의 홈 디렉토리에 실행 권한을 제공하십시오 . 승객은 응용 프로그램을 제공하기 위해 바이너리를 실행해야합니다.

chmod o+x "/home/redmine"

승객 용 Apache 모듈을 설치하십시오.

passenger-install-apache2-module

설치 관리자 스크립트가 몇 가지 질문을합니다. 먼저 설치 프로세스에 대한 정보를 제공합니다. 그런 다음 사용할 언어를 선택하라는 메시지가 표시됩니다. 애플리케이션이 Ruby on Rails로 작성되었으므로 메뉴에서 Ruby를 선택하고 " Enter"를 눌러 계속 진행하십시오.

Which languages are you interested in?

Use <space> to select.
If the menu doesn't display correctly, press '!'

 ‣ ⬢  Ruby
   ⬡  Python
   ⬡  Node.js
   ⬡  Meteor

설치 관리자가 이제 요구 사항을 확인합니다. 설치 프로그램은 종속성이 누락되지 않고 모듈 컴파일 및 설치를 자동으로 진행합니다.

모듈이 설치되면 Apache 구성 파일에 모듈을 추가하라는 메시지가 표시됩니다.

Almost there!

Please edit your Apache configuration file, and add these lines:

   LoadModule passenger_module /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so
   <IfModule mod_passenger.c>
     PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
     PassengerDefaultRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
   </IfModule>

After you restart Apache, you are ready to deploy any number of web
applications on Apache, with a minimum amount of configuration!

Press ENTER when you are done editing.

지금은이 단계를 건너 뛰고 나중에 로그인 한 사용자에게 sudo권한 이 없으므로 학습서에서 나중에 완료합니다 . Enter이 단계를 건너 뛰려면 " "를 누르십시오 .

마지막으로 설치 관리자 스크립트가 설치를 확인하고 승객 구성이 Apache 구성에 지정되어 있지 않다는 경고를 보게됩니다.

Validating installation...

 * Checking whether this Passenger install is in PATH... ✓
 * Checking whether there are no other Passenger installations... ✓
 * Checking whether Apache is installed... ✓
 * Checking whether the Passenger module is correctly configured in Apache... (!)

   You did not specify 'LoadModule passenger_module' in any of your Apache
   configuration files. Please paste the configuration snippet that this
   installer printed earlier, into one of your Apache configuration files, such
   as /etc/httpd/conf/httpd.conf.


Detected 0 error(s), 1 warning(s).
Press ENTER to continue.

Apache 용 승객 모듈을 설치 했으므로 Redmine을 다운로드하여 설치하십시오.

Redmine 설치

공식 Redmine 다운로드 페이지 에서 최신 버전의 Redmine을 다운로드하십시오 .

cd ~
wget http://www.redmine.org/releases/redmine-3.4.4.tar.gz

편의를 위해 아카이브를 추출하고 디렉토리 이름을 바꾸십시오.

tar -xf redmine-*.tar.gz
mv redmine-*/ redmine/

예제 구성 파일을 프로덕션 위치에 복사하십시오.

cd redmine
cp config/configuration.yml.example config/configuration.yml
cp config/database.yml.example config/database.yml

방금 복사 한 데이터베이스 구성 파일을 열어 데이터베이스 세부 사항을 입력하십시오.

nano config/database.yml

기본적으로 데이터베이스 파일은 MySQL 용으로 구성되어 있습니다. 프로덕션 및 개발을위한 구성을 찾고 MySQL 어댑터를 사용하는 테스트하십시오. 이 줄을 모두 주석 처리하십시오.

#production:
#  adapter: mysql2
#  database: redmine
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

#development:
#  adapter: mysql2
#  database: redmine_development
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

#test:
#  adapter: mysql2
#  database: redmine_test
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

Furthur, 어댑터 production구성 이있는 주석 처리 된 행을 찾으십시오 postgresql. 해당 행의 주석을 해제하고 데이터베이스 이름 및 사용자 신임 정보를 업데이트하십시오. 올바른 들여 쓰기 (공백 두 개)를 사용해야합니다.

production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: "DBPassword"

PostgreSQL 구성을 사용하도록 애플리케이션을 구성하십시오.

bundle config build.pg --with-pg-config=/usr/pgsql-10/bin/pg_config

응용 프로그램에 필요한 응용 프로그램 종속성을 설치하십시오.

bundle install --without development test

설치가 끝나면 다음 메시지가 표시됩니다.

Installing roadie-rails 1.1.1
Bundle complete! 31 Gemfile dependencies, 55 gems now installed.
Gems in the groups development and test were not installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.

다음 명령은 세션 데이터를 인코딩하는 데 사용되는 비밀 토큰을 생성합니다.

bundle exec rake generate_secret_token

PostgreSQL 데이터베이스를 작성하십시오.

RAILS_ENV=production bundle exec rake db:migrate

PostgreSQL 데이터베이스에 기본 데이터를 쓰는 다음 명령을 실행하십시오.

RAILS_ENV=production bundle exec rake redmine:load_default_data

위의 명령은 응용 프로그램에 사용할 기본 언어를 선택하도록 요청합니다. 기본 선택은 영어입니다. 취향에 따라 선택하십시오.

[redmine@vultr redmine]$ RAILS_ENV=production bundle exec rake redmine:load_default_data

Select language: ar, az, bg, bs, ca, cs, da, de, el, en, en-GB, es, es-PA, et, eu, fa, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mk, mn, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sq, sr, sr-YU, sv, th, tr, uk, vi, zh, zh-TW [en]
====================================
Default configuration data loaded.

Redmine 애플리케이션 설치가 완료되었습니다. 디렉토리 및 파일의 소유권 및 권한을 변경하십시오.

mkdir -p tmp tmp/pdf public/plugin_assets
chown -R redmine:redmine files log tmp public/plugin_assets
chmod -R 755 files log tmp public/plugin_assets

권한이없는 사용자로부터 필요한 모든 것을 구성했습니다. sudo을 실행 하여 사용자로 다시 전환하십시오 su - <username>.

아파치 설정

Apache 승객 모듈을 Apache 구성 파일에 추가하십시오. 승객 모듈이 자동으로로드됩니다.

echo "LoadModule passenger_module /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so" | sudo tee -a /etc/httpd/conf.modules.d/00-base.conf

Redmine 애플리케이션을위한 새 가상 호스트 파일을 작성하십시오.

sudo nano /etc/httpd/conf.d/redmine.conf

다음 내용으로 파일을 채우십시오.

<VirtualHost *:80>
    ServerName redmine.example.com

    DocumentRoot /home/redmine/redmine/public

    PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
    PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
    PassengerUser redmine

    <Directory /home/redmine/redmine/public>
      Allow from all
      Options -MultiViews
      Require all granted
    </Directory>
</VirtualHost>

redmine.example.com실제 도메인 이름 으로 바꾸십시오 . 또한 PassengerRoot및 경로 PassengerRuby가 올바른지 확인하십시오. Ruby 또는 Passenger의 새로운 릴리스가있을 때 바이너리 경로가 변경 될 수 있습니다. 이러한 경로를 찾으려면 다음 명령을 실행하십시오.

sudo su redmine -c "passenger-config about ruby-command"

다음과 같은 결과가 나옵니다.

[user@vultr ~]$ sudo su redmine -c "passenger-config about ruby-command"
passenger-config was invoked through the following Ruby interpreter:
  Command: /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  Version: ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]
  To use in Apache: PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  To use in Nginx : passenger_ruby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  To use with Standalone: /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/bin/passenger start

가상 호스트 파일이 작성되면 Apache 웹 서버를 다시 시작하십시오.

sudo systemctl restart httpd

방화벽을 통한 포트를 허용하도록 방화벽 구성을 수정하십시오 80.

sudo firewall-cmd --zone=public --add-service=http --permanent
sudo firewall-cmd --reload

이제에서 Redmine 인터페이스에 액세스 할 수 있습니다 http://redmine.example.com. username admin과 password로 로그인하십시오 admin. 처음 로그인하면 Redmine은 암호를 업데이트하라는 메시지를 표시합니다.

SSL을 암호화하여 Apache 보안

Redmine 설치는 공개 서버에 있으므로 SSL을 사용하여 서버에서 데이터 교환을 보호하는 것이 좋습니다.

Let 's Encrypt CA의 클라이언트 응용 프로그램 인 Certbot을 설치하십시오.

sudo yum -y install epel-release
sudo yum -y install certbot mod_ssl

인증서를 요청하기 전에 방화벽을 통한 포트 80및 443/ 또는 표준 HTTP및 HTTPS서비스 를 허용해야합니다 . 80이전에 포트를 이미 허용 했으므로 port를 허용 합시다 443.

sudo firewall-cmd --zone=public --add-service=https --permanent
sudo firewall-cmd --reload

참고 : Let 's Encrypt CA에서 인증서를 얻으려면 인증서가 생성 될 도메인이 서버를 가리켜 야합니다. 그렇지 않은 경우 도메인의 DNS 레코드를 필요한대로 변경하고 인증서가 다시 요청되기 전에 DNS가 전파 될 때까지 기다리십시오. Certbot은 인증서를 제공하기 전에 도메인 권한을 확인합니다.

SSL 인증서를 생성하십시오.

sudo certbot certonly --webroot -w /home/redmine/redmine/public -d redmine.example.com

생성 된 인증서는에 저장 될 수 있습니다 /etc/letsencrypt/live/redmine.example.com/. SSL 인증서는로 저장 cert.pem되고 개인 키는로 저장됩니다 privkey.pem.

인증서 암호화는 90 일 후에 만료되므로 Cron 작업을 사용하여 인증서의 자동 갱신을 설정하는 것이 좋습니다.

root사용자 의 Cron 작업 파일을여십시오 .

sudo crontab -e

파일 끝에 다음 줄을 추가하십시오.

30 5 * * * /usr/bin/certbot renew --quiet

위의 Cron 작업은 매일 오전 5:30에 실행됩니다. 인증서가 만료 예정인 경우 자동으로 갱신됩니다.

Redmine을 위해 이전에 작성한 가상 호스트 파일을 편집하십시오.

sudo nano /etc/httpd/conf.d/redmine.conf

가상 호스트 파일을 다음과 같이 수정하십시오.

<VirtualHost *:80>
    Redirect permanent / https://www.example.com/
    ServerName redmine.example.com
</VirtualHost>

<VirtualHost *:443>
    ServerAdmin [email protected]
    ServerName redmine.example.com
    DocumentRoot "/home/redmine/redmine/public"
    <Directory "/home/redmine/redmine/public">
        Options None
        Require all granted
    </Directory>
    PassengerAppEnv production
    PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
    PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
    PassengerUser redmine
    PassengerHighPerformance on

    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/redmine.example.com/cert.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/redmine.example.com/privkey.pem
    SSLCertificateChainFile /etc/letsencrypt/live/redmine.example.com/chain.pem

    SSLProtocol             all -SSLv2 -SSLv3
    SSLHonorCipherOrder     on
    SSLCipherSuite          ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS

    <IfModule headers_module>
        Header always edit Set-Cookie ^(.*)$ $1;HttpOnly;Secure
        Header always set Strict-Transport-Security "max-age=15768000; includeSubDomains"
    </IfModule>
</VirtualHost>

파일을 저장하고 편집기를 종료하십시오.

변경 사항을 적용하려면 Apache를 다시 시작하십시오.

sudo systemctl restart httpd

에서 HTTPS에 Redmine에 액세스 할 수 있습니다 https://redmine.example.com.

축하합니다. CentOS 7 인스턴스에 Redmine을 성공적으로 설치했습니다. 프로젝트를 만들거나 가져 와서 프로젝트 개발을 시작하십시오.