Hvordan installere og konfigurere redmine på ubuntu 18.04

Redmine er et av de mest populære open source prosjektstyrings- og problemsporingsprogramvareverktøyene. 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.

Denne veiledningen beskriver hvordan du installerer og konfigurerer den nyeste versjonen av Redmine på en Ubuntu 18.04-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:

• Du har et domenenavn som peker til serverens offentlige IP. I denne opplæringen vil vi bruke example.com Du er logget inn som bruker med sudo-rettigheter. Du har Nginx installert ved å følge disse instruksjonene. Du har et SSL-sertifikat installert for domenet ditt. Du kan installere et gratis Let's Encrypt SSL-sertifikat ved å følge disse instruksjonene.

Opprette MySQL-database

Redmine støtter MySQL / MariaDB, Microsoft SQL Server, SQLite 3 og PostgreSQL. I denne opplæringen bruker vi MySQL som en database-back-end.

Logg inn på MySQL-skallet ved å skrive inn følgende kommando:

sudo mysql

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

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Deretter oppretter du en MySQL-brukerkonto og gir tilgang til databasen:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Forsikre deg om at du endrer change-with-strong-password med et sterkt passord.

Når du er ferdig, avslutter du mysql-konsollen ved å skrive:

EXIT;

Installere Ruby

Den enkleste måten å installere Ruby på Ubuntu-systemet ditt er gjennom apt package manager. I skrivende stund er versjonen i Ubuntu-depotene 2.5.1 som er den siste stabile versjonen av Ruby.

Installer Ruby ved å skrive:

sudo apt install ruby-full

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 du fulgte forutsetningene og installerte Nginx før du fortsetter med følgende trinn.

Start med å installere nødvendige pakker:

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

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

Når apt repository er aktivert, oppdaterer du pakkelisten og installerer Passenger Nginx-modulen med:

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

Installerer Redmine på Ubuntu

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

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

I skrivende stund denne artikkelen ble skrevet, er den siste stabile versjonen av Redmine versjon 4.0.0.

Før du fortsetter med neste trinn, bør du sjekke Redmine nedlastingsside for å se om en nyere versjon er tilgjengelig.

1. Laste ned Redmine

Last ned Redmine-arkivet med følgende krøllkommando:

sudo curl -L http://www.redmine.org/releases/redmine-4.0.0.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.0 /opt/redmine

2. Konfigurere Redmine-databasen

Start med å kopiere konfigurasjonsfilen til 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å Ubuntu-systemet. Du bør nå sjekke Redmine-dokumentasjonen og lære mer om hvordan du konfigurerer og bruker Redmine.

ubuntu redmine ruby ​​mysql nginx