Redmine installimine CentOS 7-sse

Redmine on tasuta avatud lähtekoodiga veebipõhine projektihaldustööriist. See on kirjutatud Ruby on Railsis ja toetab andmebaasi salvestamiseks mitut andmebaasiserverit. See on funktsioonirikas rakendus, mis toetab mitut projekti, rollipõhist ACL-i ja probleemide jälgimissüsteemi. Sellel on ka Gantti diagrammi ja kalendri tugi, failihaldus projekti viki ja foorumi kohta ning palju muid funktsioone. See toetab versioonihaldussüsteeme nagu Git, SVN või CVS. See on ka mitmekeelne, toetades kuni 49 keelt.

See juhend on kirjutatud Redmine 3.4.4 jaoks, kuid see võib kehtida ka uuemate versioonide kohta.

Eeltingimused

• Vultr CentOS 7 serveri eksemplar.
• Sudo kasutaja .
• Domeeninimi osutas serverile.

Selle õpetuse jaoks kasutame me 192.168.1.1avaliku IP-aadressina ja redmine.example.comdomeeninimena, mis on suunatud Vultri eksemplarile. Asendage kindlasti kõik näidisdomeeninime ja IP-aadressi esinemised tegeliku nimega.

Värskendage oma baassüsteemi, kasutades juhendit CentOS 7 värskendamine . Kui teie süsteem on värskendatud, jätkake sõltuvuste installimisega.

Installige Apache

Redmine on kirjutatud keeles Ruby on Rails, seega nõuame, et Phusion Passenger integreeruks rakenduse teenindamiseks Apache veebiserveriga. Installige Apache.

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

Redmine rakenduse loomiseks vajame ka mõningaid arendustööriistu. Paigaldage vajalikud tööriistad.

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

Installige PostgreSQL

Redmine toetab mitut tüüpi andmebaasiservereid, nagu MySQL, PostgreSQL ja MSSQL. Selles õpetuses kasutame Redmine andmebaasiserveri hostimiseks PostgreSQL-i.

PostgreSQL on objektide suhteline andmebaasisüsteem. Vaikimisi yumhoidla sisaldab PostgreSQL-i vana versiooni, seega lisage PostgreSQL-i hoidla süsteemi.

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

Installige PostgreSQL andmebaasiserver.

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

Initsialiseerige andmebaas.

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

Käivitage PostgreSQL-server ja lubage see alglaadimisel automaatselt käivituda.

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

Muutke PostgreSQL-i vaikekasutaja parooli.

sudo passwd postgres

Logige sisse PostgreSQL-i kasutajana.

sudo su - postgres

Looge Redmine jaoks uus PostgreSQL-i kasutaja.

createuser redmine

Kasutajanime asemel võite kasutada mis tahes kasutajanime redmine. PostgreSQL pakub psqlandmebaasis päringute käitamiseks kesta. Lülituge PostgreSQL-i kestale.

psql

Määrake Redmine andmebaasi vastloodud kasutajale parool.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

Asendage DBPasswordturvalise parooliga. Looge Redmine installimiseks uus andmebaas.

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

Väljuge psqlkestast.

\q

Lülituge sudokasutajale.

exit

Redigeerige pg_hba.conffaili, et lubada MD5-põhine autentimine.

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

Leia järgmised read ja muuda väärtusi peerja identon METHODveeru trustja md5vastavalt.

# 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ärast värskendamist peaks konfiguratsioon välja nägema selline.

# 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

Taaskäivitage PostgreSQL, et muudatused jõustuksid.

sudo systemctl restart postgresql-10

Installige veel mõned vajalikud PostgreSQL-i sõltuvused.

sudo yum -y install libpqxx-devel protobuf-devel

Installige Ruby

Soovitatav on kasutada rakenduse käivitamiseks privilegeerimata kasutajat, et hoida seda ülejäänud süsteemist eraldatuna. Looge Redmine jaoks uus kasutaja ja lülituge vastloodud kasutajale.

sudo adduser redmine
sudo su - redmine

Installime Ruby uusima versiooni Ruby Version Manageri ehk RVM-i abil. Seda kasutatakse mitme Ruby versiooni installimiseks ja haldamiseks.

Lisage oma serverisse RVM-i GPG-võti.

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

Installige RVM.

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

Hankige Ruby saadaolevate versioonide loend.

rvm list known

Näete pikka Ruby versioonide loendit.

[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

...

Installige loendist Ruby uusim versioon.

rvm install 2.4

Kasutage Ruby installitud versiooni.

rvm use 2.4

Saate selle versiooni kontrollida.

ruby -v

Näete sarnast väljundit.

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

Installige bundler, mis on Ruby rakenduse sõltuvushaldur.

gem install bundler

Ruby on nüüd installitud. Enne Redmine'i installimist peame installima Phusion Passengeri.

Installige Reisija

Käivitage Passengeri installimiseks järgmine käsk.

gem install passenger

Andke redminekasutaja kodukataloogile täitmisluba . Reisija peab rakenduse teenindamiseks käivitama binaarfailid.

chmod o+x "/home/redmine"

Installige Apache moodul reisija jaoks.

passenger-install-apache2-module

The installer script will ask you some questions. First, it will provide you information about the installation process. Then it will ask you to select the language which you will be using. Since our application is written in Ruby on Rails, select Ruby from the menu and press "Enter" to proceed further.

Which languages are you interested in?

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

 ‣ ⬢  Ruby
   ⬡  Python
   ⬡  Node.js
   ⬡  Meteor

The installer will now check for requirements. The installer will not encounter any missing dependencies and will automatically proceed to compile and install the module.

Once the module is installed, it will prompt you to add the module into the Apache configuration file.

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.

We will skip this for now and will complete it later in the tutorial as the user with which we are logged in now does not have sudo permissions. Press "Enter" to skip this step.

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

Furthur, find the lines which are commented, having production configuration for the postgresql adapter. Uncomment those lines and update the database name and user credentials. Make sure to use the correct indentation, which is two spaces.

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

Configure the application to use the PostgreSQL configuration.

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

Install the application dependencies required by the application.

bundle install --without development test

You will see the following message at the end of the installation.

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.

The following command generates secret tokens that are used to encode the session data.

bundle exec rake generate_secret_token

Write the PostgreSQL database.

RAILS_ENV=production bundle exec rake db:migrate

Run the following command, which writes the default data into PostgreSQL database.

RAILS_ENV=production bundle exec rake redmine:load_default_data

The above command will ask you to choose the default language to be used with the application. The default choice is English; choose according to your preference.

[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 rakenduse installimine on nüüd lõpetatud. Muutke kataloogide ja failide omandiõigust ja õigusi.

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

Oleme konfigureerinud kõik, mida vajame mitteprivilegeeritud kasutajalt. Lülitage tagasi sudokasutaja juurde, käivitades su - <username>.

Seadistage Apache

Lisage Apache'i moodul Passenger Apache'i konfiguratsioonifaili. See laadib automaatselt reisija mooduli.

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

Looge oma Redmine rakenduse jaoks uus virtuaalne hostfail.

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

Täitke fail järgmise sisuga.

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

Asendage kindlasti redmine.example.comoma tegeliku domeeninimega. Samuti veenduge, et tee ja PassengerRootja PassengerRubyon õiged. Tee binaarfailideni võib muutuda, kui ilmub Ruby või Passengeri uus väljalase. Nende teede leidmiseks käivitage järgmine käsk.

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

Saate järgmise väljundi.

[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

Kui virtuaalse hosti fail on loodud, taaskäivitage Apache veebiserver.

sudo systemctl restart httpd

Muutke tulemüüri konfiguratsiooni, et lubada 80tulemüüri kaudu port .

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

Nüüd pääsete oma Redmine liidesele juurde saidil http://redmine.example.com. Logi sisse kasutajanime adminja parooliga admin. Esimesel sisselogimisel palub Redmine teil parool värskendada.

Apache'i kaitsmine Let's Encrypt SSL-iga

Kuna meie Redmine installimine on avalikus serveris, on soovitatav kasutada SSL-i, et tagada serverist andmete vahetamine.

Installige Certbot, mis on Let's Encrypt CA klientrakendus.

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

Enne sertifikaatide taotlemist peate lubama pordi 80ja/ 443või standard- HTTPja HTTPSteenused tulemüüri kaudu. Kuna oleme porti juba 80varem lubanud , siis lubame port 443.

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

Märkus. Sertifikaatide hankimiseks ettevõttelt Let's Encrypt CA peab domeen, mille jaoks sertifikaate genereerida, olema suunatud serveri poole. Kui ei, tehke vajalikud muudatused domeeni DNS-kirjetes ja oodake, kuni DNS levib, enne kui esitate uuesti sertifikaaditaotluse. Certbot kontrollib enne sertifikaatide väljastamist domeeni autoriteeti.

Looge SSL-sertifikaadid.

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

Loodud sertifikaadid salvestatakse tõenäoliselt /etc/letsencrypt/live/redmine.example.com/. SSL-sertifikaat salvestatakse kujul cert.pemja privaatvõti kui privkey.pem.

Krüptimise sertifikaadid aeguvad 90 päeva pärast, seetõttu on soovitatav seadistada sertifikaatide automaatne uuendamine Croni töödega.

Avage kasutaja jaoks Croni tööfail root.

sudo crontab -e

Lisage faili lõppu järgmine rida.

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

Ülaltoodud Croni töö algab iga päev kell 5.30. Kui sertifikaat hakkab aeguma, uuendatakse seda automaatselt.

Redmine jaoks varem loodud virtuaalse hosti faili redigeerimine.

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

Muutke virtuaalse hosti faili, et see näeks välja järgmine.

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

Salvestage fail ja väljuge redaktorist.

Taaskäivitage Apache, et muudatused jõustuksid.

sudo systemctl restart httpd

Nüüd pääsete Redmine'ile juurde HTTPSsaidil https://redmine.example.com.

Õnnitleme, olete Redmine'i edukalt installinud oma CentOS 7 eksemplari. Alustage oma projekti arendamist kas projekti loomise või importimisega.