Hur man installerar och konfigurerar redmine på ubuntu 18.04

Redmine är ett av de mest populära verktygen för öppen källkod för projektledning och spårning av problem. 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.

Denna handledning beskriver hur du installerar och konfigurerar den senaste versionen av Redmine på en Ubuntu 18.04-server med MySQL som databasback-end 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:

• Du har ett domännamn som pekar på din server IP-adress. I den här tutorialen kommer vi att använda example.com Du är inloggad som användare med sudo-privilegier. Du har Nginx installerat genom att följa dessa instruktioner. Du har ett SSL-certifikat installerat för din domän. Du kan installera ett gratis Let's Encrypt SSL-certifikat genom att följa dessa instruktioner.

Skapa MySQL-databas

Redmine stöder MySQL / MariaDB, Microsoft SQL Server, SQLite 3 och PostgreSQL. I den här tutorialen använder vi MySQL som en databasback-end.

Logga in på MySQL-skalet genom att skriva följande kommando:

sudo mysql

Kör följande SQL-uttalande från MySQL-skalet för att skapa en ny databas:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

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

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Se till att du ändrar change-with-strong-password med ett starkt lösenord.

När du är klar, avsluta mysql-konsolen genom att skriva:

EXIT;

Installera Ruby

Det enklaste sättet att installera Ruby på ditt Ubuntu-system är genom apt package manager. I skrivande stund är versionen i Ubuntu-lagren 2.5.1 vilket är den senaste stabila versionen av Ruby.

Installera Ruby genom att skriva:

sudo apt install ruby-full

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 du följde förutsättningarna och installerade Nginx innan du fortsätter med följande steg.

Börja med att installera nödvändiga paket:

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

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

När apt-arkivet är aktiverat uppdaterar du paketlistan och installerar Passenger Nginx-modulen med:

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

Installera Redmine på Ubuntu

Vi börjar med att installera beroenden som krävs för att bygga Redmine:

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

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

Innan du fortsätter med nästa steg bör du kontrollera nedladdningssidan Redmine för att se om en nyare version är tillgänglig.

1. Nedladdning av Redmine

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

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

2. Konfigurera Redmine-databas

Börja med att kopiera konfigurationsfilen för Redmine-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 du 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 Ubuntu-system. Du bör nu kontrollera Redmine-dokumentationen och lära dig mer om hur du konfigurerar och använder Redmine.

ubuntu redmine ruby ​​mysql nginx