Redmine: Różnice pomiędzy wersjami

Aktualna wersja na dzień 09:38, 2 lis 2022

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

Przed przystąpieniem do instalacji należy:

Zalogować się na konto poprzez SSH.
Zainstalować RVM.
Zainstalować interpreter Ruby.
Dodać Stronę typu Ruby z konfiguracją produkcyjną ze wskazaniem przy pliku wykonywalnym na uprzednio utworzne środowisko RVM - dla wersji 2.7.2 będzie to /home/LOGIN/.rvm/gems/ruby-2.7.2/wrappers/ruby gdzie za LOGIN należy podstawić swój login konta hostingowego
Dodać bazę i użytkownika MySQL.

Przygotowanie bazy danych

Uwaga!

Adres serwera MySQL jest zależny od numeru serwera shell. Dla serwera s0.mydevil.net będzie to adres mysql0.mydevil.net, dla serwera s1.mydevil.net mysql1.mydevil.net, dla serwera s2.mydevil.net mysql2.mydevil.net itd. W przykładach użyto adresu mysqlX.mydevil.net.

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/

Pobrać najnowszą wersję Redmine ze strony projektu poleceniem fetch -o redmine.tar.gz http://www.redmine.org/releases/redmine-4.2.8.tar.gz.
Wypakować archiwum tar -xzf redmine.tar.gz.
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.
Skopiować przykładową konfigurację bazy danych cp config/database.yml.example config/database.yml.
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.
Konfiguracja przed instalacją gemu nokogiri do korzystania z systemowych bibliotek bundle config build.nokogiri --use-system-libraries
Zainstalować zależności Redmine bundle install --without development test.
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.

Uwaga!

Pierwsze ładowanie strony może potrwać nieco dłużej.

Odnośniki zewnętrzne

Redmine project

@@ Linia 2: / Linia 2: @@
 Przed przystąpieniem do instalacji należy:
-# Przeprowadzić wstępną konfigurację [[RVM]] i [[RoR]].
+# Zalogować się na konto poprzez [[SSH]].
-# Dodać bazę i użytkownika [[MySQL]].
+# Zainstalować  [[RVM#Instalacja_RVM|RVM]].
+# Zainstalować [[RVM#Instalacja_interpretera_Ruby|interpreter Ruby]].
-Przed dalszymi krokami należy się [[logowanie|zalogować]] na shellu MyDevil. Trzeba przejść do katalogu <code class="directory">/usr/home/''login''/domains/''domena''/</code>, gdzie za ''domena'' należy podstawić wcześniej skonfigurowaną domenę.
+# Dodać [[Strona_WWW#Ruby|Stronę typu Ruby]] z konfiguracją produkcyjną ze wskazaniem przy pliku wykonywalnym na uprzednio utworzne środowisko RVM - dla wersji 2.7.2 będzie to <code class="directory">/home/LOGIN/.rvm/gems/ruby-2.7.2/wrappers/ruby</code> gdzie za LOGIN należy podstawić swój login konta hostingowego
+# Dodać bazę i użytkownika [[MySQL#Dodanie_bazy_danych|MySQL]].
 === Przygotowanie bazy danych ===
-{{MySQL}}
+{{Server|MySQL|mysql}}
-Po utworzeniu bazy danych należy dostosować ją do kodowania UTF-8 używanego przez Redmine. W tym celu należy wykonać polecenie: <code>echo 'ALTER DATABASE `''nazwa_bazy''` COLLATE utf8_polish_ci' | mysql -h ''mysqlX.mydevil.net'' -u ''uzytkownik'' -p</code>, gdzie:
+Po utworzeniu bazy danych należy dostosować ją do kodowania UTF-8 używanego przez Redmine. W tym celu należy wykonać polecenie:
-* ''nazwa_bazy'' - nazwa utworzonej bazy MySQL,
+ echo 'ALTER DATABASE `''mXXXX_baza''` COLLATE utf8_polish_ci' | mysql -h ''mysqlX.mydevil.net'' -u ''mXXXX_uzytkownik'' -p
-* ''mysqlX.mydevil.net'' - adres serwera bazy danych,
+gdzie:
-* ''uzytkownik'' - nazwa użytkownika, który ma dostęp do wcześniej utworzonej bazy MySQL.
+* ''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 ===
-Po przygotowaniu bazy danych należy:
+Przed dalszymy krokami należy przejść w kliencie SSH do katalogu <code class="directory">~/domains/''domena''/</code> , gdzie za ''domena'' należy podstawić wcześniej skonfigurowaną domenę:
-# Pobrać najnowszą wersję Redmine ze [http://www.redmine.org/projects/redmine/wiki/Download strony projektu] <code>fetch -o redmine.tar.gz <nowiki>http://www.redmine.org/releases/redmine-3.0.0.tar.gz</nowiki></code>.
+ cd ~/domains/domena/
+# Pobrać najnowszą wersję Redmine ze [http://www.redmine.org/projects/redmine/wiki/Download strony projektu] poleceniem <code>fetch -o redmine.tar.gz <nowiki>http://www.redmine.org/releases/redmine-4.2.8.tar.gz</nowiki></code>.
 # Wypakować archiwum <code>tar -xzf redmine.tar.gz</code>.
-# Zmienić nazwę wypakowanego folderu na <code class="directory">public_ruby</code> i do niego przejść <code>rm -r public_ruby && mv redmine-3.0.0 public_ruby && cd public_ruby</code>.
+# Zmienić nazwę wypakowanego folderu na <code class="directory">public_ruby</code> i do niego przejść <code>rm -r public_ruby && mv redmine-4.2.8 public_ruby && cd public_ruby</code>.
 # Skopiować przykładową konfigurację bazy danych <code>cp config/database.yml.example config/database.yml</code>.
-# Ustawić w pliku <code class="directory">config/database.yml</code> w sekcji production zmienne:
+# Ustawić w pliku <code class="directory">config/database.yml</code> (np. poleceniem: nano config/database.yml) w sekcji production zmienne:
-#* ''database'' na nazwę bazy danych (np. m1064_redmine),
+#* ''database'' na nazwę utworzonej uprzednio bazy danych (np. m1064_redmine),
-#* ''host'' na host bazy danych (mysqlX.mydevil.net),
+#* ''host'' na host bazy danych (np. mysqlX.mydevil.net),
-#* ''username'' na nazwę użytkownika bazy danych (np. m1064_redmine),
+#* ''username'' na nazwę użytkownika utworzonej bazy danych (np. m1064_redmine),
-#* ''password'' na hasło bazy danych.
+#* ''password'' na hasło utworzonej bazy danych.
+# Konfiguracja przed instalacją gemu nokogiri do korzystania z systemowych bibliotek <code>bundle config build.nokogiri --use-system-libraries</code>
 # Zainstalować zależności Redmine <code>bundle install --without development test</code>.
-# Skonfigurować Redmine i utworzyć szkielet bazy danych:
+# Skonfigurować Redmine i utworzyć szkielet bazy danych. Ostatnie polecenie wywoła pytanie o wersję językową. Aby wybrać polską należy wpisać <code>pl</code>:
 #* <code>RAILS_ENV=production bundle exec rake generate_secret_token</code>
 #* <code>RAILS_ENV=production bundle exec rake db:migrate</code>
 #* <code>RAILS_ENV=production bundle exec rake redmine:load_default_data</code>
-# Ostatnie polecenie wywoła pytanie o wersję językową. Aby wybrać polską należy wpisać <code>pl</code>.
-Domyślne dane do logowania to admin / admin. Pierwsze ładowanie strony może potrwać nieco dłużej.
+=== Obsługa skrzynki pocztowej pod Redmine ===
+W celu połączenia Redmine ze skrzynką pocztową należy skopiować plik konfiguracyjny poleceniem: <code>cp config/configuration.yml.example config/configuration.yml</code>.
+Następnie Odkomentować w pliku <code class="directory">config/configuration.yml</code> (np. poleceniem: nano config/configuration.yml) linijki poprzez usunięcie znaków "#":
+<code>
+  #    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"
+</code>
+Uzupełnić danymi swojej skrzynki pocztowej. Można skorzystać z [[Poczta#Dodawanie_konta|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.
-{{Warning|Jeśli zamiast aplikacji wyświetla się błąd 502 to należy sprawdzić ustawienia kluczy w pliku config/secrets.yml dla używanego środowiska.}}
+{{Warning|Pierwsze ładowanie strony może potrwać nieco dłużej.}}
 === Odnośniki zewnętrzne ===
-[http://www.redmine.org/ Redmine project]
+* [http://www.redmine.org/ Redmine project]
-[[Category:Pozostałe]]
+[[Kategoria:Poradniki]]
-[[Category:Ruby]]
+[[Kategoria:Ruby]]