Kaip įdiegti „Redmine“ Ubuntu 16.04

Redmine yra nemokamas atviro kodo, internetinis projektų valdymo įrankis. Ji parašyta Ruby on Rails kalba ir palaiko kelis duomenų bazių serverius duomenų bazei saugoti. Tai daug funkcijų turinti programa, palaikanti kelis projektus, vaidmenimis pagrįstą ACL ir problemų sekimo sistemą. Jame taip pat yra Ganto diagramos ir kalendoriaus palaikymas, failų valdymas, projektų wiki ir forumas, taip pat daug kitų funkcijų. Jis palaiko versijų valdymo sistemas, tokias kaip Git, SVN arba CVS. Ji taip pat yra daugiakalbė ir palaiko net 49 kalbas.

Būtinos sąlygos

• „Vultr Ubuntu 16.04“ serverio egzempliorius.
• Sudo vartotojas .
• Domeno vardas nukreiptas į serverį.

Šioje pamokoje naudosime 192.168.1.1kaip viešąjį IP adresą ir redmine.example.com kaip domeno pavadinimą, nukreiptą į Vultr egzempliorių. Būtinai pakeiskite visus pavyzdinio domeno vardo ir IP adreso atvejus tikruoju.

Atnaujinkite bazinę sistemą naudodami vadovą Kaip atnaujinti Ubuntu 16.04 . Kai sistema bus atnaujinta, toliau diegkite priklausomybes.

Įdiekite „Apache“.

„Redmine“ parašyta „Ruby on Rails“, todėl programai aptarnauti turėsime „Phusion Passenger“ integruotis su „Apache“ žiniatinklio serveriu.

Įdiekite „Apache“.

sudo apt -y install apache2 apache2-dev libcurl4-openssl-dev

Norėdami sukurti „Ruby“ ir „Passenger“, mums taip pat reikės kai kurių kūrimo įrankių. Įdiekite reikiamus įrankius.

sudo apt -y install imagemagick libmagickwand-dev git build-essential automake libgmp-dev

Įdiekite PostgreSQL

Redmine palaiko kelių tipų duomenų bazių serverius, tokius kaip MySQL, PostgreSQL ir MSSQL. Šioje pamokoje naudosime PostgreSQL, kad priglobtume Redmine duomenų bazės serverį.

PostgreSQL yra objektų santykių duomenų bazės sistema. Numatytoje Ubuntu saugykloje yra sena PostgreSQL versija, todėl pridėkite PostgreSQL saugyklą prie sistemos.

echo "deb http://apt.postgresql.org/pub/repos/apt/ xenial-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt update

Įdiekite PostgreSQL duomenų bazės serverį.

sudo apt -y install postgresql

Paleiskite PostgreSQL serverį ir įgalinkite jį automatiškai paleisti įkrovos metu.

sudo systemctl start postgresql
sudo systemctl enable postgresql

Pakeiskite numatytojo „PostgreSQL“ vartotojo slaptažodį.

sudo passwd postgres

Prisijunkite kaip PostgreSQL vartotojas.

sudo su - postgres

Sukurkite naują Redmine PostgreSQL vartotoją.

createuser redmine

Vietoj , galite naudoti bet kokį vartotojo vardą redmine. PostgreSQL suteikia psql apvalkalą duomenų bazėje užklausoms vykdyti. Perjunkite į PostgreSQL apvalkalą.

psql

Nustatykite slaptažodį naujai sukurtam Redmine duomenų bazės vartotojui.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

Pakeiskite DBPassword saugiu slaptažodžiu. Sukurkite naują „Redmine“ diegimo duomenų bazę.

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

Išeiti iš psql apvalkalo.

\q

Perjungti į sudo vartotoją.

exit

Įdiekite dar kelias reikalingas PostgreSQL priklausomybes.

sudo apt -y install libpqxx-dev protobuf-compiler

Įdiekite Ruby

Įdiegsime naujausią Ruby versiją naudodami RVM. Jis naudojamas kelioms Ruby versijoms įdiegti ir valdyti.

Pridėkite RVM saugyklą.

sudo apt-add-repository -y ppa:rael-gc/rvm
sudo apt update

Įdiekite RVM.

sudo apt -y install rvm

Kadangi mums reikia įdiegti Ruby sistemos platų, laikinai pereisime prie root vartotojo.

sudo -i

Atnaujinkite aplinkos kintamuosius.

echo "source /etc/profile.d/rvm.sh" | tee -a /etc/profile
source /etc/profile.d/rvm.sh

Įdiekite naujausią Ruby versiją.

rvm install 2.5.1

Pastaba: jei naudojate kitą Ruby versiją, būtinai atitinkamai atnaujinkite Ruby kelią.

Naudokite įdiegtą Ruby versiją.

rvm use 2.5.1 --default

Galite patikrinti jo versiją.

ruby -v

Pamatysite panašų išvestį.

root@vultr:~# ruby -v
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux]

Įdiekite bundler, kuri yra „Ruby“ programos priklausomybės tvarkyklė.

gem install bundler

Ruby dabar įdiegtas. Prieš diegdami Redmine, turėsime įdiegti Phusion Passenger.

Įdiekite „Passenger“.

Vykdykite šią komandą, kad įdiegtumėte Passenger.

gem install passenger

Įdiekite „Apache“ modulį keleiviams.

passenger-install-apache2-module

Diegimo programos scenarijus užduos jums keletą klausimų. Pirma, ji suteiks jums informacijos apie diegimo procesą. Tada jis paprašys jūsų pasirinkti kalbą, kurią naudosite. Kadangi mūsų programa parašyta Ruby on Rails, meniu pasirinkite Ruby ir paspauskite, ENTERkad tęstumėte toliau.

Which languages are you interested in?

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

 ‣ ⬢  Ruby
   ⬢  Python
   ⬡  Node.js
   ⬡  Meteor

Dabar montuotojas patikrins, ar nėra reikalavimų. Diegimo programa nesusidurs su trūkstamomis priklausomybėmis ir automatiškai pradės kompiliuoti ir įdiegti modulį.

Kai modulis bus įdiegtas, jis paragins įtraukti modulį į „Apache“ konfigūracijos failą.

Almost there!

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

   LoadModule passenger_module /usr/share/rvm/gems/ruby-2.5.1/gems/passenger-5.2.3/buildout/apache2/mod_passenger.so
   <IfModule mod_passenger.c>
     PassengerRoot /usr/share/rvm/gems/ruby-2.5.1/gems/passenger-5.2.3
     PassengerDefaultRuby /usr/share/rvm/gems/ruby-2.5.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.

Kol kas tai praleisime ir užbaigsime vėliau mokymo programoje. Paspauskite, ENTERkad praleistumėte šį veiksmą.

Galiausiai diegimo scenarijus patvirtins diegimą ir pamatysite įspėjimą, kad „Apache“ konfigūracijoje nenurodytas keleivio 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/apache2/apache2.conf.


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

Dabar, kai įdiegėme „Apache“ skirtą „Passenger“ modulį, atsisiųskite ir įdiekite „Redmine“. sudoDar kartą perjunkite į vartotoją, nes mums nereikia vykdyti daugiau komandų naudojant rootvartotoją.

exit

Įdiekite Redmine

Programai paleisti rekomenduojama naudoti neprivilegijuotą vartotoją, kad ji būtų izoliuota nuo likusios sistemos. Sukurkite naują Redmine vartotoją ir pereikite prie naujai sukurto vartotojo.

sudo adduser --disabled-password --gecos "Redmine User" redmine
sudo su - redmine

Atsisiųskite naujausią Redmine versiją iš oficialaus Redmine atsisiuntimo puslapio .

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

Patogumo sumetimais išskleiskite archyvą ir pervardykite katalogą.

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

Nukopijuokite pavyzdinius konfigūracijos failus į gamybos vietą.

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

Atidarykite duomenų bazės konfigūracijos failą, kurį ką tik nukopijavome, kad įvestumėte išsamią duomenų bazės informaciją.

nano config/database.yml

Pagal numatytuosius nustatymus duomenų bazės failas sukonfigūruotas MySQL. Raskite gamybos ir kūrimo konfigūracijas ir išbandykite, kuri naudoja MySQL adapterį. Komentuokite visas šias eilutes.

#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

Toliau suraskite eilutes, kurios yra komentuojamos production su postgresql adapterio konfigūracija . Panaikinkite šias eilutes ir atnaujinkite duomenų bazės pavadinimą bei vartotojo kredencialus. Įsitikinkite, kad naudojate teisingą įtrauką, kuri yra du tarpai.

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

Sukonfigūruokite programą, kad ji naudotų PostgreSQL konfigūraciją.

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

Įdiekite programai reikalingas priklausomybes.

bundle install --path vendor/bundle --without development test

Diegimo pabaigoje pamatysite šį pranešimą.

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.
Bundled gems are installed into `./vendor/bundle`

Ši komanda generuoja slaptus prieigos raktus, kurie naudojami seanso duomenims koduoti.

bundle exec rake generate_secret_token

Parašykite PostgreSQL duomenų bazę.

RAILS_ENV=production bundle exec rake db:migrate

Vykdykite šią komandą, kuri įrašo numatytuosius duomenis į PostgreSQL duomenų bazę.

RAILS_ENV=production bundle exec rake redmine:load_default_data

Aukščiau pateikta komanda paprašys jūsų pasirinkti numatytąją kalbą, kuri bus naudojama su programa. Numatytasis pasirinkimas yra anglų kalba; pasirinkti pagal savo pageidavimus.

[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“ programos diegimas baigtas. Pakeiskite katalogų ir failų nuosavybę ir leidimus.

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

Mes sukonfigūravome viską, ko mums reikia iš neprivilegijuoto vartotojo. Perjunkite atgal į sudo vartotoją paleisdami su - <username>.

Konfigūruokite „Apache“.

Į „Apache“ konfigūracijos failą pridėkite „Apache“ skirtą „Passenger“ modulį. Tai automatiškai įkels keleivio modulį.

echo "LoadModule passenger_module /usr/share/rvm/gems/ruby-2.5.1/gems/passenger-5.2.3/buildout/apache2/mod_passenger.so" | sudo tee -a /etc/apache2/apache2.conf

Pastaba: Kelias į keleivių modulį gali pasikeisti, kai bus nauja keleivio versija. Norėdami rasti kelią į modulį, naudokite sudo find / -name mod_passenger.sokomandą.

Sukurkite naują virtualaus pagrindinio kompiuterio failą savo „Redmine“ programai.

sudo nano /etc/apache2/sites-available/redmine.conf

Užpildykite failą tokiu turiniu.

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

    DocumentRoot /home/redmine/redmine/public

    PassengerRoot /usr/share/rvm/gems/ruby-2.5.1/gems/passenger-5.2.3
    PassengerDefaultRuby /usr/share/rvm/gems/ruby-2.5.1/wrappers/ruby
    PassengerUser redmine

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

Būtinai pakeiskite redmine.example.com tikruoju domeno pavadinimu. Taip pat įsitikinkite, kad kelias į PassengerRoot ir PassengerDefaultRuby yra teisingas. Kelias į dvejetainius failus gali pasikeisti, kai pasirodys naujas Ruby arba Passenger leidimas. Norėdami rasti šiuos kelius, paleiskite šią komandą.

passenger-config about ruby-command

Gausite tokią išvestį.

user@vultr:~$ passenger-config about ruby-command
passenger-config was invoked through the following Ruby interpreter:
  Command: /usr/share/rvm/gems/ruby-2.5.1/wrappers/ruby
  Version: ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux]
  To use in Apache: PassengerRuby /usr/share/rvm/gems/ruby-2.5.1/wrappers/ruby
  To use in Nginx : passenger_ruby /usr/share/rvm/gems/ruby-2.5.1/wrappers/ruby
  To use with Standalone: /usr/share/rvm/gems/ruby-2.5.1/wrappers/ruby /usr/share/rvm/gems/ruby-2.5.1/gems/passenger-5.2.3/bin/passenger start


## Notes for RVM users
Do you want to know which command to use for a different Ruby interpreter? 'rvm use' that Ruby interpreter, then re-run 'passenger-config about ruby-command'.

Kai bus sukurtas virtualaus pagrindinio kompiuterio failas. Suaktyvinkite konfigūraciją.

sudo a2ensite redmine

Iš naujo paleiskite „Apache“ žiniatinklio serverį.

sudo systemctl restart apache2

Dabar galite pasiekti savo Redmine sąsają http://redmine.example.com. Prisijunkite naudodami vartotojo vardą adminir slaptažodį admin. Pirmą kartą prisijungus, Redmine paragins atnaujinti slaptažodį.

Apache apsauga naudojant Let's Encrypt SSL

Kadangi mūsų „Redmine“ diegimas yra viešajame serveryje, rekomenduojama naudoti SSL, kad būtų apsaugotas duomenų keitimasis iš serverio.

Pridėkite Certbot saugyklą.

sudo add-apt-repository --yes ppa:certbot/certbot
sudo apt-get update

Įdiekite „Certbot“, kuri yra „Let's Encrypt CA“ kliento programa.

sudo apt -y install certbot

Pastaba: norint gauti sertifikatus iš Let's Encrypt CA, domenas, kuriam turi būti generuojami sertifikatai, turi būti nukreiptas į serverį. Jei ne, atlikite reikiamus domeno DNS įrašų pakeitimus ir palaukite, kol DNS išplis, prieš vėl pateikdami sertifikato užklausą. „Certbot“ patikrina domeno instituciją prieš pateikdamas sertifikatus.

Sukurkite SSL sertifikatus.

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

Sugeneruoti sertifikatai greičiausiai bus saugomi /etc/letsencrypt/live/redmine.example.com/. SSL sertifikatas bus saugomas kaip , cert.pem o privatus raktas bus saugomas kaip privkey.pem.

„Encrypt“ sertifikatai baigiasi po 90 dienų, todėl rekomenduojama nustatyti automatinį sertifikatų atnaujinimą naudojant „Cron“ užduotis.

Atidarykite vartotojo Cron darbo failą root .

sudo crontab -e

Failo pabaigoje pridėkite šią eilutę.

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

Pirmiau nurodytas Cron darbas bus vykdomas kiekvieną dieną 5:30 val. Jei baigiasi sertifikato galiojimo laikas, jis automatiškai atnaujinamas.

Įgalinkite „Apache“ SSL modulį.

sudo a2enmod ssl

Redaguokite virtualaus pagrindinio kompiuterio failą, kurį anksčiau sukūrėme „Redmine“.

sudo nano /etc/apache2/sites-available/redmine.conf

Pakeiskite virtualaus pagrindinio kompiuterio failą, kad jis būtų panašus į toliau pateiktą.

<VirtualHost *:80>
    ServerName redmine.example.com
    Redirect permanent / https://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 /usr/share/rvm/gems/ruby-2.5.1/gems/passenger-5.2.3
    PassengerDefaultRuby /usr/share/rvm/gems/ruby-2.5.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>

Išsaugokite failą ir išeikite iš redaktoriaus.

Iš naujo paleiskite „Apache“, kad pakeitimai įsigaliotų.

sudo systemctl restart apache2

Dabar „Redmine“ galite pasiekti HTTPS adresu https://redmine.example.com.

Sveikiname, sėkmingai įdiegėte Redmine savo Ubuntu 16.04 egzemplioriuje. Pradėkite kurti savo projektą kurdami arba importuodami projektą.