So installieren Sie Redmine unter CentOS 7

• Voraussetzungen
• Installieren Sie Apache
• Installieren Sie PostgreSQL
• Installieren Sie Ruby
• Passagier installieren
• Installieren Sie Redmine
• Konfigurieren Sie Apache
• Sichern von Apache mit Let's Encrypt SSL

Redmine ist ein kostenloses und webbasiertes Open Source-Projektmanagement-Tool. Es ist in Ruby on Rails geschrieben und unterstützt mehrere Datenbankserver zum Speichern der Datenbank. Es ist eine funktionsreiche Anwendung, die mehrere Projekte, eine rollenbasierte ACL und ein Problemverfolgungssystem unterstützt. Es bietet außerdem Unterstützung für Gantt-Diagramme und -Kalender, Dateiverwaltung, Wiki und Forum pro Projekt sowie viele andere Funktionen. Es unterstützt Versionskontrollsysteme wie Git, SVN oder CVS. Es ist auch mehrsprachig und unterstützt bis zu 49 Sprachen.

Dieses Handbuch wurde für Redmine 3.4.4 geschrieben, gilt jedoch möglicherweise auch für neuere Versionen.

Voraussetzungen

• Eine Vultr CentOS 7-Serverinstanz.
• Ein Sudo-Benutzer .
• Ein Domainname zeigte auf den Server.

In diesem Tutorial verwenden wir 192.168.1.1als öffentliche IP-Adresse und redmine.example.comals Domainnamen, der auf die Vultr-Instanz verweist. Stellen Sie sicher, dass alle Vorkommen des Beispieldomänennamens und der IP-Adresse durch die tatsächliche ersetzt werden.

Aktualisieren Sie Ihr Basissystem mithilfe der Anleitung zum Aktualisieren von CentOS 7 . Fahren Sie nach der Aktualisierung Ihres Systems mit der Installation der Abhängigkeiten fort.

Installieren Sie Apache

Redmine ist in Ruby on Rails geschrieben, daher muss Phusion Passenger in den Apache-Webserver integriert werden, um die Anwendung bereitzustellen. Installieren Sie Apache.

sudo yum -y install httpd httpd-devel libcurl-devel

Um die Redmine-Anwendung zu erstellen, benötigen wir auch einige Entwicklungstools. Installieren Sie die erforderlichen Werkzeuge.

sudo yum -y install ImageMagick ImageMagick-devel git libxml2-devel libxslt-devel gcc bzip2 openssl-devel zlib-devel gdbm-devel ncurses-devel autoconf automake bison gcc-c++ libffi-devel libtool patch readline-devel sqlite-devel glibc-headers glibc-devel libyaml-devel libicu-devel libidn-devel

Installieren Sie PostgreSQL

Redmine unterstützt mehrere Arten von Datenbankservern wie MySQL, PostgreSQL und MSSQL. In diesem Tutorial verwenden wir PostgreSQL, um den Redmine-Datenbankserver zu hosten.

PostgreSQL ist ein objektrelationales Datenbanksystem. Das Standard- yumRepository enthält eine alte Version von PostgreSQL. Fügen Sie daher das PostgreSQL-Repository zum System hinzu.

sudo yum -y install https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-7-x86_64/pgdg-centos10-10-1.noarch.rpm

Installieren Sie den PostgreSQL-Datenbankserver.

sudo yum -y install postgresql10-server postgresql10-contrib postgresql10 

Initialisieren Sie die Datenbank.

sudo /usr/pgsql-10/bin/postgresql-10-setup initdb

Starten Sie den PostgreSQL-Server und aktivieren Sie ihn beim Start automatisch.

sudo systemctl start postgresql-10
sudo systemctl enable postgresql-10

Ändern Sie das Kennwort für den Standardbenutzer von PostgreSQL.

sudo passwd postgres

Melden Sie sich als PostgreSQL-Benutzer an.

sudo su - postgres

Erstellen Sie einen neuen PostgreSQL-Benutzer für Redmine.

createuser redmine

Sie dürfen stattdessen einen beliebigen Benutzernamen verwenden redmine. PostgreSQL bietet die psqlShell zum Ausführen von Abfragen in der Datenbank. Wechseln Sie zur PostgreSQL-Shell.

psql

Legen Sie ein Kennwort für den neu erstellten Benutzer für die Redmine-Datenbank fest.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

Durch DBPasswordein sicheres Passwort ersetzen . Erstellen Sie eine neue Datenbank für die Redmine-Installation.

CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

Verlasse die psqlShell.

\q

Wechseln Sie zum sudoBenutzer.

exit

Bearbeiten Sie die pg_hba.confDatei, um die MD5-basierte Authentifizierung zu aktivieren.

sudo nano /var/lib/pgsql/10/data/pg_hba.conf

Finden Sie die folgenden Zeilen und die Werte ändern peerund identin der METHODSpalte trustund md5jeweils.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    all             all             ::1/128                 ident

Nach der Aktualisierung sollte die Konfiguration folgendermaßen aussehen.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5

Starten Sie PostgreSQL neu, damit die Änderungen wirksam werden.

sudo systemctl restart postgresql-10

Installieren Sie einige weitere erforderliche PostgreSQL-Abhängigkeiten.

sudo yum -y install libpqxx-devel protobuf-devel

Installieren Sie Ruby

Es wird empfohlen, einen nicht privilegierten Benutzer zum Ausführen der Anwendung zu verwenden, um sie vom Rest des Systems isoliert zu halten. Erstellen Sie einen neuen Benutzer für Redmine und wechseln Sie zum neu erstellten Benutzer.

sudo adduser redmine
sudo su - redmine

Wir werden die neueste Version von Ruby mit Ruby Version Manager oder RVM installieren. Es wird verwendet, um mehrere Versionen von Ruby zu installieren und zu verwalten.

Fügen Sie den GPG-Schlüssel von RVM zu Ihrem Server hinzu.

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Installieren Sie RVM.

curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

Rufen Sie die Liste der verfügbaren Versionen von Ruby ab.

rvm list known

Sie sehen eine lange Liste von Ruby-Versionen.

[redmine@vultr ~]$ rvm list known
# MRI Rubies

[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.7]
[ruby-]2.3[.4]
[ruby-]2.4[.1]
ruby-head

...

Installieren Sie die neueste Version von Ruby aus der Liste.

rvm install 2.4

Verwenden Sie die installierte Version von Ruby.

rvm use 2.4

Sie können die Version überprüfen.

ruby -v

Sie sehen eine ähnliche Ausgabe.

[redmine@vultr ~]$ ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]

Installieren Sie den Bundler, den Abhängigkeitsmanager für die Ruby-Anwendung.

gem install bundler

Ruby ist jetzt installiert. Bevor wir Redmine installieren, müssen wir Phusion Passenger installieren.

Passagier installieren

Führen Sie den folgenden Befehl aus, um Passenger zu installieren.

gem install passenger

Geben Sie dem Basisverzeichnis des redmineBenutzers die Ausführungsberechtigung . Der Passagier muss die Binärdateien ausführen, um die Anwendung bedienen zu können.

chmod o+x "/home/redmine"

Installieren Sie das Apache-Modul für Passagiere.

passenger-install-apache2-module

Das Installationsskript stellt Ihnen einige Fragen. Zunächst erhalten Sie Informationen zum Installationsprozess. Anschließend werden Sie aufgefordert, die Sprache auszuwählen, die Sie verwenden möchten. Da unsere Anwendung in Ruby on Rails geschrieben ist, wählen Sie Ruby aus dem Menü und drücken Sie " Enter", um fortzufahren.

Which languages are you interested in?

Use <space> to select.
If the menu doesn't display correctly, press '!'

 ‣ ⬢  Ruby
   ⬡  Python
   ⬡  Node.js
   ⬡  Meteor

Das Installationsprogramm prüft nun die Anforderungen. Das Installationsprogramm stellt keine fehlenden Abhängigkeiten fest und fährt automatisch mit dem Kompilieren und Installieren des Moduls fort.

Sobald das Modul installiert ist, werden Sie aufgefordert, das Modul zur Apache-Konfigurationsdatei hinzuzufügen.

Almost there!

Please edit your Apache configuration file, and add these lines:

   LoadModule passenger_module /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so
   <IfModule mod_passenger.c>
     PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
     PassengerDefaultRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
   </IfModule>

After you restart Apache, you are ready to deploy any number of web
applications on Apache, with a minimum amount of configuration!

Press ENTER when you are done editing.

Wir werden dies vorerst überspringen und später im Tutorial abschließen, da der Benutzer, mit dem wir jetzt angemeldet sind, keine sudoBerechtigungen hat. Drücken Sie " Enter", um diesen Schritt zu überspringen.

Schließlich überprüft das Installationsskript die Installation und es wird eine Warnung angezeigt, dass das Passagiermodul in der Apache-Konfiguration nicht angegeben ist.

Validating installation...

 * Checking whether this Passenger install is in PATH... ✓
 * Checking whether there are no other Passenger installations... ✓
 * Checking whether Apache is installed... ✓
 * Checking whether the Passenger module is correctly configured in Apache... (!)

   You did not specify 'LoadModule passenger_module' in any of your Apache
   configuration files. Please paste the configuration snippet that this
   installer printed earlier, into one of your Apache configuration files, such
   as /etc/httpd/conf/httpd.conf.


Detected 0 error(s), 1 warning(s).
Press ENTER to continue.

Nachdem wir das Passenger-Modul für Apache installiert haben, können Sie Redmine herunterladen und installieren.

Installieren Sie Redmine

Laden Sie die neueste Version von Redmine von der offiziellen Redmine-Download-Seite herunter .

cd ~
wget http://www.redmine.org/releases/redmine-3.4.4.tar.gz

Extrahieren Sie das Archiv und benennen Sie das Verzeichnis der Einfachheit halber um.

tar -xf redmine-*.tar.gz
mv redmine-*/ redmine/

Kopieren Sie die Beispielkonfigurationsdateien an ihren Produktionsstandort.

cd redmine
cp config/configuration.yml.example config/configuration.yml
cp config/database.yml.example config/database.yml

Öffnen Sie die soeben kopierte Datenbankkonfigurationsdatei, um die Datenbankdetails einzugeben.

nano config/database.yml

Standardmäßig ist die Datenbankdatei für MySQL konfiguriert. Suchen Sie die Konfigurationen für Produktion und Entwicklung und testen Sie, welcher den MySQL-Adapter verwendet. Kommentieren Sie alle diese Zeilen aus.

#production:
#  adapter: mysql2
#  database: redmine
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

#development:
#  adapter: mysql2
#  database: redmine_development
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

#test:
#  adapter: mysql2
#  database: redmine_test
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

Suchen Sie außerdem die kommentierten Zeilen mit der productionKonfiguration für den postgresqlAdapter. Kommentieren Sie diese Zeilen aus und aktualisieren Sie den Datenbanknamen und die Benutzeranmeldeinformationen. Stellen Sie sicher, dass Sie die richtige Einrückung verwenden, dh zwei Leerzeichen.

production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: "DBPassword"

Konfigurieren Sie die Anwendung für die Verwendung der PostgreSQL-Konfiguration.

bundle config build.pg --with-pg-config=/usr/pgsql-10/bin/pg_config

Installieren Sie die für die Anwendung erforderlichen Anwendungsabhängigkeiten.

bundle install --without development test

Am Ende der Installation wird die folgende Meldung angezeigt.

Installing roadie-rails 1.1.1
Bundle complete! 31 Gemfile dependencies, 55 gems now installed.
Gems in the groups development and test were not installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.

Der folgende Befehl generiert geheime Token, die zum Codieren der Sitzungsdaten verwendet werden.

bundle exec rake generate_secret_token

Schreiben Sie die PostgreSQL-Datenbank.

RAILS_ENV=production bundle exec rake db:migrate

Führen Sie den folgenden Befehl aus, der die Standarddaten in die PostgreSQL-Datenbank schreibt.

RAILS_ENV=production bundle exec rake redmine:load_default_data

Mit dem obigen Befehl werden Sie aufgefordert, die Standardsprache für die Anwendung auszuwählen. Die Standardauswahl ist Englisch. Wählen Sie nach Ihren Wünschen.

[redmine@vultr redmine]$ RAILS_ENV=production bundle exec rake redmine:load_default_data

Select language: ar, az, bg, bs, ca, cs, da, de, el, en, en-GB, es, es-PA, et, eu, fa, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mk, mn, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sq, sr, sr-YU, sv, th, tr, uk, vi, zh, zh-TW [en]
====================================
Default configuration data loaded.

Die Installation der Redmine-Anwendung ist nun abgeschlossen. Ändern Sie den Besitz und die Berechtigungen der Verzeichnisse und Dateien.

mkdir -p tmp tmp/pdf public/plugin_assets
chown -R redmine:redmine files log tmp public/plugin_assets
chmod -R 755 files log tmp public/plugin_assets

Wir haben alles konfiguriert, was wir vom nicht privilegierten Benutzer benötigen. Wechseln Sie sudodurch Ausführen zurück zum Benutzer su - <username>.

Konfigurieren Sie Apache

Fügen Sie das Passagiermodul für Apache zur Apache-Konfigurationsdatei hinzu. Dadurch wird das Passagiermodul automatisch geladen.

echo "LoadModule passenger_module /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so" | sudo tee -a /etc/httpd/conf.modules.d/00-base.conf

Erstellen Sie eine neue virtuelle Hostdatei für Ihre Redmine-Anwendung.

sudo nano /etc/httpd/conf.d/redmine.conf

Füllen Sie die Datei mit dem folgenden Inhalt.

<VirtualHost *:80>
    ServerName redmine.example.com

    DocumentRoot /home/redmine/redmine/public

    PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
    PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
    PassengerUser redmine

    <Directory /home/redmine/redmine/public>
      Allow from all
      Options -MultiViews
      Require all granted
    </Directory>
</VirtualHost>

Stellen Sie sicher, dass Sie redmine.example.comdurch Ihren tatsächlichen Domainnamen ersetzen . Stellen Sie außerdem sicher, dass der Pfad zu PassengerRootund PassengerRubykorrekt ist. Der Pfad zu den Binärdateien kann sich ändern, wenn Ruby oder Passenger neu veröffentlicht werden. Führen Sie den folgenden Befehl aus, um diese Pfade zu finden.

sudo su redmine -c "passenger-config about ruby-command"

Sie erhalten folgende Ausgabe.

[user@vultr ~]$ sudo su redmine -c "passenger-config about ruby-command"
passenger-config was invoked through the following Ruby interpreter:
  Command: /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  Version: ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]
  To use in Apache: PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  To use in Nginx : passenger_ruby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  To use with Standalone: /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/bin/passenger start

Starten Sie den Apache-Webserver neu, sobald die virtuelle Hostdatei erstellt wurde.

sudo systemctl restart httpd

Ändern Sie die Firewall-Konfiguration, um einen Port 80durch die Firewall zuzulassen .

sudo firewall-cmd --zone=public --add-service=http --permanent
sudo firewall-cmd --reload

Sie können jetzt auf Ihre Redmine-Oberfläche zugreifen http://redmine.example.com. Melden Sie sich mit Benutzername adminund Passwort an admin. Bei Ihrer ersten Anmeldung werden Sie von Redmine aufgefordert, das Kennwort zu aktualisieren.

Sichern von Apache mit Let's Encrypt SSL

Da sich unsere Redmine-Installation auf einem öffentlich zugänglichen Server befindet, wird empfohlen, SSL zu verwenden, um den Datenaustausch vom Server zu sichern.

Installieren Sie Certbot, die Clientanwendung für Let's Encrypt CA.

sudo yum -y install epel-release
sudo yum -y install certbot mod_ssl

Bevor Sie die Zertifikate anfordern können, müssen Sie Port 80und / 443oder Standard HTTPund HTTPSDienste über die Firewall zulassen . Da wir den Port bereits 80früher zugelassen haben, lassen Sie uns den Port zulassen 443.

sudo firewall-cmd --zone=public --add-service=https --permanent
sudo firewall-cmd --reload

Hinweis: Um Zertifikate von Let's Encrypt CA zu erhalten, muss die Domäne, für die die Zertifikate generiert werden sollen, auf den Server gerichtet sein. Wenn nicht, nehmen Sie die erforderlichen Änderungen an den DNS-Einträgen der Domäne vor und warten Sie, bis sich der DNS verbreitet hat, bevor Sie die Zertifikatanforderung erneut stellen. Certbot überprüft die Domänenautorität, bevor die Zertifikate bereitgestellt werden.

Generieren Sie die SSL-Zertifikate.

sudo certbot certonly --webroot -w /home/redmine/redmine/public -d redmine.example.com

Die generierten Zertifikate werden wahrscheinlich in gespeichert /etc/letsencrypt/live/redmine.example.com/. Das SSL-Zertifikat wird als cert.pemund der private Schlüssel als gespeichert privkey.pem.

Lassen Sie uns Zertifikate verschlüsseln, die in 90 Tagen ablaufen. Daher wird empfohlen, die automatische Erneuerung der Zertifikate mithilfe von Cron-Jobs einzurichten.

Öffnen Sie die Cron-Jobdatei für den rootBenutzer.

sudo crontab -e

Fügen Sie am Ende der Datei die folgende Zeile hinzu.

30 5 * * * /usr/bin/certbot renew --quiet

Der oben genannte Cron-Job wird jeden Tag um 5:30 Uhr ausgeführt. Wenn das Zertifikat abläuft, wird es automatisch erneuert.

Bearbeiten Sie die zuvor für Redmine erstellte virtuelle Hostdatei.

sudo nano /etc/httpd/conf.d/redmine.conf

Ändern Sie die virtuelle Hostdatei so, dass sie wie folgt aussieht.

<VirtualHost *:80>
    Redirect permanent / https://www.example.com/
    ServerName redmine.example.com
</VirtualHost>

<VirtualHost *:443>
    ServerAdmin [email protected]
    ServerName redmine.example.com
    DocumentRoot "/home/redmine/redmine/public"
    <Directory "/home/redmine/redmine/public">
        Options None
        Require all granted
    </Directory>
    PassengerAppEnv production
    PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
    PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
    PassengerUser redmine
    PassengerHighPerformance on

    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/redmine.example.com/cert.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/redmine.example.com/privkey.pem
    SSLCertificateChainFile /etc/letsencrypt/live/redmine.example.com/chain.pem

    SSLProtocol             all -SSLv2 -SSLv3
    SSLHonorCipherOrder     on
    SSLCipherSuite          ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS

    <IfModule headers_module>
        Header always edit Set-Cookie ^(.*)$ $1;HttpOnly;Secure
        Header always set Strict-Transport-Security "max-age=15768000; includeSubDomains"
    </IfModule>
</VirtualHost>

Speichern Sie die Datei und beenden Sie den Editor.

Starten Sie Apache neu, damit die Änderungen wirksam werden.

sudo systemctl restart httpd

Sie können jetzt über HTTPSauf Redmine zugreifen https://redmine.example.com.

Herzlichen Glückwunsch, Sie haben Redmine erfolgreich auf Ihrer CentOS 7-Instanz installiert. Beginnen Sie mit der Entwicklung Ihres Projekts, indem Sie Ihr Projekt erstellen oder importieren.