Kako namestiti Redmine na CentOS 7

Redmine je brezplačno in odprtokodno spletno orodje za upravljanje projektov. Napisana je v Ruby on Rails in podpira več strežnikov baz podatkov za shranjevanje baze podatkov. To je aplikacija, bogata s funkcijami, ki podpira več projektov, ACL na podlagi vlog in sistem za sledenje težavam. Ima tudi podporo za Ganttov grafikon in koledar, upravljanje datotek, wiki in forum po projektu ter številne druge funkcije. Podpira sisteme za nadzor različic, kot so Git, SVN ali CVS. Prav tako je večjezičen, podpira kar 49 jezikov.

Ta priročnik je bil napisan za Redmine 3.4.4, vendar lahko velja tudi za novejše različice.

Predpogoji

• Primerek strežnika Vultr CentOS 7.
• Uporabnik sudo .
• Ime domene, usmerjeno proti strežniku.

Za to vadnico bomo uporabili 192.168.1.1kot javni naslov IP in redmine.example.comkot ime domene, usmerjeno proti primerku Vultr. Poskrbite, da boste zamenjali vse pojavitve vzorčnega imena domene in naslova IP z dejanskim.

Posodobite svoj osnovni sistem z uporabo priročnika Kako posodobiti CentOS 7 . Ko je vaš sistem posodobljen, nadaljujte z namestitvijo odvisnosti.

Namestite Apache

Redmine je napisan v Ruby on Rails, zato bomo zahtevali, da se Phusion Passenger integrira s spletnim strežnikom Apache, da bo služil aplikaciji. Namestite Apache.

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

Za izdelavo aplikacije Redmine bomo potrebovali tudi nekaj razvojnih orodij. Namestite potrebna orodja.

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

Namestite PostgreSQL

Redmine podpira več vrst strežnikov baz podatkov, kot so MySQL, PostgreSQL in MSSQL. V tej vadnici bomo uporabili PostgreSQL za gostovanje strežnika baze podatkov Redmine.

PostgreSQL je objektno-relacijski sistem baz podatkov. Privzeto yumskladišče vsebuje staro različico PostgreSQL, zato dodajte repozitorij PostgreSQL v sistem.

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

Namestite strežnik baze podatkov PostgreSQL.

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

Inicializirajte bazo podatkov.

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

Zaženite strežnik PostgreSQL in omogočite, da se samodejno zažene ob zagonu.

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

Spremenite geslo za privzetega uporabnika PostgreSQL.

sudo passwd postgres

Prijavite se kot uporabnik PostgreSQL.

sudo su - postgres

Ustvarite novega uporabnika PostgreSQL za Redmine.

createuser redmine

Namesto . Lahko uporabite katero koli uporabniško ime redmine. PostgreSQL ponuja psqllupino za izvajanje poizvedb v bazi podatkov. Preklopite na lupino PostgreSQL.

psql

Nastavite geslo za novoustvarjenega uporabnika za bazo podatkov Redmine.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

Zamenjajte DBPasswordz varnim geslom. Ustvarite novo bazo podatkov za namestitev Redmine.

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

Izstopite iz psqllupine.

\q

Preklopite na sudouporabnika.

exit

Uredite pg_hba.confdatoteko, da omogočite preverjanje pristnosti na podlagi MD5.

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

Poiščite naslednje vrstice in spremenite vrednosti peerin identv METHODstolpcu v trustin 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

Ko je konfiguracija posodobljena, bi morala izgledati takole.

# 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

Znova zaženite PostgreSQL, da bodo spremembe začele veljati.

sudo systemctl restart postgresql-10

Namestite še nekaj potrebnih odvisnosti PostgreSQL.

sudo yum -y install libpqxx-devel protobuf-devel

Namesti Ruby

Priporočljivo je, da za zagon aplikacije uporabite neprivilegiranega uporabnika, da ostane izolirana od preostalega sistema. Ustvarite novega uporabnika za Redmine in preklopite na novo ustvarjenega uporabnika.

sudo adduser redmine
sudo su - redmine

Najnovejšo različico Rubyja bomo namestili s pomočjo Ruby Version Manager ali RVM. Uporablja se za namestitev in upravljanje več različic Rubyja.

Dodajte ključ GPG RVM na svoj strežnik.

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

Namestite RVM.

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

Pridobite seznam razpoložljivih različic Rubyja.

rvm list known

Videli boste dolg seznam različic Rubyja.

[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

...

Namestite najnovejšo različico Rubyja s seznama.

rvm install 2.4

Uporabite nameščeno različico Rubyja.

rvm use 2.4

Lahko preverite njegovo različico.

ruby -v

Videli boste podoben izhod.

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

Namestite bundler, ki je upravitelj odvisnosti za aplikacijo Ruby.

gem install bundler

Ruby je zdaj nameščen. Preden namestimo Redmine, bomo morali namestiti Phusion Passenger.

Namestite Passenger

Zaženite naslednji ukaz, da namestite Passenger.

gem install passenger

Zagotovite dovoljenje za izvajanje domačemu imeniku redmineuporabnika. Potnik mora izvesti binarne datoteke, da lahko služi aplikaciji.

chmod o+x "/home/redmine"

Namestite modul Apache za Passenger.

passenger-install-apache2-module

Skript namestitvenega programa vam bo postavil nekaj vprašanj. Najprej vam bo zagotovil informacije o postopku namestitve. Nato vas bo pozval, da izberete jezik, ki ga boste uporabljali. Ker je naša aplikacija napisana v Ruby on Rails, v meniju izberite Ruby in pritisnite " Enter" za nadaljevanje.

Which languages are you interested in?

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

 ‣ ⬢  Ruby
   ⬡  Python
   ⬡  Node.js
   ⬡  Meteor

Namestitveni program bo zdaj preveril zahteve. Namestitveni program ne bo naletel na manjkajoče odvisnosti in bo samodejno nadaljeval s prevajanjem in namestitvijo modula.

Ko je modul nameščen, vas bo pozval, da dodate modul v konfiguracijsko datoteko 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.

To bomo zaenkrat preskočili in dokončali pozneje v vadnici, saj uporabnik, s katerim smo trenutno prijavljeni, nima sudodovoljenj. Pritisnite " Enter", da preskočite ta korak.

Finally, the installer script will validate the installation and you will see a warning saying the Passenger module is not specified in Apache configuration.

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.

Now that we have installed the Passenger module for Apache, proceed to download and install Redmine.

Install Redmine

Download the latest version of Redmine from the official Redmine download page.

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

Extract the archive and rename the directory for sake of convenience.

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

Copy the example configuration files to its production location.

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

Open the database configuration file we just copied to enter the database details.

nano config/database.yml

By default, the database file is configured for MySQL. Find the configurations for production and development, and test which uses the MySQL adapter. Comment out all of these lines.

#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

Nadalje poiščite vrstice, ki so komentirane in imajo productionkonfiguracijo za postgresqladapter. Odkomentirajte te vrstice in posodobite ime baze podatkov in uporabniške poverilnice. Prepričajte se, da uporabljate pravilno zamik, ki je dva presledka.

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

Konfigurirajte aplikacijo za uporabo konfiguracije PostgreSQL.

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

Namestite odvisnosti aplikacije, ki jih zahteva aplikacija.

bundle install --without development test

Na koncu namestitve boste videli naslednje sporočilo.

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.

Naslednji ukaz ustvari tajne žetone, ki se uporabljajo za kodiranje podatkov seje.

bundle exec rake generate_secret_token

Napišite bazo podatkov PostgreSQL.

RAILS_ENV=production bundle exec rake db:migrate

Zaženite naslednji ukaz, ki zapiše privzete podatke v bazo podatkov PostgreSQL.

RAILS_ENV=production bundle exec rake redmine:load_default_data

Zgornji ukaz vas bo pozval, da izberete privzeti jezik, ki bo uporabljen z aplikacijo. Privzeta izbira je angleščina; izberite po svojih željah.

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

Namestitev aplikacije Redmine je zdaj končana. Spremenite lastništvo in dovoljenja imenikov in datotek.

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

Konfigurirali smo vse, kar potrebujemo od neprivilegiranega uporabnika. Preklopite nazaj na sudouporabnika tako, da zaženete su - <username>.

Konfigurirajte Apache

Dodajte modul Passenger za Apache v konfiguracijsko datoteko Apache. To bo samodejno naložilo modul za potnike.

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

Ustvarite novo datoteko navideznega gostitelja za vašo aplikacijo Redmine.

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

Napolnite datoteko z naslednjo vsebino.

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

Ne pozabite zamenjati redmine.example.coms svojim dejanskim imenom domene. Prav tako se prepričajte, da sta pot do PassengerRootin PassengerRubypravilna. Pot do binarnih datotek se lahko spremeni, ko bo na voljo nova izdaja Ruby ali Passenger. Če želite poiskati te poti, zaženite naslednji ukaz.

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

Dobili boste naslednji rezultat.

[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

Ko je datoteka virtualnega gostitelja ustvarjena, znova zaženite spletni strežnik Apache.

sudo systemctl restart httpd

Spremenite konfiguracijo požarnega zidu, da omogočite vrata 80skozi požarni zid.

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

Zdaj lahko dostopate do svojega vmesnika Redmine na http://redmine.example.com. Prijavite se z uporabniškim imenom adminin geslom admin. Ob vaši prvi prijavi vas bo Redmine pozval, da posodobite geslo.

Zaščita Apache z Let's Encrypt SSL

Ker je naša namestitev Redmine na javnem strežniku, je priporočljivo uporabiti SSL za zaščito izmenjave podatkov s strežnika.

Namestite Certbot, ki je odjemalska aplikacija za Let's Encrypt CA.

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

Preden lahko zahtevate potrdila, boste morali prek požarnega zidu dovoliti vrata 80in/ 443ali standard HTTPter HTTPSstoritve. Ker smo vrata že dovolili 80prej, dovolimo port 443.

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

Opomba: Če želite pridobiti potrdila od Let's Encrypt CA, mora biti domena, za katero naj bi bila generirana potrdila, usmerjena proti strežniku. Če ne, naredite potrebne spremembe v zapisih DNS domene in počakajte, da se DNS razširi, preden znova pošljete zahtevo za potrdilo. Certbot preveri avtoriteto domene, preden zagotovi potrdila.

Ustvarite SSL potrdila.

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

Ustvarjena potrdila bodo verjetno shranjena v /etc/letsencrypt/live/redmine.example.com/. Potrdilo SSL bo shranjeno kot cert.pemin zasebni ključ bo shranjen kot privkey.pem.

Potrdila Let's Encrypt potečejo v 90 dneh, zato je priporočljivo, da nastavite samodejno obnavljanje potrdil s pomočjo opravil Cron.

Odprite datoteko opravila Cron za rootuporabnika.

sudo crontab -e

Dodajte naslednjo vrstico na konec datoteke.

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

Zgornje opravilo Cron se bo izvajalo vsak dan ob 5.30. Če potrdilo poteče, se samodejno podaljša.

Uredite datoteko navideznega gostitelja, ki smo jo prej ustvarili za Redmine.

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

Spremenite datoteko navideznega gostitelja, da bo videti takole.

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

Shranite datoteko in zapustite urejevalnik.

Znova zaženite Apache, da bodo spremembe začele veljati.

sudo systemctl restart httpd

Zdaj lahko dostopate do Redmine več HTTPSna https://redmine.example.com.

Čestitamo, uspešno ste namestili Redmine na svoj primerek CentOS 7. Začnite razvijati svoj projekt tako, da ustvarite ali uvozite svoj projekt.