Installation und Konfiguration von Redmine unter Debian 9

Redmine ist eine kostenlose Open-Source-Anwendung für Projektmanagement und Issue-Tracking. Es ist plattform- und datenbankübergreifend und basiert auf dem Ruby on Rails-Framework.

Redmine bietet Unterstützung für mehrere Projekte, Wikis, Problemverfolgungssysteme, Foren, Kalender, E-Mail-Benachrichtigungen und vieles mehr.

In diesem Tutorial zeigen wir Ihnen, wie Sie die neueste Version von Redmine auf einem Debian 9-Server mit MySQL als Datenbank-Backend und Passenger + Nginx als Ruby-Anwendungsserver installieren und konfigurieren.

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllt haben, bevor Sie mit diesem Lernprogramm fortfahren:

• Verfügen Sie über einen Domainnamen, der auf Ihre öffentliche IP-Adresse des Servers verweist. Wir verwenden example.com .Angemeldet als Benutzer mit sudo-Berechtigungen. Haben Sie Nginx installiert. Haben Sie ein SSL-Zertifikat für Ihre Domain installiert.

Erstellen einer MySQL-Datenbank

Redmine unterstützt MySQL / MariaDB, Microsoft SQL Server, SQLite 3 und PostgreSQL. Wir werden MariaDB als Datenbank-Backend verwenden. Stellen Sie sicher, dass mindestens MySQL 5.7 oder MariaDB 10.3 auf Ihrem Computer installiert ist.

Wenn MariaDB oder MySQL nicht auf Ihrem Debian-Server installiert ist, können Sie es mit diesen Anweisungen installieren.

Beginnen Sie mit der Anmeldung an der MySQL-Konsole, indem Sie Folgendes eingeben:

sudo mysql

Führen Sie die folgende SQL-Anweisung aus, um eine neue Datenbank zu erstellen:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Erstellen Sie ein neues MySQL-Benutzerkonto und gewähren Sie Zugriff auf die Datenbank:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Vergessen Sie nicht, change-with-strong-password durch ein sicheres Passwort zu ersetzen.

Sobald Sie fertig sind, melden Sie sich von der MariaDB-Konsole ab, indem Sie Folgendes eingeben:

EXIT;

Ruby installieren

Die einfachste Möglichkeit, Ruby unter Debian zu installieren, ist die Verwendung des apt Paketmanagers:

Installieren Sie Ruby, indem Sie Folgendes eingeben:

sudo apt install ruby-full

Zum Zeitpunkt des Schreibens ist die Version in den Debian-Repositories 2.3.3p222 die von der neuesten Version von Redmine unterstützt wird.

Passenger und Nginx installieren

Passenger ist ein schneller und leichter Webanwendungsserver für Ruby, Node.js und Python, der in Apache und Nginx integriert werden kann. Wir werden Passenger als Nginx-Modul installieren.

Stellen Sie sicher, dass Nginx installiert ist, bevor Sie mit den folgenden Schritten fortfahren.

Installieren der erforderlichen Pakete zum Aktivieren eines

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

Importieren Sie den Repository-GPG-Schlüssel und aktivieren Sie das Phusionpassenger-Repository:

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'

Aktualisieren Sie die Paketliste und installieren Sie das Passenger Nginx-Modul mit:

sudo apt update sudo apt install libnginx-mod-http-passenger

Redmine unter Debian installieren

Installieren Sie zunächst die zum Erstellen von Redmine erforderlichen Abhängigkeiten:

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

Zum Zeitpunkt des Schreibens dieses Artikels ist die neueste stabile Version von Redmine Version 4.0.4.

Bevor Sie mit dem nächsten Schritt fortfahren, sollten Sie auf der Redmine-Downloadseite nach einer neueren Version suchen.

1. Redmine herunterladen

Laden Sie das Redmine-Archiv mit dem folgenden Curl-Befehl herunter:

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

Sobald der Download abgeschlossen ist, extrahieren Sie das Archiv und verschieben Sie es in das Verzeichnis /opt :

cd /tmp sudo tar zxf /tmp/redmine.tar.gz sudo mv /tmp/redmine-4.0.4 /opt/redmine

2. Konfigurieren der Redmine-Datenbank

Kopieren Sie die Redmine-Beispielkonfigurationsdatei:

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

Öffnen Sie die Datei mit Ihrem Texteditor:

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

Suchen Sie nach dem production und geben Sie die zuvor erstellten MySQL-Datenbank- und Benutzerinformationen ein:

/opt/redmine/config/database.yml

production: adapter: mysql2 database: redmine host: localhost username: redmine password: "change-with-strong-password" encoding: utf8

Sobald Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

3. Installieren von Ruby-Abhängigkeiten

Navigieren Sie zum Redmine-Verzeichnis und installieren Sie Bundler und andere Ruby-Abhängigkeiten:

cd /opt/redmine/ sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite

4. Generieren Sie Schlüssel und migrieren Sie die Datenbank

Führen Sie den folgenden Befehl aus, um Schlüssel zu generieren und die Datenbank zu migrieren:

cd /opt/redmine/ sudo bundle exec rake generate_secret_token sudo RAILS_ENV=production bundle exec rake db:migrate

5. Stellen Sie die richtigen Berechtigungen ein

Nginx läuft als www-data Benutzer und Gruppe. Stellen Sie die richtigen Berechtigungen ein, indem Sie den folgenden Befehl chown eingeben:

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

Konfigurieren Sie Nginx

Inzwischen sollte Nginx mit SSL-Zertifikat bereits auf Ihrem System installiert sein, wenn Sie nicht die Voraussetzungen für dieses Lernprogramm prüfen.

Öffnen Sie Ihren Texteditor und erstellen Sie die folgende Nginx-Server-Blockdatei:

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

# Redirect HTTP -> HTTPS server { listen 80; server_name www.example.com example.com; include snippets/letsencrypt.conf; return 301 https://example.com$request_uri; } # Redirect 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 parameters 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; # log files 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; } Vergessen Sie nicht, example.com durch Ihre Redmine-Domain zu ersetzen und den richtigen Pfad zu den SSL-Zertifikatdateien festzulegen. Alle HTTP-Anforderungen werden an HTTPS umgeleitet. Die in dieser Konfiguration verwendeten Snippets werden in diesem Handbuch erstellt.

Aktivieren Sie den Serverblock, indem Sie einen symbolischen Link zum sites-enabled Verzeichnis erstellen:

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

Führen Sie vor dem Neustart des Nginx-Dienstes einen Test durch, um sicherzustellen, dass keine Syntaxfehler vorliegen:

sudo nginx -t

Wenn keine Fehler vorliegen, sollte die Ausgabe folgendermaßen aussehen:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful

Starten Sie schließlich den Nginx-Dienst neu, indem Sie Folgendes eingeben:

sudo systemctl restart nginx

Zugriff auf Redmine

Öffnen Sie Ihren Browser, geben Sie Ihre Domain ein und bei erfolgreicher Installation wird ein Bildschirm ähnlich dem folgenden angezeigt:

Sobald Sie das Passwort geändert haben, werden Sie zur Benutzerkontoseite weitergeleitet.

Fazit

Sie haben Redmine erfolgreich auf Ihrem Debian-System installiert. Sie sollten jetzt die Redmine-Dokumentation lesen und mehr über die Konfiguration und Verwendung von Redmine erfahren.

debian redmine ruby ​​mysql nginx