Redmine bemutatása és konfigurálása Debian 9 rendszeren.

Mielőtt elkezdené, győződjön meg róla, hogy ezt megteszi

• Legyen egy domain neve, amely egy nyilvános IP-címre mutat a szerverén. A példa.com-ot fogjuk használni.
• Bejelentkezve sudo-kedvelt ügyfélként.
• Telepítve. Nginx
• Telepítve van egy Domain SSL nyilatkozat.

Hozzon létre egy MySQL adatbázist

A Redmine támogatja a MySQL/MariaDB, SQL Server, SQLite 3, Microsoft és PostgreSQL adatbázisokat. A MariaDB-t fogjuk használni az adatbázis háttérrendszeréhez. Ellenőrizze, hogy legalább MySQL 5.7 vagy MariaDB 10.3 van-e telepítve a számítógépén. 
Ha a Debian szerverén nincs MariaDB vagy MySQL, akkor telepítheti azokat az alábbi utasítások szerint. 
Kezdje azzal, hogy bejelentkezik a MySQL támogatásába írva:
$ sudo mysql
Új adatbázis létrehozásához futtassa a következő SQL utasítást; 
mysql> CREATE DATABASE redmine CHARACTER SET utf8mb4;
Hozzon létre egy új felhasználói fiókot a MySQL-hez, és engedélyezze a hozzáférést az adatbázishoz: 
mysql> GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password';
mysql> flush priviledges; <- ez fontos! Ellenkező esetben a változások nem alkalmazódnak a mysql szolgáltatás újraindításáig.
Ne felejtse el megváltoztatni a jelszót egy erős jelszóra.
Ha elkészült, jelentkezzen ki a MariaDB konzolból a következő beírásával:
mysql> EXIT;

Telepítse a Ruby-t

Telepítse a legfrissebb Ruby verziót a Rbenv vagy a RVM segítségével.

RVM

1. telepítse az rvm-et, futtassa, adja hozzá az autostart-hoz
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. Hozzon létre egy "easy" felhasználót (vagy bárhogy nevezheti el, a lényeg az, hogy ez a felhasználó fog dolgozni a redmine alkalmazással, nem a root felhasználóval. Biztonsági okokból kell ezt megtenni)
useradd -m -G rvm -s /bin/bash easy
Szüksége van arra is, hogy hozzáadja a "easy" felhasználót a sudoers csoportba (engedélyeznünk kell ennek a felhasználónak, hogy futtasson néhány parancsot a sudo-ból)
usermod -a -G sudo easy
Ha ezt megtette, akkor kihagyhatja a következő lépést, mert ezzel a parancsal a felhasználó már a megfelelő csoportban van. Váltson erre a felhasználóra
su - easy
3. adja hozzá a felhasználót a rvm csoportba
usermod -a -G rvm easy
Szüksége van arra is, hogy hozzáadja a "easy" felhasználót a sudoers csoportba (engedélyeznünk kell ennek a felhasználónak, hogy futtasson néhány parancsot a sudo-ból)
usermod -a -G sudo easy
Váltson a "easy" felhasználóra
su - easy
4. telepítse a ruby-t
rvm install 2.6 --patch railsexpress
5. telepítse a git-et
sudo apt-get install git
6. állítsa be az alapértelmezett ruby 2.6 -ot
rvm use 2.6 --default
A dőlt betűs rész csak akkor szükséges, ha nem root felhasználóból telepíti a ruby-t. Ha úgy dönt, hogy ezt hagyja, akkor a felhasználónevet "easy"-re cserélheti "redmine"-re.

Rbenv

Kérjük, kövesse az utasításokat ebben a cikkben.

Passenger és Nginx bemutatása #

A Passenger egy gyors, könnyű Ruby, Node.js és Python webalkalmazás-szerver, amely Apache és Nginx segítségével is beilleszthető. A Passenger Nginx modulként lesz bemutatva.

Az https tároló létrehozásához szükséges csomagok telepítése:

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

Importálja a GPG kulcs tárolóját, és engedélyezze a Phusionpassenger tárolót:

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

Frissítse a csomagok listáját, majd telepítse a Nginx Passenger modult:

$   sudo apt update

$   sudo apt install libnginx-mod-http-passenger

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

$   passenger-install-nginx-module

Redmine telepítése Debianra

Kezdje a Redmine telepítését a szükséges függőségek telepítésével:

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

Mielőtt folytatná a következő lépéssel, ellenőrizze a Redmine letöltési oldalát egy újabb verzióért.

Redmine letöltése

Használja a következő curl parancsot a Redmine archívumának letöltéséhez:

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

Ha letöltés befejeződött, csomagolja ki az archívumot, majd át kell helyezni az /opt könyvtárba:

$  cd /tmp

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

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

Redmine adatbázisának konfigurálása:

Másolja a konfigurációs fájlt egy példával a Redmine-ból:

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

Nyissa meg a szövegszerkesztő fájlt:

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

Keresse meg a production szakaszt, és adja meg a korábban létrehozott MySQL adatbázis és felhasználó adatait:

/opt/redmine/config/database.yml

Production:

  adapter: mysql2

  database: redmine

  host: localhost

  username: redmine

  password: "change-with-strong-password"

  encoding: utf8

Mentse el a fájlt, majd lépjen ki a szerkesztőből.

Ruby feltételek telepítése

Telepítse a bundlert és más Ruby feltételeket, majd navigáljon a Redmine könyvtárába:

$ cd path/to/redmine/

$ sudo gem install bundler

$ sudo bundle install -- without development test

Az adatbázis áthelyezése kulcsok generálásával:

Futtassa a mellékelt kulcs generálási parancsot, majd helyezze át az adatbázist.

$ sudo bundle exec rake generate_secret_token

$ sudo RAILS_ENV=production bundle exec rake db:migrate

Állítsa be a megfelelő engedélyeket

A Nginx kliensként és a www-információ hálózatként fut. Állítsa be az engedélyeket a következő chown parancs megadásával.

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

Nginx beállítása

Megjegyzés: Ebben a blogban többet megtudhatsz a letsencrypt-ről, valamint egy alternatív módról a HTTPS tanúsítványok létrehozására/vásárlására (cert-manager).

Ha eddig nem ellenőrizted a szükséges előfeltételeket ehhez az útmutatóhoz, akkor már rendelkezned kell Nginx-szel és egy SSL tanúsítvánnyal a rendszereden.

Nyisd meg a szövegszerkesztőt és hozd létre a következő blokkfájlt a Nginx szerverhez:

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

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

# HTTP átirányítása -> HTTPS

server {

    listen 80;

    server_name www.example.com example.com;

    include snippets/letsencrypt.conf;

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

}

# WWW átirányítása -> 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 paraméterek

    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;

    # naplófájlok

    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;
}
Ne felejtsd el használni a Redmine domainodat az example.com helyett, és állítsd be a helyes elérési utat az SSL tanúsítvány fájlokhoz. Az összes HTTP kérés továbbítva lesz HTTPS-re. Ez az útmutató a beállításban használt kódrészleteket generálja.
A blokk szerver engedélyezése a következő szimbolikus link létrehozásával történik a webhelyek számára engedélyezett könyvtárhoz:
$    sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
Teszteljük a Nginx szolgáltatás újraindítása előtt, hogy biztosak legyünk abban, hogy nincsenek szintaktikai hibák: 
$  sudo nginx -t
Ha nincsenek hibák, akkor a kimenetnek így kell kinéznie: 
nginx: a konfigurációs fájl /etc/nginx/nginx.conf szintaxisa rendben van
nginx: a konfigurációs fájl /etc/nginx/nginx.conf tesztje sikeres volt
Végül indítsuk újra a Nginx szolgáltatást a következő paranccsal:
$  sudo systemctl restart nginx

Hozzáférés a Redmine-hoz

Nyisd meg a böngésződet, írd be a domain nevedet, és ha a telepítés sikeres volt, akkor egy hasonló képernyő jelenik meg, mint az alábbi: 

A Redmine alapértelmezett bejelentkezési adatai a következők: 
Felhasználónév: admin
Jelszó: admin
Amikor először bejelentkezel, felkérnek a jelszavad megváltoztatására, ahogy az alábbi képen látható: 

A jelszó megváltoztatása után átirányítanak a felhasználói fiók oldalra.
Sikeresen feltelepítetted a Redmine-t a Debian rendszereden.