Installation und Konfiguration von Redmine unter Ubuntu 18.04

Redmine ist eines der beliebtesten Tools für Open Source-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.

Dieses Tutorial beschreibt die Installation und Konfiguration der neuesten Version von Redmine auf einem Ubuntu 18.04-Server mit MySQL als Datenbank-Backend und Passenger + Nginx als Ruby-Anwendungsserver.

Voraussetzungen

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

• Sie haben einen Domainnamen, der auf die öffentliche IP Ihres Servers verweist. In diesem Tutorial werden wir example.com Sie sind als Benutzer mit sudo-Berechtigungen angemeldet. Sie haben Nginx installiert, indem Sie diese Anweisungen befolgen. Sie haben ein SSL-Zertifikat für Ihre Domain installiert. Sie können ein kostenloses Let's Encrypt SSL-Zertifikat installieren, indem Sie diese Anweisungen befolgen.

MySQL-Datenbank erstellen

Redmine unterstützt MySQL / MariaDB, Microsoft SQL Server, SQLite 3 und PostgreSQL. In diesem Tutorial verwenden wir MySQL als Datenbank-Backend.

Melden Sie sich bei der MySQL-Shell an, indem Sie den folgenden Befehl eingeben:

sudo mysql

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

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Erstellen Sie als Nächstes ein MySQL-Benutzerkonto und gewähren Sie Zugriff auf die Datenbank:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Stellen Sie sicher, dass Sie change change-with-strong-password durch ein sicheres change-with-strong-password .

Wenn Sie fertig sind, verlassen Sie die MySQL-Konsole, indem Sie Folgendes eingeben:

EXIT;

Ruby installieren

Der einfachste Weg, Ruby auf Ihrem Ubuntu-System zu installieren, ist der apt package manager. Zum Zeitpunkt des Schreibens ist die Version in den Ubuntu-Repositories 2.5.1, die neueste stabile Version von Ruby.

Installieren Sie Ruby, indem Sie Folgendes eingeben:

sudo apt install ruby-full

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 Sie die Voraussetzungen erfüllt und Nginx installiert haben, bevor Sie mit den folgenden Schritten fortfahren.

Beginnen Sie mit der Installation der erforderlichen Pakete:

sudo apt install dirmngr gnupg apt-transport-https ca-certificates

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 bionic main'

Sobald das Apt-Repository aktiviert ist, aktualisieren Sie die Paketliste und installieren Sie das Passenger Nginx-Modul mit:

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

Redmine unter Ubuntu installieren

Wir beginnen mit der Installation der Abhängigkeiten, die zum Erstellen von Redmine erforderlich sind:

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

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

Bevor Sie mit dem nächsten Schritt fortfahren, sollten Sie auf der Redmine-Downloadseite nachsehen, ob eine neuere Version verfügbar ist.

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.0.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.0 /opt/redmine

2. Konfigurieren der Redmine-Datenbank

Beginnen Sie mit dem Kopieren der 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 Ubuntu-System installiert. Sie sollten jetzt die Redmine-Dokumentation lesen und mehr über die Konfiguration und Verwendung von Redmine erfahren.

Ubuntu Redmine Ruby MySQL Nginx