Sådan installeres og konfigureres redmine på debian 9

Redmine er et gratis og open source-projektstyrings- og problemsporingsprogram. 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.

I denne tutorial viser vi dig, hvordan du installerer og konfigurerer den nyeste version af Redmine på en Debian 9-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:

• Har et domænenavn, der peger på din server-offentlige IP. Vi bruger example.com Logget ind som en bruger med sudo-privilegier. Har Nginx installeret. Har et SSL-certifikat installeret til dit domæne.

Oprettelse af en MySQL-database

Redmine understøtter MySQL / MariaDB, Microsoft SQL Server, SQLite 3 og PostgreSQL. Vi bruger MariaDB som en database back-end. Sørg for, at du mindst har MySQL 5.7 eller MariaDB 10.3 installeret på din maskine.

Hvis MariaDB eller MySQL ikke er installeret på din Debian-server, kan du installere den ved hjælp af disse instruktioner.

Start med at logge ind på MySQL-konsollen ved at skrive:

sudo mysql

Kør følgende SQL-sætning for at oprette en ny database:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Opret en ny MySQL brugerkonto og giver adgang til databasen:

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

Når det er gjort, skal du logge ud fra MariaDB-konsollen ved at skrive:

EXIT;

Installation af Ruby

Den nemmeste måde at installere Ruby på Debian er ved at bruge apt package manager:

Installer Ruby ved at skrive:

sudo apt install ruby-full

I skrivende stund er versionen i Debian- 2.3.3p222 som understøttes af den seneste version af Redmine.

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 Nginx er installeret, før du fortsætter med følgende trin.

Installation af de nødvendige pakker for at aktivere et

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

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

Opdater pakkelisten, og installer Passager Nginx-modulet med:

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

Installation af Redmine på Debian

Start med at installere de nødvendige afhængigheder for at bygge Redmine:

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

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

Før du fortsætter med det næste trin, skal du tjekke Redmine-downloadsiden til for en nyere version.

1. Download Redmine

Download Redmine-arkivet ved hjælp af følgende curl-kommando:

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

2. Konfiguration af Redmine-database

Kopier konfigurationsfilen 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 Debian-system. Du skal nu kontrollere Redmine-dokumentationen og lære mere om, hvordan du konfigurerer og bruger Redmine.

debian redmine ruby ​​mysql nginx