Esittele ja määritä Redmine Debian 9:llä

Ennen aloittamista varmista, että teet tämän

• Ole verkkotunnusosoite, joka osoittaa julkiseen IP-osoitteeseen palvelimellasi. Käytämme esimerkki.comia.
• Kirjaudu sisään sudo-suositeltuna käyttäjänä.
• Asennettu Nginx
• Ole Domain SSL -todistus asennettu.

Luo MySQL-tietokanta

Redmine tukee MySQL/MariaDB, SQL Server, SQLite 3, Microsoft ja PostgreSQL. Käytämme MariaDB:tä tietokannan taustalla. Varmista, että olet asentanut vähintään MySQL 5.7 tai MariaDB 10.3 tietokoneellesi. 
Jos Debian-palvelimellasi ei ole MariaDB:ta tai MySQL:ää, voit asentaa sen näillä ohjeilla. 
Aloita kirjautumalla sisään kirjoittamalla MySQL-komentoriville:
$ sudo mysql
Luodaksesi uuden tietokannan, suorita seuraava SQL-lause; 
mysql> CREATE DATABASE redmine CHARACTER SET utf8mb4;
Luo uusi käyttäjätili MySQL:lle ja salli pääsy tietokantaan: 
mysql> GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'vaihda-vahvalla-salasanalla';
mysql> flush priviledges; <- tämä on tärkeää! Muuten muutokset eivät astu voimaan ennen kuin mysql-palvelu käynnistetään uudelleen.
Muista vaihtaa vahva salasana vaihda-vahvalla-salasanalla.
Kun olet valmis, kirjaudu ulos MariaDB:n komentoriviltä kirjoittamalla:
mysql> EXIT;

Asenna Ruby

Asenna uusin Ruby-versio Rbenvin tai RVM:n avulla.

RVM

1. Asenna rvm, suorita se, lisää käynnistyksen yhteyteen
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. Luo käyttäjä "easy" (tai voit nimetä sen haluamallasi tavalla, tärkeintä on, että tämä käyttäjä toimii redmine-sovelluksen kanssa, ei root-käyttäjä. Tämä on tehtävä turvallisuussyistä)
useradd -m -G rvm -s /bin/bash easy
Sinun on myös lisättävä käyttäjä "easy" sudoers-ryhmään (meidän pitäisi sallia tämän käyttäjän suorittaa joitain komentoja sudo:n kautta)
usermod -a -G sudo easy
Jos teit tämän, saatat jättää seuraavan vaiheen väliin, koska tämän komennon jälkeen käyttäjäsi on jo oikeassa ryhmässä. Vaihda tähän käyttäjään
su - easy
3. Lisää käyttäjä rvm-ryhmään
usermod -a -G rvm easy
Sinun on myös lisättävä käyttäjä "easy" sudoers-ryhmään (meidän pitäisi sallia tämän käyttäjän suorittaa joitain komentoja sudo:n kautta)
usermod -a -G sudo easy
Vaihda käyttäjäksi "easy"
su - easy
4. Asenna Ruby
rvm install 2.6 --patch railsexpress
5. Asenna git
sudo apt-get install git
6. Aseta Ruby 2.6 oletusarvoksi
rvm use 2.6 --default
Osuus kursiivilla tarvitaan vain, jos aiot asentaa Rubyn ei-pääkäyttäjänä. Jos päätät jättää sen pois, voit korvata käyttäjänimen "easy" sanalla "redmine".

Rbenv

Seuraa ohjeita tässä artikkelissa.

Esittele Passenger ja Nginx #

Passenger on nopea, kevyt Ruby-, Node.js- ja Python-web-sovelluspalvelin, joka voidaan yhdistää Apacheen ja Nginxiin. Passenger otetaan käyttöön Nginx-moduulina. 

Asenna tarvittavat paketit https-varastoa varten:

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

Tuo GPG-avainvarasto ja salli Phusionpassenger-varaston:

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

Päivitä pakettiluettelo ja asenna Nginx Passenger -moduuli:

$   sudo apt update

$   sudo apt install libnginx-mod-http-passenger

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

$   passenger-install-nginx-module

Asenna Redmine Debianiin

Aloita asentamalla tarvittavat riippuvuudet Redminen rakentamiseen:

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

Tarkista Redminen lataussivu uudemmasta versiosta ennen seuraavaa vaihetta.

Lataa Redmine

Käytä seuraavaa curl-komentoa ladataksesi Redminen arkiston:

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

Pura arkisto ja siirrä se /opt-hakemistoon, kun lataus on valmis:

$  cd /tmp

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

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

Määritä Redminen tietokanta:

Kopioi konfiguraatiotiedosto esimerkiksi Redminelle:

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

Avaa tekstieditoritiedosto:

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

Etsi production-osio ja syötä aiemmin luodun MySQL-tietokannan ja käyttäjän tiedot:

/opt/redmine/config/database.yml

Production:

  adapter: mysql2

  database: redmine

  host: localhost

  username: redmine

  password: "vaihda-vahvaan-salasanaan"

  encoding: utf8

Tallenna tiedosto ja poistu editorista.

Asenna Ruby-ehdot

Asenna bundler ja muut Ruby-ehdot ja siirry Redminen hakemistoon:

$ cd path/to/redmine/

$ sudo gem install bundler

$ sudo bundle install -- without development test

Siirrä tietokanta luomalla avaimet:

Suorita seuraava avaimen luontikomento ja siirrä tietokanta.

$ sudo bundle exec rake generate_secret_token

$ sudo RAILS_ENV=production bundle exec rake db:migrate

Aseta oikeat käyttöoikeudet

Nginx toimii asiakkaana ja www-tiedostona. Aseta käyttöoikeudet oikein antamalla seuraava chown-komento.

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

Aseta Nginx

Huomaa: Tässä blogissa voit oppia lisää letsencryptistä sekä vaihtoehtoisesta tavasta luoda/ostaa HTTPS-sertifikaatteja (cert-manager).

Jos et ole vielä tarkistanut tämän opetusohjelman edellytyksiä, sinun pitäisi jo olla Nginx asennettuna järjestelmääsi SSL-sertifikaatin kanssa.

Avaa tekstieditori ja luo seuraava lohkokoodi Nginx-palvelimelle:

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

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

# Uudelleenohjaa HTTP -> HTTPS

server {

    listen 80;

    server_name www.example.com example.com;

    include snippets/letsencrypt.conf;

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

}

# Uudelleenohjaa WWW -> EI 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-parametrit

    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;

    # lokitiedostot

    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;
}
Älä unohda käyttää Redmine-verkkotunnustasi korvataksesi example.comin ja asettaaksesi oikean polun SSL-varmenne tiedostoille. Kaikki HTTP-pyynnöt ohjataan HTTPS:ään. Tämä opas luo tässä asennuksessa käytetyt katkelmat.
Aktivoi palvelinlohko luomalla symbolinen linkki sivustoille sallittuun hakemistoon:
$    sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
Tee testi ennen Nginx-palvelun uudelleenkäynnistämistä varmistaaksesi, ettei syntaksivirheitä ole: 
$  sudo nginx -t
Jos virheitä ei ilmene, tulostuksen pitäisi näyttää tältä: 
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
Lopuksi käynnistä palvelu uudelleen Nginxillä kirjoittamalla:
$  sudo systemctl restart nginx

Pääse Redmineen

Avaa selain, kirjoita verkkotunnuksesi ja jos asennus onnistuu, näet samanlaisen näytön kuin alla olevassa kuvassa: 

Redminen oletuskirjautumistiedot ovat seuraavat: 
Käyttäjänimi: admin
Salasana: admin
Kun kirjaudut ensimmäistä kertaa sisään, sinua pyydetään vaihtamaan salasana seuraavasti: 

Kun salasana on vaihdettu, sinut ohjataan käyttäjätilin sivulle.
Olet onnistuneesti asentanut Redminen Debian-järjestelmääsi.