Hogyan telepítsük a Redmine-t az Amazon Web Services (AWS) - Ubuntu 18.04 LTS rendszeren - 1. rész

Két fő lehetőség van a Redmine telepítésére az Amazon Web Services (AWS) platformon:

• Egy egyszerű AWS Linux példány (EC2 vagy Lightsail) használata és a Redmine manuális telepítése, vagy
• Egy előre konfigurált, egy kattintással telepíthető Redmine Lightsail példány használata.

Ha az első lehetőséget választjuk, teljes irányítást kapunk a Redmine telepítésének minden aspektusa felett. Másrészről, a második lehetőség gyors és egyszerű megoldást kínál arra, hogy a Redmine néhány perc alatt működjön, anélkül, hogy be kellene avatkoznunk az összes telepítési és konfigurációs részletbe.

Az útmutató első része leírja, hogyan telepítsük a Redmine-t egy egyszerű AWS Linux példányra.

Előfeltételek

A folyamat megkezdése előtt győződjön meg róla, hogy teljesülnek az alábbi előfeltételek:

• Van egy Amazon Web Services fiókja adminisztrátori jogosultságokkal.
• Van egy domain neve a Redmine alkalmazásához, például redmine.mydomain.com.
• Hozzáférése van a domain DNS-konfigurációjához.

Redmine telepítése egy egyszerű Linux EC2 vagy LightSail példányra

Az útmutató céljából feltételezzük, hogy már elindított egy Ubuntu 18.04 LTS-t futtató AWS EC2 vagy Lightsail példányt.

Ezen a Linux példányon telepítjük a Redmine-t MySQL adatbázissal, NGINX webszerverrel és Phusion Passenger alkalmazásszerverrel.

Állítsa be a DNS-szervert

Mielőtt csatlakozna az eszközhöz, be kell állítania a DNS-t. Hozzon létre egy DNS-bejegyzést a Redmine domain nevéhez (redmine.mydomain.com), amely a AWS Linux példányának nyilvános IP-címére mutat.

Ezt megteheti az AWS Route 53 szolgáltatás segítségével.

DNS-konfiguráció az AWS Route 53 használatával

Az Ubuntu 18.04 LTS példány nyilvános IP-címe megtalálható az EC2 kezelőpultján vagy a Lightsail kezelőpultján.

AWS EC2 kezelőpult

AWS Lightsail kezelőpult

Amint beállította a DNS-bejegyzést, csatlakozzon a Linux példányhoz, és végezze el a következő lépéseket.

Telepítse és konfigurálja a MySQL adatbázist

1. Telepítse a MySQL szerver:

sudo apt update

sudo apt install mysql-server mysql-client

2. Végrehajtja az elsődleges MySQL szerver konfigurációját:

sudo mysql_secure_installation

A következőkre lesz felkérve:

• a VALIDATE PASSWORD PLUGIN aktiválása (mondjon igen-t, és válasszon ERŐS jelszavakat)
• válassza ki a root felhasználó jelszavát.
• távolítsa el az anonim felhasználókat (mondjon igen-t).
• tiltsa le a root távoli bejelentkezését (mondjon nem-et, ha tervezi, hogy a adatbázishoz külső Ubuntu Linux példányról csatlakozik, egyébként mondjon igen-t).
• 
  

3. Ellenőrizze, hogy a MySQL szerver fut:

sudo systemctl status mysql

(a válaszban látnia kell az active (running) szöveget)

4. Hozzon létre egy új adatbázist és egy új adatbázis-felhasználót a Redmine-hoz:

sudo mysql

mysql > CREATE DATABASE redminedb CHARACTER SET utf8mb4;

mysql > GRANT ALL ON redminedb.* TO 'redminedbusr'@'localhost' IDENTIFIED BY 'password';

mysql > flush priviledges;

mysql > EXIT

Telepítse a Ruby-t

Telepítse az alapértelmezett Ruby verziót a Linux disztribúcióhoz. Ha más verzióra van szüksége, használhatja az RVM (Ruby Version Manager)-t.

1. Telepítse a Ruby-t:

Telepítse a Ruby legfrissebb verzióját a Rbenv vagy az 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ármilyen nevet adhat neki, a lényeg az, hogy ez a felhasználó fog dolgozni a redmine alkalmazással, nem a root felhasználó. Biztonsági okokból kell ezt megtenni)

useradd -m -G rvm -s /bin/bash easy

Szükséges továbbá hozzáadni az "easy" felhasználót a sudoers csoportba (engedélyeznünk kell ennek a felhasználónak, hogy futtasson néhány parancsot sudo-val)

usermod -a -G sudo easy

Ha ezt megtette, akkor kihagyhatja a következő lépést, mert ezzel a paranccsal a felhasználó már megfelelő csoportban van. Váltson erre a felhasználóra

su - easy

3. adja hozzá a felhasználót az rvm csoportba

usermod -a -G rvm easy

Szükséges továbbá hozzáadni az "easy" felhasználót a sudoers csoportba (engedélyeznünk kell ennek a felhasználónak, hogy futtasson néhány parancsot sudo-val)

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 szakasz csak akkor szükséges, ha nem root felhasználóként telepíti a ruby-t. Ha úgy dönt, hogy hagyja, akkor az "easy" felhasználónevet "redmine"-ra cserélheti.

Rbenv

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

NGINX és Passenger telepítése

A NGINX egy nyílt forrású webszerver, amely a maximális teljesítmény és stabilitás érdekében lett kifejlesztve. A Passenger egy nyílt forrású alkalmazásszerver, amely integrálódik a NGINX-szel, hogy futtassa a Ruby szoftvert, például a Redmine-t, a weben keresztül. Az esetünkben mindkettőt telepítenünk kell.

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

sudo gem install bundler --no-rdoc --no-ri

Redmine telepítése és konfigurálása

A telepítés folytatása előtt ellenőrizze a legfrissebb Redmine verziót. A letölthető verziók a Redmine letöltések oldalán találhatók.

Redmine letöltések oldala

Jegyezze fel a céleszköz verzióját és folytassa.

Megjegyzés: Jobb, ha nem a root felhasználóval telepíti és futtatja a Redmine-t.

1. Telepítse a Redmine építéséhez szükséges függőségeket:

sudo apt install build-essential libmysqlclient-dev imagemagick libmagickwand-dev

2. Töltse le a Redmine-t a /tmp könyvtárba:

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

3. Csomagolja ki a letöltött archívumot és másolja át az alkalmazás fájljait az installációs könyvtárba:

cd /tmp

sudo tar zxf /tmp/redmine.tar.gz

sudo mv /tmp/redmine-4.1.0 /var/www/html/redmine/

3. Redmine adatbázis beállításainak konfigurálása

3.1. Nyissa meg az adatbázis konfigurációs fájlt (database.yml)

cd /var/www/html/redmine/config/

cp database.yml.example database.yml

sudo nano /var/www/html/redmine/config/database.yml

3.2. Alkalmazza az alábbi változtatásokat a fájl production szakaszában:

production:

adapter: mysql2

database: redminedb

host: localhost

username: redminedbusr

password: "password"

encoding: utf8mb4

3.3 Telepítse a Redmine futtatásához szükséges Ruby függőségeket:

cd /var/www/html/redmine/

sudo gem install bundler --no-rdoc --no-ri

sudo bundle install --without development test postgresql sqlite

3.4 Migrálja az adatbázist és konfigurálja a futási környezetet.

cd /var/www/html/redmine/

sudo bundle exec rake generate_secret_token

sudo RAILS_ENV=production bundle exec rake db:migrate

NGINX konfigurálása

Ez az utolsó lépés a tutorialban. Miután befejezte az NGINX konfigurálását, teljesen működőképes Redmine szerverrel rendelkezik az Ubuntu 18.04 LTS dobozán.

1. Hozzon létre egy virtuális hostot a Redmine alkalmazásához:

sudo nano /etc/nginx/sites-available/redmine.mydomain.com

2. Adja meg a következő virtuális host konfigurációt, majd mentse el a fájlt:

server {

listen 80;

server_name redmine.mydomain.com;

root /var/www/html/redmine/public;

passenger_enabled on;

passenger_min_instances 1;

client_max_body_size 10m;

# redirect server error pages to the static page /50x.html

#

error_page 500 502 503 504 /50x.html;

location = /50x.html {

root html;

}

}

3. Engedélyezze a virtuális hostot a frissen létrehozott konfigurációs fájl hivatkozásával a sites-enabled könyvtárban:

sudo ln -s /etc/nginx/sites-available/redmine.mydomain.com /etc/nginx/sites-enabled/redmine.mydomain.com

4. Ellenőrizze az NGINX konfigurációját:

sudo nginx -t

COMMAND OUTPUT:

nginx: a /etc/nginx/nginx.conf konfigurációs fájl szintaxisa rendben van

nginx: a /etc/nginx/nginx.conf konfigurációs fájl tesztje sikeres

5. Indítsa újra az NGINX szervert:

sudo systemctl restart nginx

Hozzáférés a Redmine-hoz

1. Nyissa meg a böngészőjét, majd írja be a Redmine domain nevét az címsorba. A Redmine bejelentkező képernyője megjelenik.

Redmine kezdő bejelentkező képernyő

2. Jelentkezzen be a Redmine szerverére az alapértelmezett hitelesítő adatokkal (felhasználónév: admin és jelszó: admin), majd amikor kérdezik, állítsa be az adminisztrátori fiók új jelszavát.

3. Végül állítsa be az adminisztrátori fiók beállításait, beleértve az e-mail címét és az időzónáját.

Gratulálunk! A Redmine készen áll!

Ha más módszereket szeretne felfedezni a Redmine telepítésére az Amazon Web Services (AWS) -en, tekintse meg a tutorial második részét.