Hur man installerar och konfigurerar redmine på debian 9

Redmine är en kostnadsfri och öppen källkodsprogram för hantering och problemspårning. Det är korsplattform och korsdatabas och byggd ovanpå Ruby on Rails-ramverket.

Redmine inkluderar stöd för flera projekt, wikis, system för spårning av problem, forum, kalendrar, e-postmeddelanden och mycket mer.

I den här tutorialen visar vi dig hur du installerar och konfigurerar den senaste versionen av Redmine på en Debian 9-server med MySQL som databasbakgrund och Passenger + Nginx som en Ruby-applikationsserver.

förutsättningar

Se till att du har uppfyllt följande förutsättningar innan du fortsätter med denna handledning:

• Har ett domännamn som pekar på din server IP-adress. Vi kommer att använda exempel.com. Inloggad som användare med sudo-privilegier. Har Nginx installerat. Har ett SSL-certifikat installerat för din domän.

Skapa en MySQL-databas

Redmine stöder MySQL / MariaDB, Microsoft SQL Server, SQLite 3 och PostgreSQL. Vi kommer att använda MariaDB som en databasback-end. Se till att du har minst MySQL 5.7 eller MariaDB 10.3 installerat på din maskin.

Om MariaDB eller MySQL inte är installerat på din Debian-server kan du installera den med hjälp av dessa instruktioner.

Börja med att logga in på MySQL-konsolen genom att skriva:

sudo mysql

Kör följande SQL-sats för att skapa en ny databas:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Skapa ett nytt MySQL-användarkonto och ge åtkomst till databasen:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Glöm inte att ändra change-with-strong-password med ett starkt lösenord.

När du är klar loggar du ut från MariaDB-konsolen genom att skriva:

EXIT;

Installera Ruby

Det enklaste sättet att installera Ruby på Debian är genom att använda apt package manager:

Installera Ruby genom att skriva:

sudo apt install ruby-full

I skrivande stund är versionen i Debians förvar 2.3.3p222 som stöds av den senaste versionen av Redmine.

Installera Passenger och Nginx

Passenger är en snabb och lätt webbapplikationsserver för Ruby, Node.js och Python som kan integreras med Apache och Nginx. Vi kommer att installera Passenger som en Nginx-modul.

Se till att Nginx är installerad innan du fortsätter med följande steg.

Installera nödvändiga paket för att aktivera ett

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

Importera förvaret GPG-nyckel och aktivera Phusionpassenger-förvaret:

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'

Uppdatera paketlistan och installera Passenger Nginx-modulen med:

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

Installera Redmine på Debian

Börja med att installera de beroenden som krävs för att bygga Redmine:

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

Vid skrivandet av denna artikel är den senaste stabila versionen av Redmine version 4.0.4.

Innan du fortsätter med nästa steg bör du kontrollera nedladdningssidan Redmine till för en nyare version.

1. Nedladdning av Redmine

Ladda ner Redmine-arkivet med följande curl-kommando:

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

När nedladdningen är klar extrahera arkivet och flytta det till katalogen /opt :

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

2. Konfigurera Redmine-databas

Kopiera konfigurationsfilen Redmine som exempel:

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

Öppna filen med din textredigerare:

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

Sök efter production och ange MySQL-databasen och användarinformation som vi skapade tidigare:

/opt/redmine/config/database.yml

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

När du är klar sparar du filen och lämnar redigeraren.

3. Installera Ruby-beroenden

Navigera till redmine-katalogen och installera paket och andra Ruby-beroenden:

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

4. Generera nycklar och migrera databasen

Kör följande kommando för att generera nycklar och migrera databasen:

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

5. Ställ in rätt behörigheter

Nginx körs som www-data datanvändare och grupp. Ställ in rätt behörigheter genom att utfärda följande chown-kommando:

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

Konfigurera Nginx

Nu bör du redan ha Nginx med SSL-certifikat installerat på ditt system, om inte kontrollera förutsättningarna för denna handledning.

Öppna din textredigerare och skapa följande Nginx-serverblockfil:

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; } Glöm inte att ersätta example.com med din Redmine-domän och ange rätt sökväg till SSL-certifikatfilerna. Alla HTTP-förfrågningar kommer att omdirigeras till HTTPS. De utdrag som används i den här konfigurationen skapas i den här guiden.

Aktivera serverblocket genom att skapa en symbolisk länk till den sites-enabled katalogen:

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

Innan du startar om Nginx-tjänsten, gör ett test för att vara säker på att det inte finns några syntaxfel:

sudo nginx -t

Om det inte finns några fel, bör utgången se ut så här:

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

Slutligen, starta om Nginx-tjänsten genom att skriva:

sudo systemctl restart nginx

Åtkomst till Redmine

Öppna din webbläsare, skriv din domän och förutsatt att installationen lyckas visas en skärm som liknar följande:

När du har ändrat lösenordet omdirigeras du till användarkontosidan.

Slutsats

Du har installerat Redmine på ditt Debian-system. Du bör nu kontrollera Redmine-dokumentationen och lära dig mer om hur du konfigurerar och använder Redmine.

debian redmine ruby ​​mysql nginx