Како инсталирати Редмине на Убунту 16.04

Редмине је бесплатан алат отвореног кода за управљање пројектима заснован на вебу. Написан је у Руби он Раилс и подржава више сервера базе података за складиштење базе података. То је апликација богата функцијама која подржава више пројеката, АЦЛ заснован на улогама и систем за праћење проблема. Такође има подршку за Ганттов графикон и календар, управљање датотекама, вики и форум по пројекту, као и многе друге функције. Подржава системе за контролу верзија као што су Гит, СВН или ЦВС. Такође је вишејезичан, подржава чак 49 језика.

Предуслови

• Инстанца сервера Вултр Убунту 16.04.
• : Судо корисника .
• Име домена усмерено ка серверу.

За овај водич користићемо 192.168.1.1као јавну ИП адресу и redmine.example.com као име домена усмерено на Вултр инстанцу. Обавезно замените сва појављивања примера имена домена и ИП адресе стварним.

Ажурирајте свој основни систем користећи водич Како ажурирати Убунту 16.04 . Када се ваш систем ажурира, наставите са инсталирањем зависности.

Инсталирајте Апацхе

Редмине је написан у Руби он Раилс, тако да ћемо захтевати да се Пхусион Пассенгер интегрише са Апацхе веб сервером да би служио апликацији.

Инсталирајте Апацхе.

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

Да бисмо направили Руби и Пассенгер, биће нам потребни и неки развојни алати. Инсталирајте потребне алате.

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

Инсталирајте ПостгреСКЛ

Редмине подржава више типова сервера база података као што су МиСКЛ, ПостгреСКЛ и МССКЛ. У овом водичу ћемо користити ПостгреСКЛ за хостовање Редмине сервера базе података.

ПостгреСКЛ је објектно-релациони систем базе података. Подразумевано Убунту спремиште садржи стару верзију ПостгреСКЛ-а, па додајте ПостгреСКЛ спремиште у систем.

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

Инсталирајте ПостгреСКЛ сервер базе података.

sudo apt -y install postgresql

Покрените ПостгреСКЛ сервер и омогућите му да се аутоматски покреће при покретању.

sudo systemctl start postgresql
sudo systemctl enable postgresql

Промените лозинку за подразумеваног корисника ПостгреСКЛ.

sudo passwd postgres

Пријавите се као ПостгреСКЛ корисник.

sudo su - postgres

Креирајте новог ПостгреСКЛ корисника за Редмине.

createuser redmine

Дозвољено вам је да користите било које корисничко име уместо redmine. ПостгреСКЛ обезбеђује psql љуску за покретање упита у бази података. Пређите на ПостгреСКЛ шкољку.

psql

Поставите лозинку за новокреираног корисника за Редмине базу података.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

Замените DBPassword безбедном лозинком. Креирајте нову базу података за Редмине инсталацију.

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

Изађите из psql љуске.

\q

Пребаците се на sudo корисника.

exit

Инсталирајте још неколико потребних ПостгреСКЛ зависности.

sudo apt -y install libpqxx-dev protobuf-compiler

Инсталирајте Руби

Инсталираћемо најновију верзију Руби-а користећи РВМ. Користи се за инсталирање и управљање више верзија Руби-а.

Додајте РВМ спремиште.

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

Инсталирајте РВМ.

sudo apt -y install rvm

Пошто морамо да инсталирамо Руби широм система, привремено ћемо се пребацити на роот корисника.

sudo -i

Ажурирајте променљиве окружења.

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

Инсталирајте најновију верзију Руби-а.

rvm install 2.5.1

Напомена: Ако користите другу верзију Руби-а, обавезно ажурирајте Руби путању у складу са тим.

Користите инсталирану верзију Руби-а.

rvm use 2.5.1 --default

Можете проверити његову верзију.

ruby -v

Видећете сличан излаз.

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

Инсталл bundler, који је менаџер зависности за Руби апликацију.

gem install bundler

Руби је сада инсталиран. Пре него што инсталирамо Редмине, мораћемо да инсталирамо Пхусион Пассенгер.

Инсталирајте Пассенгер

Покрените следећу команду да бисте инсталирали Пассенгер.

gem install passenger

Инсталирајте Апацхе модул за Пассенгер.

passenger-install-apache2-module

Скрипта за инсталацију ће вам поставити нека питања. Прво ће вам пружити информације о процесу инсталације. Затим ће од вас тражити да изаберете језик који ћете користити. Пошто је наша апликација написана у Руби он Раилс, изаберите Руби из менија и притисните ENTERда бисте наставили даље.

Which languages are you interested in?

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

 ‣ ⬢  Ruby
   ⬢  Python
   ⬡  Node.js
   ⬡  Meteor

Инсталатер ће сада проверити захтеве. Инсталатер неће наићи на недостајуће зависности и аутоматски ће наставити да компајлира и инсталира модул.

Када се модул инсталира, од вас ће бити затражено да додате модул у Апацхе конфигурациону датотеку.

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.

We will skip this for now and will complete it later in the tutorial. 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/apache2/apache2.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. Switch to the sudo user again since we do not need to run any more commands using root user.

exit

Install Redmine

It is recommended to use an unprivileged user to run the application to keep it isolated from rest of the system. Create a new user for Redmine and switch to the newly created user.

sudo adduser --disabled-password --gecos "Redmine User" redmine
sudo su - 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 the 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/bin/pg_config

Install the dependencies required by the application.

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

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.

Installation of the Redmine application is now finished. Change ownership and permissions of the directories and files.

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

We have configured everything we need from the non-privileged user. Switch back to the sudo user by running su - <username>.

Configure Apache

Add the Passenger module for Apache into the Apache configuration file. This will automatically load the Passenger module.

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

Напомена: Путања до модула Пассенгер се може променити када постоји ново издање Пассенгер. Да бисте пронашли путању до модула, користите sudo find / -name mod_passenger.soкоманду.

Креирајте нови виртуелни хост фајл за вашу Редмине апликацију.

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

Попуните датотеку следећим садржајем.

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

Обавезно замените redmine.example.com својим стварним именом домена. Такође, уверите се да је путања до PassengerRoot и PassengerDefaultRuby тачна. Пут до бинарних датотека се може променити када се појави ново издање Руби-а или Пассенгер-а. Да бисте пронашли ове путање, покрените следећу команду.

passenger-config about ruby-command

Добићете следећи излаз.

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

Када се креира датотека виртуелног хоста. Активирајте конфигурацију.

sudo a2ensite redmine

Поново покрените Апацхе веб сервер.

sudo systemctl restart apache2

Сада можете приступити свом Редмине интерфејсу на http://redmine.example.com. Пријавите се са корисничким именом adminи лозинком admin. Приликом вашег првог пријављивања, Редмине ће од вас затражити да ажурирате лозинку.

Осигуравање Апацхе-а помоћу Лет'с Енцрипт ССЛ

Пошто је наша Редмине инсталација на јавном серверу, препоручује се да користите ССЛ да бисте обезбедили размену података са сервера.

Додајте Цертбот спремиште.

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

Инсталирајте Цертбот, који је клијентска апликација за Лет'с Енцрипт ЦА.

sudo apt -y install certbot

Напомена: Да бисте добили сертификате од Лет'с Енцрипт ЦА, домен за који треба да се генеришу сертификати мора бити усмерен ка серверу. Ако није, извршите неопходне промене у ДНС записима домена и сачекајте да се ДНС пропагира пре него што поново поднесете захтев за сертификат. Цертбот проверава ауторитет домена пре пружања сертификата.

Генеришите ССЛ сертификате.

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

Генерисани сертификати ће вероватно бити ускладиштени у /etc/letsencrypt/live/redmine.example.com/. ССЛ сертификат ће бити сачуван као, cert.pem а приватни кључ ће бити сачуван као privkey.pem.

Лет'с Енцрипт сертификати истичу за 90 дана, па се препоручује да подесите аутоматско обнављање сертификата помоћу Црон послова.

Отворите Црон датотеку задатка за root корисника.

sudo crontab -e

Додајте следећи ред на крај датотеке.

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

Горе наведени Црон посао ће се изводити сваког дана у 5:30 ујутро. Ако сертификат истекне, аутоматски ће се обновити.

Омогућите ССЛ модул за Апацхе.

sudo a2enmod ssl

Уредите виртуелну датотеку хоста коју смо раније креирали за Редмине.

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

Измените датотеку виртуелног хоста тако да буде слична следећој.

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

Сачувајте датотеку и изађите из уређивача.

Поново покрените Апацхе да би промене ступиле на снагу.

sudo systemctl restart apache2

Сада можете приступ Редмине преко HTTPS у https://redmine.example.com.

Честитамо, успешно сте инсталирали Редмине на своју Убунту 16.04 инстанцу. Почните да развијате свој пројекат креирањем или увозом пројекта.