Kā instalēt Redmine operētājsistēmā CentOS 7

Redmine ir bezmaksas atvērtā koda tīmekļa projektu pārvaldības rīks. Tas ir rakstīts Ruby on Rails un atbalsta vairākus datu bāzes serverus datu bāzes glabāšanai. Tā ir ar funkcijām bagāta lietojumprogramma, kas atbalsta vairākus projektus, uz lomu balstītu ACL un problēmu izsekošanas sistēmu. Tam ir arī Ganta diagrammas un kalendāra atbalsts, failu pārvaldība katram projektam wiki un forumam, kā arī daudzas citas funkcijas. Tā atbalsta versiju kontroles sistēmas, piemēram, Git, SVN vai CVS. Tā ir arī daudzvalodu, kas atbalsta pat 49 valodas.

Šī rokasgrāmata tika rakstīta Redmine 3.4.4, taču tā var attiekties arī uz jaunākām versijām.

Priekšnoteikumi

• Vultr CentOS 7 servera gadījums.
• Sudo lietotāju .
• Domēna nosaukums norādīja uz serveri.

Šajā apmācībā mēs izmantosim 192.168.1.1kā publisko IP adresi un redmine.example.comkā domēna nosaukumu, kas norādīts uz Vultr instanci. Lūdzu, noteikti aizstājiet visus domēna nosaukuma un IP adreses piemēra gadījumus ar faktisko.

Atjauniniet savu bāzes sistēmu, izmantojot rokasgrāmatu Kā atjaunināt CentOS 7 . Kad sistēma ir atjaunināta, turpiniet instalēt atkarības.

Instalējiet Apache

Redmine ir rakstīts valodā Ruby on Rails, tāpēc, lai apkalpotu lietojumprogrammu, Phusion Passenger būs jāintegrējas ar Apache tīmekļa serveri. Instalējiet Apache.

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

Lai izveidotu lietojumprogrammu Redmine, mums būs nepieciešami arī daži izstrādes rīki. Uzstādiet nepieciešamos rīkus.

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

Instalējiet PostgreSQL

Redmine atbalsta vairāku veidu datu bāzes serverus, piemēram, MySQL, PostgreSQL un MSSQL. Šajā apmācībā mēs izmantosim PostgreSQL, lai mitinātu Redmine datu bāzes serveri.

PostgreSQL ir objektu relāciju datu bāzes sistēma. Noklusējuma yumrepozitorijā ir veca PostgreSQL versija, tāpēc pievienojiet sistēmai PostgreSQL repozitoriju.

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

Instalējiet PostgreSQL datu bāzes serveri.

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

Inicializējiet datu bāzi.

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

Palaidiet PostgreSQL serveri un iespējojiet tā automātisku palaišanu sāknēšanas laikā.

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

Mainiet noklusējuma PostgreSQL lietotāja paroli.

sudo passwd postgres

Piesakieties kā PostgreSQL lietotājs.

sudo su - postgres

Izveidojiet jaunu PostgreSQL lietotāju Redmine.

createuser redmine

Jums ir atļauts izmantot jebkuru lietotājvārdu, nevis redmine. PostgreSQL nodrošina psqlčaulu, lai palaistu vaicājumus datu bāzē. Pārslēdzieties uz PostgreSQL čaulu.

psql

Iestatiet paroli jaunizveidotajam Redmine datu bāzes lietotājam.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

Aizstāt DBPasswordar drošu paroli. Izveidojiet jaunu datu bāzi Redmine instalēšanai.

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

Iziet no psqlčaulas.

\q

Pārslēdzieties uz sudolietotāju.

exit

Rediģējiet pg_hba.conffailu, lai iespējotu MD5 balstītu autentifikāciju.

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

Atrast šādas līnijas un mainīt vērtības peerun identšajā METHODkolonnā trustun md5, attiecīgi.

# 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

Pēc atjaunināšanas konfigurācijai vajadzētu izskatīties šādi.

# 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

Restartējiet PostgreSQL, lai izmaiņas stātos spēkā.

sudo systemctl restart postgresql-10

Instalējiet vēl dažas nepieciešamās PostgreSQL atkarības.

sudo yum -y install libpqxx-devel protobuf-devel

Instalējiet Ruby

Lietojumprogrammas palaišanai ieteicams izmantot nepievilcīgu lietotāju, lai tā būtu izolēta no pārējās sistēmas. Izveidojiet jaunu lietotāju Redmine un pārslēdzieties uz jaunizveidoto lietotāju.

sudo adduser redmine
sudo su - redmine

Mēs instalēsim jaunāko Ruby versiju, izmantojot Ruby versijas pārvaldnieku vai RVM. To izmanto, lai instalētu un pārvaldītu vairākas Ruby versijas.

Pievienojiet savam serverim RVM GPG atslēgu.

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

Instalējiet RVM.

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

Iegūstiet pieejamo Ruby versiju sarakstu.

rvm list known

Jūs redzēsit garu Ruby versiju sarakstu.

[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

...

Instalējiet jaunāko Ruby versiju no saraksta.

rvm install 2.4

Izmantojiet instalēto Ruby versiju.

rvm use 2.4

Jūs varat pārbaudīt tā versiju.

ruby -v

Jūs redzēsit līdzīgu izvadi.

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

Instalējiet komplektētāju, kas ir lietojumprogrammas Ruby atkarības pārvaldnieks.

gem install bundler

Rubīns tagad ir instalēts. Pirms Redmine instalēšanas mums būs jāinstalē Phusion Passenger.

Instalējiet programmu Pasažieris

Palaidiet šo komandu, lai instalētu Passenger.

gem install passenger

Nodrošiniet izpildes atļauju redminelietotāja mājas direktorijai . Lai apkalpotu lietojumprogrammu, pasažierim ir jāizpilda binārie faili.

chmod o+x "/home/redmine"

Instalējiet Apache moduli pasažieriem.

passenger-install-apache2-module

Instalēšanas skripts jums uzdos dažus jautājumus. Pirmkārt, tas sniegs jums informāciju par instalēšanas procesu. Pēc tam tas lūgs jums izvēlēties valodu, kuru izmantosit. Tā kā mūsu lietojumprogramma ir rakstīta Ruby on Rails valodā, izvēlnē atlasiet Ruby un nospiediet " Enter", lai turpinātu.

Which languages are you interested in?

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

 ‣ ⬢  Ruby
   ⬡  Python
   ⬡  Node.js
   ⬡  Meteor

Instalētājs tagad pārbaudīs prasības. Instalēšanas programma nesaskaras ar trūkstošām atkarībām un automātiski turpinās moduļa kompilēšanu un instalēšanu.

Kad modulis ir instalēts, tas liks jums pievienot moduli Apache konfigurācijas failā.

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.

Pagaidām mēs to izlaidīsim un pabeigsim vēlāk apmācībā, jo lietotājam, ar kuru pašlaik esam pieteikušies, nav sudoatļauju. Nospiediet " Enter", lai izlaistu šo darbību.

Visbeidzot, instalēšanas skripts apstiprinās instalāciju, un jūs redzēsit brīdinājumu, ka Apache konfigurācijā nav norādīts Pasažieru modulis.

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.

Tagad, kad esam instalējuši Apache moduli Passenger, turpiniet lejupielādēt un instalēt Redmine.

Instalējiet Redmine

Lejupielādējiet jaunāko Redmine versiju no oficiālās Redmine lejupielādes lapas .

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

Ērtības labad izņemiet arhīvu un pārdēvējiet direktoriju.

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

Kopējiet piemēru konfigurācijas failus uz tā ražošanas vietu.

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

Atveriet tikko nokopēto datu bāzes konfigurācijas failu, lai ievadītu datu bāzes informāciju.

nano config/database.yml

Pēc noklusējuma datu bāzes fails ir konfigurēts MySQL. Atrodiet ražošanas un izstrādes konfigurācijas un pārbaudiet, kas izmanto MySQL adapteri. Komentējiet visas šīs rindas.

#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

Tālāk atrodiet komentētās rindas productionar postgresqladaptera konfigurāciju . Atceliet šīs rindas komentārus un atjauniniet datu bāzes nosaukumu un lietotāja akreditācijas datus. Noteikti izmantojiet pareizo atkāpi, kas ir divas atstarpes.

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

Konfigurējiet lietojumprogrammu, lai izmantotu PostgreSQL konfigurāciju.

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

Instalējiet lietojumprogrammai nepieciešamās lietojumprogrammu atkarības.

bundle install --without development test

Instalēšanas beigās redzēsit šādu ziņojumu.

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.

Šī komanda ģenerē slepenos marķierus, kas tiek izmantoti sesijas datu kodēšanai.

bundle exec rake generate_secret_token

Uzrakstiet PostgreSQL datu bāzi.

RAILS_ENV=production bundle exec rake db:migrate

Palaidiet šo komandu, kas ieraksta noklusējuma datus PostgreSQL datu bāzē.

RAILS_ENV=production bundle exec rake redmine:load_default_data

Iepriekš minētā komanda lūgs jums izvēlēties noklusējuma valodu, kas tiks izmantota lietojumprogrammā. Noklusējuma izvēle ir angļu valoda; izvēlieties atbilstoši savām vēlmēm.

[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 lietojumprogrammas instalēšana tagad ir pabeigta. Mainiet direktoriju un failu īpašumtiesības un atļaujas.

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

Mēs esam konfigurējuši visu, kas mums ir nepieciešams no nepriviliģēta lietotāja. Pārslēdzieties atpakaļ uz sudolietotāju, palaižot su - <username>.

Konfigurējiet Apache

Apache konfigurācijas failā pievienojiet Apache moduli Pasažieris. Tas automātiski ielādēs Pasažieru moduli.

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

Izveidojiet jaunu virtuālā resursdatora failu savai Redmine lietojumprogrammai.

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

Aizpildiet failu ar šādu saturu.

<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>

Noteikti nomainiet to redmine.example.comar savu faktisko domēna nosaukumu. Tāpat pārliecinieties, vai ceļš uz PassengerRootun PassengerRubyir pareizs. Ceļš uz binārajiem failiem var mainīties, kad būs jauns Ruby vai Passenger laidiens. Lai atrastu šos ceļus, palaidiet šo komandu.

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

Jūs saņemsiet šādu izvadi.

[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

Kad ir izveidots virtuālās saimniekdatora fails, restartējiet Apache tīmekļa serveri.

sudo systemctl restart httpd

Mainiet ugunsmūra konfigurāciju, lai atļautu portu 80caur ugunsmūri.

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

Tagad varat piekļūt savam Redmine interfeisam vietnē http://redmine.example.com. Piesakieties ar lietotājvārdu adminun paroli admin. Pirmajā pieteikšanās reizē Redmine liks jums atjaunināt paroli.

Apache aizsardzība, izmantojot Let's Encrypt SSL

Tā kā mūsu Redmine instalācija notiek uz publiskā servera, ieteicams izmantot SSL, lai nodrošinātu datu apmaiņu no servera.

Instalējiet Certbot, kas ir Let's Encrypt CA klienta lietojumprogramma.

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

Lai varētu pieprasīt sertifikātus, jums būs jāatļauj ports 80un/ 443vai standarta HTTPun HTTPSpakalpojumi, izmantojot ugunsmūri. Tā kā portu esam jau atļāvuši 80agrāk, tad atļausim portu 443.

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

Piezīme. Lai iegūtu sertifikātus no Let's Encrypt CA, domēnam, kuram ir jāģenerē sertifikāti, jābūt norādītam uz serveri. Ja nē, veiciet nepieciešamās izmaiņas domēna DNS ierakstos un pagaidiet, līdz DNS tiek izplatīts, pirms vēlreiz veicat sertifikāta pieprasījumu. Certbot pirms sertifikātu sniegšanas pārbauda domēna iestādi.

Ģenerējiet SSL sertifikātus.

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

Ģenerētie sertifikāti, visticamāk, tiks glabāti /etc/letsencrypt/live/redmine.example.com/. SSL sertifikāts tiks saglabāts kā cert.pemun privātā atslēga tiks saglabāta kā privkey.pem.

Encrypt sertifikātu derīguma termiņš beidzas 90 dienu laikā, tāpēc ir ieteicams iestatīt sertifikātu automātisko atjaunošanu, izmantojot Cron darbus.

Atveriet lietotāja Cron darba failu root.

sudo crontab -e

Faila beigās pievienojiet šādu rindu.

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

Iepriekš minētais Cron darbs darbosies katru dienu plkst. 5:30. Ja sertifikātam beidzas derīguma termiņš, tas tiks automātiski atjaunots.

Rediģējiet virtuālo resursdatora failu, ko iepriekš izveidojām Redmine.

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

Modificējiet virtuālā resursdatora failu, lai tas izskatītos šādi.

<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>

Saglabājiet failu un izejiet no redaktora.

Restartējiet Apache, lai izmaiņas stātos spēkā.

sudo systemctl restart httpd

Tagad varat piekļūt Redmine vairāk HTTPSpar https://redmine.example.com.

Apsveicam, jūs esat veiksmīgi instalējis Redmine savā CentOS 7 instancē. Sāciet izstrādāt savu projektu, izveidojot vai importējot projektu.