Hvordan installere og konfigurere redmine på debian 9

Redmine er et gratis og åpen kildekode-prosjektledelses- og problemsporingsapplikasjon. Det er plattform og tverrdatabase og bygget oppå Ruby on Rails-rammen.

Redmine inkluderer støtte for flere prosjekter, wikier, sporing av systemer, fora, kalendere, e-postvarsler og mye mer.

I denne opplæringen viser vi deg hvordan du installerer og konfigurerer den nyeste versjonen av Redmine på en Debian 9-server ved å bruke MySQL som en database-back-end og Passenger + Nginx som en Ruby-applikasjonsserver.

Forutsetninger

Forsikre deg om at du har oppfylt følgende forutsetninger før du fortsetter med denne opplæringen:

• Har et domenenavn som peker til serverens offentlige IP. Vi bruker example.com Innlogget som bruker med sudo-rettigheter. Har Nginx installert. Har et SSL-sertifikat installert for domenet ditt.

Opprette en MySQL-database

Redmine støtter MySQL / MariaDB, Microsoft SQL Server, SQLite 3 og PostgreSQL. Vi bruker MariaDB som en database-back-end. Forsikre deg om at du har minst MySQL 5.7 eller MariaDB 10.3 installert på maskinen din.

Hvis MariaDB eller MySQL ikke er installert på Debian-serveren, kan du installere den ved å bruke disse instruksjonene.

Begynn med å logge på MySQL-konsollen ved å skrive:

sudo mysql

Kjør følgende SQL-setning for å opprette en ny database:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Opprett en ny MySQL-brukerkonto og gi tilgang til databasen:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Ikke glem å endre change-with-strong-password med et sterkt passord.

Når du er ferdig, kan du logge ut fra MariaDB-konsollen ved å skrive:

EXIT;

Installere Ruby

Den enkleste måten å installere Ruby på Debian er ved å bruke apt package manager:

Installer Ruby ved å skrive:

sudo apt install ruby-full

I skrivende stund er versjonen i Debian-depot 2.3.3p222 som støttes av den siste versjonen av Redmine.

Installere Passenger og Nginx

Passenger er en rask og lett webapplikasjonsserver for Ruby, Node.js og Python som kan integreres med Apache og Nginx. Vi vil installere Passenger som en Nginx-modul.

Forsikre deg om at Nginx er installert før du fortsetter med følgende trinn.

Installere nødvendige pakker for å aktivere et

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

Importer repository GPG-nøkkelen og aktiver 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'

Oppdater pakkelisten og installer Passenger Nginx-modulen med:

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

Installerer Redmine på Debian

Start med å installere avhengighetene som er nødvendige for å bygge Redmine:

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

Når jeg skriver denne artikkelen, er den siste stabile versjonen av Redmine versjon 4.0.4.

Før du fortsetter med neste trinn, bør du sjekke Redmine nedlastingsside for å finne en nyere versjon.

1. Laste ned Redmine

Last ned Redmine-arkivet ved hjelp av følgende krøllkommando:

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

Når nedlastingen er fullført, pakker du ut arkivet og flytter det til /opt katalogen:

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

2. Konfigurere Redmine-databasen

Kopier konfigurasjonsfilen Redmine eksempel:

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

Åpne filen med tekstredigereren:

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

Søk etter production og skriv inn MySQL-databasen og brukerinformasjonen vi opprettet tidligere:

/opt/redmine/config/database.yml

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

Når du er ferdig, lagrer du filen og avslutter redigereren.

3. Installere Ruby-avhengigheter

Naviger til redmine-katalogen og installer pakker og andre Ruby-avhengigheter:

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

4. Generer nøkler og migrer databasen

Kjør følgende kommando for å generere nøkler og migrere databasen:

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

5. Angi riktig tillatelse

Nginx kjører som www-data bruker og gruppe. Angi riktig tillatelse ved å utstede følgende chown-kommando:

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

Konfigurer Nginx

Nå bør du allerede ha Nginx med SSL-sertifikat installert på systemet ditt, hvis ikke sjekk forutsetningene for denne opplæringen.

Åpne tekstredigeringsprogrammet og lag følgende Nginx-serverblokkfil:

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; } Ikke glem å erstatte eksempel.com med ditt Redmine-domene og angi riktig sti til SSL-sertifikatfilene. Alle HTTP-forespørsler blir omdirigert til HTTPS. Utdragene som brukes i denne konfigurasjonen, opprettes i denne guiden.

Aktiver serverblokken ved å opprette en symbolsk lenke til den sites-enabled katalogen:

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

Før du starter Nginx-tjenesten på nytt, må du utføre en test for å være sikker på at det ikke er syntaksfeil:

sudo nginx -t

Hvis det ikke er noen feil, skal utgangen se slik ut:

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

Til slutt, start Nginx-tjenesten på nytt ved å skrive:

sudo systemctl restart nginx

Få tilgang til Redmine

Åpne nettleseren din, skriv inn domenet ditt og antar at installasjonen er vellykket, vises en skjerm som ligner på følgende:

Når du har endret passordet, blir du omdirigert til brukerkontosiden.

Konklusjon

Du har installert Redmine på Debian-systemet. Du bør nå sjekke Redmine-dokumentasjonen og lære mer om hvordan du konfigurerer og bruker Redmine.

debian redmine ruby ​​mysql nginx