So installieren Sie das Redmine-Projektmanagement-Tool auf Ubuntu 22.04

Redmine ist ein kostenloses und Open-Source-Projektmanagement- und Issue-Tracking-Tool. Es ist eine webbasierte Anwendungssoftware, die hauptsächlich in Ruby on Rails geschrieben ist. Es ist plattformübergreifend und unterstützt mehrere Datenbanken und mehrere Sprachen.

Redmine ist flexibel und kann für verschiedene Arten von Organisationen und Projekten verwendet werden, von kleinen, mittleren oder großen Organisationen. Es ermöglicht Ihnen, mehrere Projekte zu erstellen und zu verwalten, wobei jedes Projekt über ein eigenes Wiki, Foren, Issue-Tracking usw. verfügt. Außerdem können Sie benutzerdefinierte Rollen basierend auf den Bedürfnissen Ihrer Organisation erstellen und vieles mehr.

Redmine wird unter der GNU GPL v2-Lizenz veröffentlicht und kann auf jedem Betriebssystem wie Linux, Windows oder macOS installiert werden. Es unterstützt verschiedene Arten von Datenbanken, einschließlich PostgreSQL, MySQL und SQLite (Standard).

In diesem Leitfaden installieren Sie Redmine mit dem Apache2-Webserver und dem MySQL-Server auf einem Ubuntu 22.04-Server. Sie sichern auch die Redmine-Installation mit SSL-Zertifikaten.

Voraussetzungen

Dieses Tutorial erfordert die folgenden Voraussetzungen:

• Ein Ubuntu 22.04-Server - Dieses Beispiel verwendet einen Ubuntu-Server mit dem Hostnamen redmine-server.
• Ein Nicht-Root-Benutzer mit Sudo-Root-Rechten - Sie können jedoch auch den Root-Benutzer verwenden.
• Ein Domainname, der auf die IP-Adresse Ihres Servers verweist - Für die Produktion müssen Sie sicherstellen, dass Ihr Domainname auf die IP-Adresse Ihres Servers verweist.

Sobald Sie alles eingerichtet haben, können Sie mit dem ersten Schritt der Redmine-Installation fortfahren.

Abhängigkeiten installieren

Redmine ist ein Open-Source-Projektmanagement- und Issue-Tracking-Tool, das hauptsächlich in Ruby und Ruby on Rails (RoR) geschrieben ist. Um Redmine zu installieren, müssen Sie zuerst Ruby installieren, dann können Sie andere Abhängigkeiten wie den Webserver Apache2 und die Datenbank mit dem MySQL-Server installieren.

In diesem Beispiel führen Sie Redmine mit dem Apache2-Webserver und dem MySQL-Server aus.

Bevor Sie mit der Installation von Paketen beginnen, führen Sie den folgenden apt-Befehl aus, um Ihr Ubuntu-Paket-Index zu aktualisieren und zu aktualisieren.

sudo apt update

Nachdem das Repository aktualisiert wurde, installieren Sie einige der folgenden Paketabhängigkeiten über den folgenden apt-Befehl.

Mit diesem Befehl installieren Sie den Apache2-Webserver, gefolgt von dem linapache2-mod-passenger, das verwendet wird, um die RoR-Anwendung einzurichten, damit sie unter Apache2 ausgeführt werden kann. Sie installieren auch Ruby-Pakete.

sudo apt install apache2 ruby ruby-dev build-essential libapache2-mod-passenger libmysqlclient-dev

Wenn Sie zur Bestätigung der Installation aufgefordert werden, geben Sie y ein und drücken Sie ENTER, um fortzufahren.

Nachdem Apache2 und Ruby installiert sind, führen Sie den folgenden Befehl aus, um den MySQL-Server zu installieren. Redmine unterstützt mehrere RDBMS wie PostgreSQL, MySQL/MariaDB und SQLite. In diesem Beispiel verwenden Sie den MySQL-Server.

sudo apt install mysql-server

Geben Sie y ein, wenn Sie zur Bestätigung der Installation aufgefordert werden, und drücken Sie dann ENTER, um fortzufahren.

Für die Redmine-Installation müssen Sie auch einen Bundler auf Ihrem Ubuntu-Server installieren. Bundler ist eine Befehlszeile, die verwendet wird, um Ruby Gems-Pakete zu verwalten.

Führen Sie den folgenden Befehl aus, um einen Bundler auf Ihrem System zu installieren.

sudo gem install bundler

Sobald der Bundler installiert ist, sehen Sie die Ausgabe wie folgt:

Überprüfen Sie zuletzt die Apache2- und MySQL-Dienste über den folgenden systemctl-Befehl. Dies stellt sicher, dass sowohl die Apache2- als auch die MariaDB-Dienste ausgeführt und aktiviert sind.

Überprüfen Sie den Apache2-Dienst.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Unten sehen Sie, dass der Apache2-Dienst aktiviert ist und automatisch beim Systemstart ausgeführt wird. Und der aktuelle Status des Dienstes ist aktiv.

Überprüfen Sie den MySQL-Dienst.

sudo systemctl is-enabled mysql  
sudo systemctl status mysql

Sie werden eine ähnliche Ausgabe wie folgt sehen - Der MySQL-Dienst ist aktiviert und wird automatisch beim Booten ausgeführt. Und der aktuelle Status des MySQL-Dienstes ist aktiv.

MySQL-Server konfigurieren

Nachdem Apache2 und der MySQL-Server installiert sind, richten Sie das MySQL-Root-Passwort ein und sichern die Bereitstellung über mysql_secure_installation. Dann erstellen Sie auch eine neue MySQL-Datenbank und einen Benutzer für Redmine.

Melden Sie sich über den folgenden mysql-Befehl bei MySQL an.

sudo mysql

Ändern Sie jetzt das MySQL-Root-Passwort über die folgende Abfrage. Und stellen Sie sicher, dass Sie das Passwort mit Ihrem Passwort ändern. Geben Sie dann quit ein, um die MySQL-Shell zu verlassen.

ALTER USER root@localhost IDENTIFIED WITH mysql_native_password BY 'password';  
quit

Führen Sie als Nächstes den folgenden Befehl aus, um die Bereitstellung des MySQL-Servers zu sichern.

sudo mysql_secure_installation

Wenn Sie zur Eingabe des MySQL-Root-Passworts aufgefordert werden, geben Sie Ihr korrektes Passwort ein.

Dann werden Sie nach anderen MySQL-Konfigurationen gefragt, z. B. das Deaktivieren des Remote-Logins für den Root-Benutzer, das Entfernen des anonymen Benutzers, das Entfernen der Standarddatenbank-Test und das Neuladen aller Tabellenberechtigungen. Für all diese MySQL-Servereinstellungen geben Sie Y ein, um die Konfiguration zu bestätigen.

Nachdem Sie die MySQL-Bereitstellung gesichert haben, ist es an der Zeit, eine neue Datenbank und einen Benutzer für Redmine einzurichten.

Melden Sie sich über den folgenden mysql-Befehl bei der MySQL-Shell an. Sie werden nach dem MySQL-Root-Passwort gefragt, geben Sie das korrekte Passwort für Ihren MySQL-Root-Benutzer ein und drücken Sie dann ENTER.

sudo mysql -u root -p

Führen Sie jetzt die folgenden Abfragen aus, um eine neue MySQL-Datenbank und einen Benutzer für Redmine zu erstellen. In diesem Beispiel erstellen Sie eine neue Datenbank und einen Benutzer redmine mit dem Passwort ‘secretPassword‘. Sie können das Datenbankpasswort durch Ihr Passwort ersetzen.

CREATE DATABASE redmine CHARACTER SET utf8mb4;  
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'secretPassword';  
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';  
FLUSH PRIVILEGES;

Führen Sie als Nächstes die folgenden Abfragen aus, um die Berechtigungen des MySQL-Benutzers redmine zu überprüfen. Stellen Sie sicher, dass der MySQL-Benutzer redmine Berechtigungen für die Datenbank redmine hat.

SHOW GRANTS FOR redmine@localhost;  
quit

Unten sehen Sie den MySQL-Benutzer redmine@localhost mit Berechtigungen für die Datenbank redmine.

Geben Sie zuletzt quit ein, um sich von der MySQL-Shell abzumelden.

Nachdem alle Abhängigkeiten installiert sind und die MySQL-Datenbank und der Benutzer erstellt wurden, sind Sie bereit, das Redmine-Projektmanagement-Tool auf Ihrem Ubuntu-Server zu installieren.

Redmine installieren

In diesem Schritt installieren Sie die neueste Version von Redmine. Zum Zeitpunkt des Schreibens ist die neueste Version von Redmine v5.0.2.

Sie werden den Quellcode von Redmine herunterladen, die Datenbank konfigurieren, Ruby-Abhängigkeiten über build installieren, das Redmine-Geheimtoken einrichten und die Datenbank migrieren.

In diesem Beispiel installieren Sie Redmine im Verzeichnis /opt/redmine.

Wechseln Sie in das Verzeichnis /opt.

cd /opt/

Laden Sie jetzt den Quellcode von Redmine mit dem folgenden wget-Befehl herunter. Nach dem Herunterladen sehen Sie die Datei redmine-5.0.2.tar.gz in Ihrem Verzeichnis /opt.

wget https://www.redmine.org/releases/redmine-5.0.2.tar.gz

Führen Sie als Nächstes den folgenden Befehl aus, um den Quellcode von Redmine redmine-5.0.2.tar.gz zu extrahieren und einen neuen symbolischen Link für das Redmine-Verzeichnis auf /opt/redmine zu erstellen.

tar -xvzf redmine-5.0.2.tar.gz  
sudo ln -s redmine-5.0.2 redmine

Das Hauptinstallationsverzeichnis von Redmine ist /opt/redmine.

Wechseln Sie in das Verzeichnis /opt/redmine.

cd /opt/redmine/

Kopieren Sie die Standarddatenbankkonfiguration ‘config/database.yml.example’ nach ‘config/database.yml’. Öffnen Sie dann die Datenbankkonfigurationsdatei ‘config/database.yml’ mit dem Nano-Editor.

cp config/database.yml.example config/database.yml  
nano config/database.yml

Ändern Sie im Abschnitt ‘production’ die Details der MySQL-Datenbank und des Benutzers. Stellen Sie sicher, dass Sie den richtigen Datenbankbenutzer und das Passwort für Redmine verwenden.

production:  
  adapter: mysql2  
  database: redmine  
  host: localhost  
  username: redmine  
  password: "secretPassword"   
  # Verwenden Sie "utf8" anstelle von "utfmb4" für MySQL vor 5.7.7  
  encoding: utf8mb4

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Führen Sie als Nächstes den folgenden Bundler-Befehl aus, um Ruby-Abhängigkeiten für die Redmine-Anwendung zu installieren.

bundle config set --local without 'development test'  
bundle install

Sie werden eine Ausgabe sehen, die der folgenden ähnlich ist:

Sobald die Redmine-Abhängigkeiten installiert sind, führen Sie den folgenden Befehl aus, um das Redmine-Geheimtoken zu generieren und die Datenbank zu migrieren.

bundle exec rake generate_secret_token  
RAILS_ENV=production bundle exec rake db:migrate

Im folgenden Screenshot sehen Sie, dass das Redmine-Geheimtoken generiert wurde und der Prozess der Redmine-Datenbankmigration.

Laden Sie zuletzt die Standarddaten in Ihre Redmine-Installation mit dem folgenden Befehl. Wenn Sie aufgefordert werden, die Sprache auszuwählen, geben Sie en für Englisch ein.

RAILS_ENV=production bundle exec rake redmine:load_default_data

Wenn die Standarddaten von Redmine geladen werden, sehen Sie die Ausgabemeldung „Standardkonfigurationsdaten geladen“.

Jetzt, da Redmine installiert ist, richten Sie als Nächstes einen Apache2-virtuellen Host für Redmine ein.

Virtuellen Host für Redmine einrichten

In diesem Schritt erstellen Sie eine neue Apache2-virtuelle Hostkonfiguration für Redmine. Stellen Sie sicher, dass Sie den Domainnamen haben, der auf die IP-Adresse Ihres Servers verweist, und dass SSL-Zertifikate generiert wurden.

Führen Sie den folgenden Befehl aus, um die Apache-Module ssl und rewrite zu aktivieren.

sudo a2enmod ssl rewrite

Sie werden eine Ausgabe wie folgt sehen:

Erstellen Sie jetzt eine neue Apache2-virtuelle Hostkonfiguration ‘/etc/apache2/sites-available/redmine.conf‘ mit dem Nano-Editor.

sudo nano /etc/apache2/sites-available/redmine.conf

Fügen Sie die folgende Konfiguration in die Datei ein. Stellen Sie sicher, dass Sie den Domainnamen und den Pfad der SSL-Zertifikate mit Ihrer Konfiguration ändern.

  
    ServerName redmine.howtoforge.local  
    ServerAdmin [email protected]  
    # Weiterleitungen an SSL  
    Redirect permanent "/" "https://redmine.howtoforge.local/"  
  
  
      
        ServerName redmine.howtoforge.local  
        RailsEnv production  
        DocumentRoot /opt/redmine/public  
        ErrorLog ${APACHE_LOG_DIR}/redmine.howtoforge.local.error.log  
        CustomLog ${APACHE_LOG_DIR}/redmine.howtoforge.local.access.log combined  
        SSLEngine on  
        SSLCertificateFile /etc/letsencrypt/live/redmine.howtoforge.local/fullchain.pem  
        SSLCertificateKeyFile /etc/letsencrypt/live/redmine.howtoforge.local/privkey.pem  
          
            Allow from all  
            Require all granted  
          
      

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie als Nächstes den folgenden Befehl aus, um die virtuelle Hostdatei ‘redmine.conf‘ zu aktivieren. Überprüfen Sie dann Ihre Apache2-Konfiguration, um sicherzustellen, dass Sie die richtige Konfiguration haben.

sudo a2ensite redmine.conf  
sudo apachectl configtest

Sie erhalten jetzt die Ausgabemeldung wie „Syntax OK“, wenn Sie die richtigen Apache2-Konfigurationen haben.

Starten Sie zuletzt den Apache2-Dienst über den folgenden systemctl-Befehl neu, um die neue virtuelle Hostdatei anzuwenden.

sudo systemctl restart apache2

An diesem Punkt ist Redmine installiert und der virtuelle Host ist konfiguriert. Sie sollten jetzt auf Ihre Redmine-Installation über Ihren Domainnamen zugreifen können.

UFW-Firewall einrichten

In der Produktion sollten Sie die Firewall aktivieren. Für das Ubuntu-System können Sie die Standardfirewall UFW (Uncomplicated Firewall) verwenden.

Jetzt werden Sie UFW-Regeln hinzufügen, die die Standard-HTTP- und HTTPS-Dienste öffnen, damit Redmine von außerhalb des Netzwerks zugänglich ist.

Führen Sie den folgenden ufw-Befehl aus, um das Standardanwendungsprofil “OpenSSH“ zur UFW hinzuzufügen. Starten und aktivieren Sie dann die UFW-Firewall.

sudo ufw allow "OpenSSH"  
sudo ufw enable

Wenn Sie zur Bestätigung aufgefordert werden, geben Sie y ein, um den UFW-Firewalldienst zu starten und zu aktivieren.

Führen Sie als Nächstes den folgenden Befehl aus, um das Anwendungsprofil “Apache Full“ zur Firewall hinzuzufügen. Überprüfen Sie dann den UFW-Status über den folgenden Befehl.

sudo ufw allow "Apache Full"  
sudo ufw status

Sie sollten sehen, dass der UFW-Firewallstatus aktiv ist und die derzeit aktivierten Anwendungsprofile OpenSSH und “Apache Full“ sind. Dies öffnet den Standard-SSH-Port 22 und die HTTP- und HTTPS-Dienstports 80 und 443.

Redmine-Installation

Öffnen Sie den Webbrowser und besuchen Sie den Domainnamen Ihrer Redmine-Installation (d. h.: https://redmine.howtoforge.local/).

Sie werden jetzt die Standard-Homepage des Redmine-Projektmanagement- und Issue-Tracking-Tools sehen. Klicken Sie auf „Anmelden“, um sich beim Redmine-Administrations-Dashboard anzumelden.

Geben Sie den Standard-Redmine-Administrationsbenutzer und das Passwort „admin - admin“ ein.

Nachdem Sie sich angemeldet haben, werden Sie nun aufgefordert, das Standardpasswort für Redmine zu ändern. Geben Sie das neue Passwort für Ihre Redmine-Installation ein und klicken Sie auf „Übernehmen“.

Bearbeiten Sie zuletzt die Details Ihres Redmine-Administrationsbenutzers und klicken Sie auf „Speichern“, um die Konfigurationen anzuwenden. Sie haben jetzt die Grundlagen von Redmine konfiguriert.

Um ein neues Projekt hinzuzufügen, klicken Sie auf das Menü „Projekte“. Sie sollten in der Lage sein, Projekte in Ihrem Redmine zu erstellen, zu bearbeiten oder zu löschen.

Wenn Sie jetzt Konfigurationen zu Redmine hinzufügen möchten, klicken Sie auf das Menü „Verwaltung“. Damit können Sie weitere Benutzer hinzufügen, Gruppen einrichten, Rollen definieren, die Authentifizierung über eine Drittanbieteranwendung wie LDAP aktivieren und vieles mehr.

Fazit

In diesem Tutorial haben Sie das Redmine-Projektmanagement- und Issue-Tracking-Tool auf dem Ubuntu 22.04-Server installiert und konfiguriert. Sie haben auch die MariaDB-Datenbank und den Nginx-Webserver für Redmine konfiguriert. Darüber hinaus haben Sie die Redmine-Installation auch mit SSL-Zertifikaten gesichert.

Jetzt haben Sie Redmine auf Ihrem System installiert, Sie können Ihre Redmine-Installation erweitern, indem Sie einige zusätzliche Konfigurationen hinzufügen, wie z. B. die Integration von Redmine in Ihre aktuellen Infrastrukturen, wie das Hinzufügen von LDAP-Authentifizierungen und die Integration mit SCM wie SVN, Git und Mercurial. Außerdem können Sie Rollen gemäß Ihrer Organisation oder Ihres Unternehmens hinzufügen.