Jak nainstalovat a nakonfigurovat redmine na Ubuntu 18.04

Redmine je jedním z nejpopulárnějších softwarových nástrojů pro správu projektů s otevřeným zdrojovým kódem a pro sledování problémů. Jedná se o platformu napříč platformami a databáze napříč databázemi a je postavena na horní části rámce Ruby on Rails.

Redmine zahrnuje podporu pro více projektů, wiki, systém pro sledování problémů, fóra, kalendáře, e-mailová oznámení a mnoho dalšího.

Tento tutoriál popisuje, jak nainstalovat a konfigurovat nejnovější verzi Redmine na serveru Ubuntu 18.04 pomocí MySQL jako databázového backendu a Passenger + Nginx jako aplikačního serveru Ruby.

Předpoklady

Před pokračováním v tomto kurzu se ujistěte, že jste splnili následující předpoklady:

• Máte název domény směřující na veřejnou IP adresu vašeho serveru. V tomto tutoriálu použijeme example.com . Jste přihlášeni jako uživatel s právy sudo. Nginx máte nainstalován podle těchto pokynů. Máte nainstalovaný certifikát SSL pro vaši doménu. Podle těchto pokynů si můžete nainstalovat bezplatný certifikát šifrování SSL.

Vytvoření databáze MySQL

Redmine podporuje MySQL / MariaDB, Microsoft SQL Server, SQLite 3 a PostgreSQL. V tomto tutoriálu použijeme MySQL jako databázové back-end.

Přihlaste se k shellu MySQL zadáním následujícího příkazu:

sudo mysql

Z prostředí prostředí MySQL spusťte následující příkaz SQL a vytvořte novou databázi:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Dále vytvořte uživatelský účet MySQL a udělte přístup k databázi:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Nezapomeňte změnit change-with-strong-password se silným heslem se silným heslem.

Po dokončení ukončete konzolu mysql zadáním:

EXIT;

Instalace Ruby

Nejjednodušší způsob, jak nainstalovat Ruby do vašeho systému Ubuntu, je přes správce balíků apt . V době psaní je verze v úložištích Ubuntu 2.5.1, což je nejnovější stabilní verze Ruby.

Nainstalujte Ruby zadáním:

sudo apt install ruby-full

Instalace cestujících a Nginx

Passenger je rychlý a lehký webový aplikační server pro Ruby, Node.js a Python, který lze integrovat do Apache a Nginx. Nainstalujeme Passenger jako modul Nginx.

Před pokračováním v následujících krocích se ujistěte, že jste splnili předpoklady a nainstalovali Nginx.

Začněte instalací potřebných balíčků:

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

Importujte klíč GPG úložiště a aktivujte úložiště Phusionpassenger:

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'

Jakmile je úložiště apt povoleno, aktualizujte seznam balíčků a nainstalujte modul Passenger Nginx pomocí:

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

Instalace Redmine na Ubuntu

Začneme instalací závislostí nezbytných pro sestavení Redmine:

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

V době psaní tohoto článku je nejnovější stabilní verze Redmine verze 4.0.0.

Před pokračováním v dalším kroku byste měli zkontrolovat stránku stahování Redmine a zjistit, zda je k dispozici novější verze.

1. Stahování Redmine

Stáhněte si archiv Redmine pomocí následujícího příkazu curl:

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

Po dokončení stahování rozbalte archiv a přesuňte jej do adresáře /opt :

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

2. Konfigurace databáze Redmine

Začněte kopírováním vzorového konfiguračního souboru Redmine:

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

Otevřete soubor pomocí textového editoru:

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

Vyhledejte production sekci a zadejte MySQL databázi a uživatelské informace, které jsme dříve vytvořili:

/opt/redmine/config/database.yml

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

Po dokončení soubor uložte a ukončete editor.

3. Instalace závislostí Ruby

Přejděte do adresáře redmine a nainstalujte balíček a další závislosti Ruby:

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

4. Generujte klíče a migrujte databázi

Spusťte následující příkaz pro vygenerování klíčů a migraci databáze:

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

5. Nastavte správná oprávnění

Nginx běží jako uživatel a skupina www-data . Nastavte správná oprávnění zadáním následujícího příkazu chown:

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

Nakonfigurujte Nginx

V tuto chvíli byste již měli mít nainstalovaný Nginx s certifikátem SSL ve vašem systému, pokud ne, zkontrolujte předpoklady pro tento tutoriál.

Otevřete textový editor a vytvořte následující soubor bloku serveru Nginx:

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; } Nezapomeňte nahradit doménu example.com vaší doménou Redmine a nastavit správnou cestu k souborům certifikátů SSL. Všechny požadavky HTTP budou přesměrovány na HTTPS. Úryvky použité v této konfiguraci jsou vytvořeny v této příručce.

Povolte blok serveru vytvořením symbolického odkazu na adresář s sites-enabled :

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

Před restartováním služby Nginx proveďte test, abyste se ujistili, že neexistují žádné chyby syntaxe:

sudo nginx -t

Pokud neexistují žádné chyby, výstup by měl vypadat takto:

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

Nakonec restartujte službu Nginx zadáním:

sudo systemctl restart nginx

Přístup k Redmine

Otevřete prohlížeč, zadejte svou doménu a za předpokladu, že je instalace úspěšná, objeví se obrazovka podobná následující:

Jakmile změníte heslo, budete přesměrováni na stránku uživatelského účtu.

Závěr

Úspěšně jste nainstalovali Redmine do vašeho systému Ubuntu. Nyní byste měli zkontrolovat dokumentaci Redmine a dozvědět se více o tom, jak konfigurovat a používat Redmine.

ubuntu redmine ruby ​​mysql nginx