Sådan installeres og konfigureres redmine på ubuntu 18.04

Redmine er et af de mest populære open source-projektstyrings- og problemsporingssoftwareværktøjer. Det er tværplatform og krydsdatabase og bygget oven på Ruby on Rails-rammen.

Redmine inkluderer support til flere projekter, wikier, emailsporingssystem, fora, kalendere, e-mail-meddelelser og meget mere.

Denne tutorial beskriver, hvordan du installerer og konfigurerer den nyeste version af Redmine på en Ubuntu 18.04-server ved hjælp af MySQL som en database-back-end og Passenger + Nginx som en Ruby-applikationsserver.

Forudsætninger

Sørg for, at du har opfyldt følgende forudsætninger, før du fortsætter med denne tutorial:

• Du har et domænenavn, der peger på din server-IP. I denne tutorial vil vi bruge example.com Du er logget ind som en bruger med sudo-privilegier. Du har Nginx installeret ved at følge disse instruktioner. Du har et SSL-certifikat installeret til dit domæne. Du kan installere et gratis Let's Encrypt SSL-certifikat ved at følge disse instruktioner.

Oprettelse af MySQL-database

Redmine understøtter MySQL / MariaDB, Microsoft SQL Server, SQLite 3 og PostgreSQL. I denne tutorial bruger vi MySQL som en database back-end.

Log ind på MySQL shell ved at skrive følgende kommando:

sudo mysql

Fra MySQL-shell skal du køre følgende SQL-sætning for at oprette en ny database:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Opret derefter en MySQL-brugerkonto og giver adgang til databasen:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Sørg for at ændre change-with-strong-password med en stærk adgangskode.

Når det er gjort, skal du afslutte mysql-konsollen ved at skrive:

EXIT;

Installation af Ruby

Den nemmeste måde at installere Ruby på dit Ubuntu-system er gennem apt package manager. I skrivende stund er versionen i Ubuntu-oplagrene 2.5.1, som er den seneste stabile version af Ruby.

Installer Ruby ved at skrive:

sudo apt install ruby-full

Installation af passager og Nginx

Passenger er en hurtig og let webapplikationsserver til Ruby, Node.js og Python, der kan integreres med Apache og Nginx. Vi installerer Passenger som et Nginx-modul.

Sørg for, at du fulgte forudsætningerne og installerede Nginx, før du fortsætter med følgende trin.

Start med at installere de nødvendige pakker:

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

Importer repository GPG-nøglen og aktiver Phusionpassenger-depotet:

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-arkivet er aktiveret, skal du opdatere pakkelisten og installere Passenger Nginx-modulet med:

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

Installation af Redmine på Ubuntu

Vi starter med at installere de afhængigheder, der er nødvendige for at oprette Redmine:

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

På dette tidspunkt, hvor denne artikel skrives, er den seneste stabile version af Redmine version 4.0.0.

Før du fortsætter med det næste trin, skal du tjekke Redmine-downloadsiden for at se, om en nyere version er tilgængelig.

1. Download Redmine

Download Redmine-arkivet med følgende curl-kommando:

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

Når overførslen er afsluttet, skal du arkivere arkivet og flytte det til /opt biblioteket:

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

2. Konfiguration af Redmine-database

Start med at kopiere konfigurationsfilen til Redmine-eksempel:

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

Åbn filen med din teksteditor:

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

Søg efter production , og indtast MySQL-databasen og brugeroplysninger, vi oprettede tidligere:

/opt/redmine/config/database.yml

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

Når det er gjort, skal du gemme filen og lukke redaktøren.

3. Installation af Ruby-afhængigheder

Naviger til redmine-kataloget, og installer bundler og andre Ruby-afhængigheder:

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

4. Generer nøgler og migrer databasen

Kør følgende kommando for at generere nøgler og migrere databasen:

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

5. Indstil de rigtige tilladelser

Nginx kører som www-data bruger og gruppe. Indstil de korrekte tilladelser ved at udstede følgende chown-kommando:

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

Konfigurer Nginx

I øjeblikket skulle du allerede have Nginx med SSL-certifikat installeret på dit system, hvis ikke kontrollere forudsætningerne for denne tutorial.

Åbn din teksteditor og opret følgende Nginx-serverblokfil:

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; } Glem ikke at erstatte eksempel.com med dit Redmine-domæne og indstille den rigtige sti til SSL-certifikatfiler. Alle HTTP-anmodninger vil blive omdirigeret til HTTPS. De kodestykker, der bruges i denne konfiguration, oprettes i denne vejledning.

Aktivér serverblokken ved at oprette et symbolsk link til det sites-enabled bibliotek:

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

Inden du genstarter Nginx-tjenesten, skal du foretage en test for at være sikker på, at der ikke er nogen syntaksfejl:

sudo nginx -t

Hvis der ikke er nogen fejl, skal output se sådan ud:

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

Endelig genstart Nginx-tjenesten ved at skrive:

sudo systemctl restart nginx

Adgang til Redmine

Åbn din browser, skriv dit domæne og antager, at installationen er vellykket, vises en skærm, der ligner følgende:

Når du har ændret adgangskoden, vil du blive omdirigeret til siden med brugerkonti.

Konklusion

Du har installeret Redmine på dit Ubuntu-system. Du skal nu kontrollere Redmine-dokumentationen og lære mere om, hvordan du konfigurerer og bruger Redmine.

ubuntu redmine ruby ​​mysql nginx