Redmine: Różnice pomiędzy wersjami

Wersja z 16:38, 31 paź 2022

Redmine to otwarty system do zarządzania projektami z bugtrackerem.

Przed przystąpieniem do instalacji należy:

1. Zalogować się na konto poprzez SSH.
2. Zainstalować RVM.
3. Zainstalować interpreter Ruby.
4. Dodać Stronę typu Ruby z konfiguracją produkcyjną ze wskazaniem przy pliku wykonywalnym na uprzednio utworzne środowisko RVM.
5. Dodać bazę i użytkownika MySQL.

Przygotowanie bazy danych

Po utworzeniu bazy danych należy dostosować ją do kodowania UTF-8 używanego przez Redmine. W tym celu należy wykonać polecenie:

echo 'ALTER DATABASE `mXXXX_baza` COLLATE utf8_polish_ci' | mysql -h mysqlX.mydevil.net -u mXXXX_uzytkownik -p

gdzie:

• mXXXX_baza - nazwa utworzonej bazy MySQL,
• mysqlX.mydevil.net - adres serwera bazy danych, należy podmienić X cyfrą serwera
• mXXXX_uzytkownik - nazwa użytkownika, który ma dostęp do wcześniej utworzonej bazy MySQL.

Po wykonaniu polecenia należy wpisać hasło do bazy danych wspomnianego wcześniej użytkownika.

Instalacja

Przed dalszymy krokami należy przejść w kliencie SSH do katalogu ~/domains/domena/ , gdzie za domena należy podstawić wcześniej skonfigurowaną domenę:

cd ~/domains/domena/

1. Pobrać najnowszą wersję Redmine ze strony projektu poleceniem fetch -o redmine.tar.gz http://www.redmine.org/releases/redmine-4.2.8.tar.gz.
2. Wypakować archiwum tar -xzf redmine.tar.gz.
3. Zmienić nazwę wypakowanego folderu na public_ruby i do niego przejść rm -r public_ruby && mv redmine-4.2.8 public_ruby && cd public_ruby.
4. Skopiować przykładową konfigurację bazy danych cp config/database.yml.example config/database.yml.
5. Ustawić w pliku config/database.yml (np. poleceniem: nano config/database.yml) w sekcji production zmienne:
   • database na nazwę utworzonej uprzednio bazy danych (np. m1064_redmine),
   • host na host bazy danych (np. mysqlX.mydevil.net),
   • username na nazwę użytkownika utworzonej bazy danych (np. m1064_redmine),
   • password na hasło utworzonej bazy danych.
6. Konfiguracja przed instalacją gemu nokogiri do korzystania z systemowych bibliotek bundle config build.nokogiri --use-system-libraries
7. Zainstalować zależności Redmine bundle install --without development test.
8. Skonfigurować Redmine i utworzyć szkielet bazy danych. Ostatnie polecenie wywoła pytanie o wersję językową. Aby wybrać polską należy wpisać pl:
   • RAILS_ENV=production bundle exec rake generate_secret_token
   • RAILS_ENV=production bundle exec rake db:migrate
   • RAILS_ENV=production bundle exec rake redmine:load_default_data

Obsługa skrzynki pocztowej pod Redmine

W celu połączenia Redmine ze skrzynką pocztową należy skopiować plik konfiguracyjny poleceniem: cp config/configuration.yml.example config/configuration.yml. Następnie Odkomentować w pliku config/configuration.yml (np. poleceniem: nano config/configuration.yml) linijki poprzez usunięcie znaków "#":

 #    delivery_method: :smtp
 #    smtp_settings:
 #      enable_starttls_auto: true
 #      address: "smtp.gmail.com"
 #      port: 587
 #      domain: "smtp.gmail.com" # 'your.domain.com' for GoogleApps
 #      authentication: :plain
 #      user_name: "your_email@gmail.com"
 #      password: "your_password"

Uzupełnić danymi swojej skrzynki pocztowej. Można skorzystać z utworzonej w darmowej subdomenie login.usermd.net.

Domyślne dane do logowania

Domyślne dane do logowania to admin / admin. Należy pamiętać po zmianie danych po zalogowaniu się do Redmine.

Odnośniki zewnętrzne

• Redmine project