Hoe redmine te installeren en te configureren op ubuntu 18.04

Redmine is een van de meest populaire open source projectmanagement- en issue tracking-softwaretools. Het is platformoverschrijdend en cross-database en gebouwd bovenop het Ruby on Rails-framework.

Redmine biedt ondersteuning voor meerdere projecten, wiki's, het systeem voor het volgen van problemen, forums, agenda's, e-mailmeldingen en nog veel meer.

In deze zelfstudie wordt beschreven hoe u de nieuwste versie van Redmine installeert en configureert op een Ubuntu 18.04-server met MySQL als database-back-end en Passenger + Nginx als een Ruby-toepassingsserver.

voorwaarden

Zorg ervoor dat u aan de volgende voorwaarden hebt voldaan voordat u doorgaat met deze zelfstudie:

• U hebt een domeinnaam die verwijst naar het openbare IP-adres van uw server. In deze zelfstudie gebruiken we example.com . U bent aangemeld als een gebruiker met sudo-rechten. Nginx is geïnstalleerd door deze instructies te volgen. U hebt een SSL-certificaat geïnstalleerd voor uw domein. U kunt een gratis Let's Encrypt SSL-certificaat installeren door deze instructies te volgen.

MySQL-database maken

Redmine ondersteunt MySQL / MariaDB, Microsoft SQL Server, SQLite 3 en PostgreSQL. In deze tutorial gebruiken we MySQL als back-end van de database.

Meld u aan bij de MySQL-shell door de volgende opdracht te typen:

sudo mysql

Voer vanuit de MySQL-shell de volgende SQL-instructie uit om een ​​nieuwe database te maken:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Maak vervolgens een MySQL-gebruikersaccount en verleen toegang tot de database:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Zorg ervoor dat u change-with-strong-password met een sterk wachtwoord.

Als u klaar bent, verlaat u de mysql-console door te typen:

EXIT;

Ruby installeren

De eenvoudigste manier om Ruby op uw Ubuntu-systeem te installeren, is via de apt pakketbeheerder. Op het moment van schrijven is de versie in de Ubuntu-repositories 2.5.1, de nieuwste stabiele versie van Ruby.

Installeer Ruby door te typen:

sudo apt install ruby-full

Passagier en Nginx installeren

Passenger is een snelle en lichtgewicht webtoepassingsserver voor Ruby, Node.js en Python die kan worden geïntegreerd met Apache en Nginx. We zullen Passenger installeren als een Nginx-module.

Zorg ervoor dat u de vereisten hebt gevolgd en Nginx hebt geïnstalleerd voordat u doorgaat met de volgende stappen.

Begin met het installeren van de nodige pakketten:

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

Importeer de GPG-sleutel van de repository en schakel de Phusionpassenger-repository in:

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'

Zodra de apt-repository is ingeschakeld, werkt u de pakketlijst bij en installeert u de Passenger Nginx-module met:

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

Redmine installeren op Ubuntu

We beginnen met het installeren van de afhankelijkheden die nodig zijn om Redmine te bouwen:

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

Op het moment dat dit artikel werd geschreven, is versie 4.0.0 de nieuwste stabiele versie van Redmine.

Voordat u doorgaat met de volgende stap, moet u de downloadpagina van Redmine controleren om te zien of er een nieuwere versie beschikbaar is.

1. Redmine downloaden

Download het Redmine-archief met de volgende curl-opdracht:

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

Zodra de download is voltooid, pak het archief uit en verplaats het naar de map /opt :

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

2. Redmine-database configureren

Begin met het kopiëren van het Redmine-voorbeeldconfiguratiebestand:

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

Open het bestand met uw teksteditor:

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

Zoek naar de production en voer de MySQL-database en gebruikersinformatie in die we eerder hebben gemaakt:

/opt/redmine/config/database.yml

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

Sla het bestand op en verlaat de editor.

3. Ruby-afhankelijkheden installeren

Navigeer naar de redmine-map en installeer bundler en andere Ruby-afhankelijkheden:

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

4. Genereer sleutels en migreer de database

Voer de volgende opdracht uit om sleutels te genereren en de database te migreren:

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

5. Stel de juiste machtigingen in

Nginx draait als www-data gebruiker en groep. Stel de juiste machtigingen in door het volgende chown-commando te geven:

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

Configureer Nginx

U zou nu al Nginx met SSL-certificaat op uw systeem moeten hebben geïnstalleerd, zo niet, controleer dan de vereisten voor deze zelfstudie.

Open uw teksteditor en maak het volgende Nginx-serverblokbestand:

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; } Vergeet niet om example.com te vervangen door uw Redmine-domein en het juiste pad naar de SSL-certificaatbestanden in te stellen. Alle HTTP-aanvragen worden doorgestuurd naar HTTPS. De fragmenten die in deze configuratie worden gebruikt, worden in deze handleiding gemaakt.

Schakel het serverblok in door een symbolische koppeling te maken naar de directory met sites-enabled :

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

Voordat u de Nginx-service opnieuw start, moet u een test uitvoeren om er zeker van te zijn dat er geen syntaxisfouten zijn:

sudo nginx -t

Als er geen fouten zijn, ziet de uitvoer er als volgt uit:

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

Start ten slotte de Nginx-service opnieuw op door te typen:

sudo systemctl restart nginx

Toegang tot Redmine

Open uw browser, typ uw domein en ervan uitgaande dat de installatie is geslaagd, verschijnt een scherm zoals het volgende:

Nadat u het wachtwoord hebt gewijzigd, wordt u doorgestuurd naar de gebruikersaccountpagina.

Conclusie

U hebt Redmine met succes op uw Ubuntu-systeem geïnstalleerd. Raadpleeg nu de Redmine-documentatie en leer meer over het configureren en gebruiken van Redmine.

ubuntu redmine ruby ​​mysql nginx