Jak zainstalować i skonfigurować Redmine na Ubuntu 18.04

Redmine jest jednym z najpopularniejszych narzędzi do zarządzania projektami i śledzenia problemów typu open source. Jest wieloplatformowy i między bazami danych i zbudowany na bazie Ruby on Rails.

Redmine obejmuje obsługę wielu projektów, stron wiki, systemu śledzenia problemów, forów, kalendarzy, powiadomień e-mail i wielu innych.

W tym samouczku opisano, jak zainstalować i skonfigurować najnowszą wersję Redmine na serwerze Ubuntu 18.04, używając MySQL jako zaplecza bazy danych, a Passenger + Nginx jako serwer aplikacji Ruby.

Wymagania wstępne

Przed kontynuowaniem tego samouczka upewnij się, że zostały spełnione następujące wymagania wstępne:

• Masz nazwę domeny wskazującą publiczny adres IP twojego serwera. W tym samouczku użyjemy example.com . Jesteś zalogowany jako użytkownik sudo. Masz Nginx zainstalowany zgodnie z tymi instrukcjami. Masz zainstalowany certyfikat SSL dla swojej domeny. Możesz zainstalować bezpłatny certyfikat Let's Encrypt SSL postępując zgodnie z tymi instrukcjami.

Tworzenie bazy danych MySQL

Redmine obsługuje MySQL / MariaDB, Microsoft SQL Server, SQLite 3 i PostgreSQL. W tym samouczku wykorzystamy MySQL jako zaplecze bazy danych.

Zaloguj się do powłoki MySQL, wpisując następujące polecenie:

sudo mysql

Z poziomu powłoki MySQL uruchom następującą instrukcję SQL, aby utworzyć nową bazę danych:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Następnie utwórz konto użytkownika MySQL i udziel dostępu do bazy danych:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Upewnij się, że zmienisz change-with-strong-password z silnym hasłem na silne hasło.

Po zakończeniu wyjdź z konsoli mysql, wpisując:

EXIT;

Instalowanie Ruby

Najłatwiejszym sposobem zainstalowania Ruby w systemie Ubuntu jest apt menedżera pakietów apt . W chwili pisania tego tekstu wersja w repozytoriach Ubuntu to 2.5.1, która jest najnowszą stabilną wersją Ruby.

Zainstaluj Ruby, wpisując:

sudo apt install ruby-full

Instalowanie programu Passenger i Nginx

Passenger to szybki i lekki serwer aplikacji WWW dla Ruby, Node.js i Python, który można zintegrować z Apache i Nginx. Zainstalujemy Passenger jako moduł Nginx.

Upewnij się, że postępowałeś zgodnie z warunkami wstępnymi i zainstalowałeś Nginx przed kontynuowaniem poniższych kroków.

Zacznij od zainstalowania niezbędnych pakietów:

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

Zaimportuj klucz GPG repozytorium i włącz repozytorium 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'

Po włączeniu repozytorium apt zaktualizuj listę pakietów i zainstaluj moduł Passenger Nginx za pomocą:

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

Instalowanie Redmine na Ubuntu

Zaczniemy od zainstalowania zależności niezbędnych do zbudowania Redmine:

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

W chwili pisania tego artykułu najnowszą stabilną wersją Redmine jest wersja 4.0.0.

Zanim przejdziesz do następnego kroku, sprawdź stronę pobierania Redmine, aby sprawdzić, czy dostępna jest nowsza wersja.

1. Pobieranie Redmine

Pobierz archiwum Redmine za pomocą następującego polecenia curl:

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

Po zakończeniu pobierania rozpakuj archiwum i przenieś je do katalogu /opt :

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

2. Konfiguracja bazy danych Redmine

Zacznij od skopiowania przykładowego pliku konfiguracyjnego Redmine:

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

Otwórz plik za pomocą edytora tekstu:

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

Wyszukaj sekcję production i wprowadź bazę danych MySQL oraz informacje o użytkowniku, które wcześniej utworzyliśmy:

/opt/redmine/config/database.yml

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

Po zakończeniu zapisz plik i zamknij edytor.

3. Instalowanie zależności Ruby

Przejdź do katalogu redmine i zainstaluj bundler i inne zależności Ruby:

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

4. Wygeneruj klucze i przeprowadź migrację bazy danych

Uruchom następujące polecenie, aby wygenerować klucze i przeprowadzić migrację bazy danych:

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

5. Ustaw prawidłowe uprawnienia

Nginx działa jako użytkownik i grupa www-data . Ustaw poprawne uprawnienia, wydając następujące polecenie chown:

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

Skonfiguruj Nginx

Do tej pory powinieneś już mieć Nginx z certyfikatem SSL zainstalowanym w systemie, jeśli nie, sprawdź wymagania wstępne tego samouczka.

Otwórz edytor tekstu i utwórz następujący plik bloku serwera 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; } Nie zapomnij zastąpić example.com domeną Redmine i ustawić prawidłową ścieżkę do plików certyfikatów SSL. Wszystkie żądania HTTP zostaną przekierowane do HTTPS. Fragmenty użyte w tej konfiguracji są tworzone w tym przewodniku.

Włącz blok serwera, tworząc symboliczne łącze do katalogu z sites-enabled :

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

Przed ponownym uruchomieniem usługi Nginx wykonaj test, aby upewnić się, że nie występują błędy składniowe:

sudo nginx -t

Jeśli nie ma błędów, wynik powinien wyglądać następująco:

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

Na koniec zrestartuj usługę Nginx, wpisując:

sudo systemctl restart nginx

Dostęp do Redmine

Otwórz przeglądarkę, wpisz domenę i zakładając, że instalacja zakończy się powodzeniem, pojawi się ekran podobny do następującego:

Po zmianie hasła nastąpi przekierowanie na stronę konta użytkownika.

Wniosek

Pomyślnie zainstalowałeś Redmine w swoim systemie Ubuntu. Powinieneś teraz sprawdzić dokumentację Redmine i dowiedzieć się więcej o tym, jak skonfigurować i korzystać z Redmine.

ubuntu redmine ruby ​​mysql nginx