Въведете и конфигурирайте Redmine в Debian 9.

Преди да започнете, уверете се, че сте направили това

• Имате име на домейн, сочещо към публичен IP на вашия сървър. Ще използваме example.com.
• Влезли сте като клиент със sudo права.
• Инсталирали сте Nginx.
• Имате инсталиран SSL сертификат за домейна.

Създайте база данни My SQL

Redmine поддържа MySQL/MariaDB, SQL Server, SQLite 3, Microsoft и PostgreSQL. Ще използваме MariaDB като back-end за базата данни. Проверете дали сте инсталирали поне MySQL 5.7 или MariaDB 10.3 на вашия компютър. 
Ако вашият Debian сървър няма MariaDB или MySQL, можете да го инсталирате, като следвате тези инструкции. 
Започнете, като влезете в MySQL конзолата:
$ sudo mysql
За да създадете нова база данни, изпълнете следната SQL команда: 
mysql> CREATE DATABASE redmine CHARACTER SET utf8mb4;
Създайте нов потребител за MySQL и му позволете достъп до базата данни: 
mysql> GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password';
mysql> flush priviledges; <- това е важно! В противен случай промените няма да се приложат, докато не рестартирате mysql услугата.
Не забравяйте да смените силна парола със силна парола.
Когато сте готови, излезте от конзолата на MariaDB, като напишете:
mysql> EXIT;

Инсталирайте Ruby

Инсталирайте най-новата версия на Ruby чрез Rbenv или RVM.

RVM

1. Инсталирайте rvm, стартирайте го, добавете го към автостарта
curl -sSL https://get.rvm.io | sudo bash -s master
source /etc/profile.d/rvm.sh
echo '[[ -s "/etc/profile.d/rvm.sh" ]] && source "/etc/profile.d/rvm.sh"' >> ~/.bashrc
2. Създайте потребител "easy" (или можете да го наречете както желаете, важното е, този потребител ще работи с вашия redmine приложение, а не потребителят root. Това трябва да се направи за сигурност)
useradd -m -G rvm -s /bin/bash easy
Също така трябва да добавите потребителя "easy" към групата sudoers (трябва да му позволите да изпълнява някои команди от sudo)
usermod -a -G sudo easy
Ако сте го направили, може да пропуснете следващата стъпка, защото след тази команда потребителят ви е в правилната група. Превключете към този потребител
su - easy
3. Добавете потребителя към групата rvm
usermod -a -G rvm easy
Също така трябва да добавите потребителя "easy" към групата sudoers (трябва да му позволите да изпълнява някои команди от sudo)
usermod -a -G sudo easy
Превключете към потребителя "easy"
su - easy
4. Инсталирайте Ruby
rvm install 2.6 --patch railsexpress
5. Инсталирайте git
sudo apt-get install git
6. Задайте Ruby 2.6 като по подразбиране
rvm use 2.6 --default
Частта в курсив е необходима само ако ще инсталирате Ruby от не-root потребител. Ако решите да я пропуснете, можете да замените името на потребителя "easy" с "redmine".

Rbenv

Моля, следвайте инструкциите в тази статия.

Инсталиране на Passenger и Nginx #

Passenger е бърз, лек Ruby, Node.js и Python уеб приложение сървър, който може да бъде интегриран с Apache и Nginx. Passenger ще бъде инсталиран като модул на Nginx. 

Инсталиране на пакетите, необходими за създаване на https хранилище:

$    sudo apt install dirmngr gnupg apt-transport-https ca-certificates software-properties-common

Импортиране на GPG ключа на хранилището и разрешаване на Phusionpassenger хранилището:

$   sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7

$   sudo add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger stretch main'

Актуализиране на списъка с пакети и инсталиране на Nginx Passenger модула с:

$   sudo apt update

$   sudo apt install libnginx-mod-http-passenger

$   gem install passenger --no-ri --no-rdoc

$   passenger-install-nginx-module

Инсталиране на Redmine в Debian

Започнете с инсталирането на необходимите зависимости за създаване на Redmine:

$    sudo apt install build-essential libmariadbclient-dev imagemagick libmagickwand-dev curl ruby-dev libxslt-dev libxml2-dev zlib1g-dev

Трябва да проверите страницата за изтегляне на Redmine за по-нова версия, преди да продължите със следващата стъпка.

Изтегляне на Redmine

Използвайте следната команда curl, за да изтеглите архива на Redmine:

$     sudo curl -L http://www.redmine.org/releases/redmine-4.0.4.tar.gz -o /tmp/redmine.tar.gz

Извлечете архива и го прехвърлете в директорията /opt, след като изтеглянето приключи:

$  cd /tmp

$  sudo tar zxf /tmp/redmine.tar.gz

$  sudo mv /tmp/redmine-4.0.4 /opt/redmine

Конфигуриране на базата данни на Redmine:

Копирайте файла за конфигурация за пример в Redmine:

$     sudo cp /opt/redmine/config/database.yml.example /opt/redmine/config/database.yml

Отворете файла в текстов редактор:

$    sudo nano /opt/redmine/config/database.yml

Търсете раздела за production и въведете информацията за предварително създадената MySQL база данни и потребител:

/opt/redmine/config/database.yml

Production:

  adapter: mysql2

  database: redmine

  host: localhost

  username: redmine

  password: "change-with-strong-password"

  encoding: utf8

Запазете файла и излезте от редактора.

Инсталиране на Ruby условия

Инсталирайте bundler и други Ruby условия и отидете в директорията на Redmine:

$ cd path/to/redmine/

$ sudo gem install bundler

$ sudo bundle install -- without development test

Пренасочете базата данни, като генерирате ключове:

Изпълнете съответната команда за генериране на ключове и пренасочете базата данни.

$ sudo bundle exec rake generate_secret_token

$ sudo RAILS_ENV=production bundle exec rake db:migrate

Задаване на правилните разрешения

Nginx работи като клиент и мрежа на www-информацията. Задайте правилните разрешения, като изпълните следната команда chown.

$    sudo chown -R www-data: /opt/redmine/

Настройка на Nginx

Забележка: В този блог можете да научите повече за letsencrypt, както и за алтернативен начин за създаване/придобиване на HTTPS сертификати (cert-manager).

До този момент, ако не сте проверили предпоставките за този урок, вече трябва да имате инсталиран Nginx с SSL сертификат на вашия система.

Отворете вашия текстов редактор и създайте следния блок файл за Nginx сървър:

$    sudo nano /etc/nginx/sites-available/example.com

/etc/nginx/sites-available/example.com

# Пренасочване от HTTP към HTTPS

server {

    listen 80;

    server_name www.example.com example.com;

    include snippets/letsencrypt.conf;

    return 301 https://example.com$request_uri;

}

# Пренасочване от WWW към NON WWW

server {

    listen 443 ssl http2;

    server_name www.example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;

    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;

    include snippets/ssl.conf;

    return 301 https://example.com$request_uri;

}

server {

    listen 443 ssl http2;

    server_name example.com;

    root /opt/redmine/public;

    # SSL параметри

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;

    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;

    include snippets/ssl.conf;

    include snippets/letsencrypt.conf;

    # лог файлове

    access_log /var/log/nginx/example.com.access.log;

    error_log /var/log/nginx/example.com.error.log;

    passenger_enabled on;

    passenger_min_instances 1;

    client_max_body_size 10m;
}
Не забравяйте да използвате вашия домейн на Redmine, за да замените example.com и да зададете правилния път към файловете с SSL сертификати. Всички заявки за HTTP ще бъдат препратени към HTTPS. Този ръководител генерира откъсите, използвани в тази настройка.
Активирайте блока на сървъра, като създадете символична връзка към директорията, активирана за сайтовете:
$    sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
Направете тест преди да рестартирате услугата Nginx, за да сте сигурни, че няма синтактични грешки: 
$  sudo nginx -t
Ако няма грешки, изходът трябва да изглежда така: 
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
Накрая, рестартирайте услугата с Nginx, като въведете:
$  sudo systemctl restart nginx

Достъп до Redmine

Отворете браузъра си, въведете вашия домейн и, ако инсталацията е успешна, ще се появи подобен екран, както следва: 

Потребителското име и паролата по подразбиране за Redmine са: 
Потребителско име: admin
Парола: admin
Когато влезете за първи път, ще бъдете помолени да промените паролата си, както е показано по-долу: 

След като промените паролата, ще бъдете пренасочени към страницата за потребителски акаунт.
Успешно изградихте Redmine на вашия Debian система.