Hvernig á að setja upp Redmine á CentOS 7

Redmine er ókeypis og opinn uppspretta, vefbundið verkefnastjórnunartæki. Það er skrifað í Ruby on Rails og styður marga gagnagrunnsþjóna til að geyma gagnagrunninn. Það er lögun-ríkt forrit sem styður mörg verkefni, hlutverkabundið ACL og málrakningarkerfi. Það hefur einnig stuðning við Gantt töflur og dagatal, skráastjórnun, wiki fyrir hverja verkefni og spjallborð, auk margra annarra eiginleika. Það styður útgáfustýringarkerfi eins og Git, SVN eða CVS. Það er líka fjöltyngt og styður allt að 49 tungumál.

Þessi handbók var skrifuð fyrir Redmine 3.4.4, en gæti átt við um nýrri útgáfur líka.

Forkröfur

• Vultr CentOS 7 netþjónstilvik.
• A sudo notandi .
• Lén vísaði í átt að þjóninum.

Fyrir þessa kennslu munum við nota 192.168.1.1sem opinbera IP tölu og redmine.example.comsem lénið sem vísaði í átt að Vultr tilvikinu. Vinsamlega vertu viss um að skipta út öllum tilfellum af dæmi léninu og IP tölunni fyrir það raunverulega.

Uppfærðu grunnkerfið þitt með því að nota handbókina Hvernig á að uppfæra CentOS 7 . Þegar kerfið þitt hefur verið uppfært skaltu halda áfram að setja upp ósjálfstæðin.

Settu upp Apache

Redmine er skrifað í Ruby on Rails, þannig að við munum krefjast þess að Phusion Passenger samþættist Apache vefþjóninn til að þjóna forritinu. Settu upp Apache.

sudo yum -y install httpd httpd-devel libcurl-devel

Til að byggja Redmine forritið þurfum við líka nokkur þróunarverkfæri. Settu upp nauðsynleg verkfæri.

sudo yum -y install ImageMagick ImageMagick-devel git libxml2-devel libxslt-devel gcc bzip2 openssl-devel zlib-devel gdbm-devel ncurses-devel autoconf automake bison gcc-c++ libffi-devel libtool patch readline-devel sqlite-devel glibc-headers glibc-devel libyaml-devel libicu-devel libidn-devel

Settu upp PostgreSQL

Redmine styður margar gerðir af gagnagrunnsþjónum eins og MySQL, PostgreSQL og MSSQL. Í þessari kennslu munum við nota PostgreSQL til að hýsa Redmine gagnagrunnsþjóninn.

PostgreSQL er gagnagrunnskerfi sem tengist hlutum. Sjálfgefin yumgeymsla inniheldur gamla útgáfu af PostgreSQL, svo bættu PostgreSQL geymslunni við kerfið.

sudo yum -y install https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-7-x86_64/pgdg-centos10-10-1.noarch.rpm

Settu upp PostgreSQL gagnagrunnsþjóninn.

sudo yum -y install postgresql10-server postgresql10-contrib postgresql10 

Frumstilla gagnagrunninn.

sudo /usr/pgsql-10/bin/postgresql-10-setup initdb

Ræstu PostgreSQL þjóninn og gerðu það kleift að ræsast sjálfkrafa við ræsingu.

sudo systemctl start postgresql-10
sudo systemctl enable postgresql-10

Breyttu lykilorðinu fyrir sjálfgefinn PostgreSQL notanda.

sudo passwd postgres

Skráðu þig inn sem PostgreSQL notandi.

sudo su - postgres

Búðu til nýjan PostgreSQL notanda fyrir Redmine.

createuser redmine

Þú mátt nota hvaða notendanafn sem er í stað redmine. PostgreSQL veitir psqlskelina til að keyra fyrirspurnir í gagnagrunninum. Skiptu yfir í PostgreSQL skelina.

psql

Stilltu lykilorð fyrir nýstofnaðan notanda fyrir Redmine gagnagrunninn.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

Skiptu út DBPasswordfyrir öruggt lykilorð. Búðu til nýjan gagnagrunn fyrir Redmine uppsetninguna.

CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

Farið úr psqlskelinni.

\q

Skiptu yfir í sudonotanda.

exit

Breyttu pg_hba.confskránni til að virkja MD5 byggða auðkenningu.

sudo nano /var/lib/pgsql/10/data/pg_hba.conf

Finndu eftirfarandi línur og breyttu gildunum peerog identí METHODdálkinum í trustog md5, í sömu röð.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    all             all             ::1/128                 ident

Þegar uppfærsla hefur verið uppfærð ætti uppsetningin að líta svona út.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5

Endurræstu PostgreSQL svo breytingarnar geti tekið gildi.

sudo systemctl restart postgresql-10

Settu upp nokkrar nauðsynlegar PostgreSQL ósjálfstæði.

sudo yum -y install libpqxx-devel protobuf-devel

Settu upp Ruby

Mælt er með því að nota forréttindalausan notanda til að keyra forritið til að halda því einangrað frá restinni af kerfinu. Búðu til nýjan notanda fyrir Redmine og skiptu yfir í nýstofnaðan notanda.

sudo adduser redmine
sudo su - redmine

Við munum setja upp nýjustu útgáfuna af Ruby með Ruby Version Manager, eða RVM. Það er notað til að setja upp og stjórna mörgum útgáfum af Ruby.

Bættu GPG lykli RVM við netþjóninn þinn.

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Settu upp RVM.

curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

Sæktu lista yfir tiltækar útgáfur af Ruby.

rvm list known

Þú munt sjá langan lista yfir Ruby útgáfur.

[redmine@vultr ~]$ rvm list known
# MRI Rubies

[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.7]
[ruby-]2.3[.4]
[ruby-]2.4[.1]
ruby-head

...

Settu upp nýjustu útgáfuna af Ruby af listanum.

rvm install 2.4

Notaðu uppsettu útgáfuna af Ruby.

rvm use 2.4

Þú getur staðfest útgáfu þess.

ruby -v

Þú munt sjá svipaða framleiðsla.

[redmine@vultr ~]$ ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]

Settu upp bundler, sem er ávanastjóri fyrir Ruby forritið.

gem install bundler

Ruby er nú sett upp. Áður en við setjum upp Redmine þurfum við að setja upp Phusion Passenger.

Settu upp farþega

Keyrðu eftirfarandi skipun til að setja upp Passenger.

gem install passenger

Veittu framkvæmdarheimild til heimamöppu redminenotanda. Farþegi þarf að keyra tvöfaldana til að þjóna forritinu.

chmod o+x "/home/redmine"

Settu upp Apache einingu fyrir farþega.

passenger-install-apache2-module

The installer script will ask you some questions. First, it will provide you information about the installation process. Then it will ask you to select the language which you will be using. Since our application is written in Ruby on Rails, select Ruby from the menu and press "Enter" to proceed further.

Which languages are you interested in?

Use <space> to select.
If the menu doesn't display correctly, press '!'

 ‣ ⬢  Ruby
   ⬡  Python
   ⬡  Node.js
   ⬡  Meteor

The installer will now check for requirements. The installer will not encounter any missing dependencies and will automatically proceed to compile and install the module.

Once the module is installed, it will prompt you to add the module into the Apache configuration file.

Almost there!

Please edit your Apache configuration file, and add these lines:

   LoadModule passenger_module /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so
   <IfModule mod_passenger.c>
     PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
     PassengerDefaultRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
   </IfModule>

After you restart Apache, you are ready to deploy any number of web
applications on Apache, with a minimum amount of configuration!

Press ENTER when you are done editing.

We will skip this for now and will complete it later in the tutorial as the user with which we are logged in now does not have sudo permissions. Press "Enter" to skip this step.

Finally, the installer script will validate the installation and you will see a warning saying the Passenger module is not specified in Apache configuration.

Validating installation...

 * Checking whether this Passenger install is in PATH... ✓
 * Checking whether there are no other Passenger installations... ✓
 * Checking whether Apache is installed... ✓
 * Checking whether the Passenger module is correctly configured in Apache... (!)

   You did not specify 'LoadModule passenger_module' in any of your Apache
   configuration files. Please paste the configuration snippet that this
   installer printed earlier, into one of your Apache configuration files, such
   as /etc/httpd/conf/httpd.conf.


Detected 0 error(s), 1 warning(s).
Press ENTER to continue.

Now that we have installed the Passenger module for Apache, proceed to download and install Redmine.

Install Redmine

Download the latest version of Redmine from the official Redmine download page.

cd ~
wget http://www.redmine.org/releases/redmine-3.4.4.tar.gz

Extract the archive and rename the directory for sake of convenience.

tar -xf redmine-*.tar.gz
mv redmine-*/ redmine/

Copy the example configuration files to its production location.

cd redmine
cp config/configuration.yml.example config/configuration.yml
cp config/database.yml.example config/database.yml

Open the database configuration file we just copied to enter the database details.

nano config/database.yml

By default, the database file is configured for MySQL. Find the configurations for production and development, and test which uses the MySQL adapter. Comment out all of these lines.

#production:
#  adapter: mysql2
#  database: redmine
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

#development:
#  adapter: mysql2
#  database: redmine_development
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

#test:
#  adapter: mysql2
#  database: redmine_test
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

Furthur, find the lines which are commented, having production configuration for the postgresql adapter. Uncomment those lines and update the database name and user credentials. Make sure to use the correct indentation, which is two spaces.

production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: "DBPassword"

Configure the application to use the PostgreSQL configuration.

bundle config build.pg --with-pg-config=/usr/pgsql-10/bin/pg_config

Install the application dependencies required by the application.

bundle install --without development test

You will see the following message at the end of the installation.

Installing roadie-rails 1.1.1
Bundle complete! 31 Gemfile dependencies, 55 gems now installed.
Gems in the groups development and test were not installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.

The following command generates secret tokens that are used to encode the session data.

bundle exec rake generate_secret_token

Write the PostgreSQL database.

RAILS_ENV=production bundle exec rake db:migrate

Run the following command, which writes the default data into PostgreSQL database.

RAILS_ENV=production bundle exec rake redmine:load_default_data

The above command will ask you to choose the default language to be used with the application. The default choice is English; choose according to your preference.

[redmine@vultr redmine]$ RAILS_ENV=production bundle exec rake redmine:load_default_data

Select language: ar, az, bg, bs, ca, cs, da, de, el, en, en-GB, es, es-PA, et, eu, fa, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mk, mn, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sq, sr, sr-YU, sv, th, tr, uk, vi, zh, zh-TW [en]
====================================
Default configuration data loaded.

Installation of the Redmine application is now finished. Change ownership and permissions of the directories and files.

mkdir -p tmp tmp/pdf public/plugin_assets
chown -R redmine:redmine files log tmp public/plugin_assets
chmod -R 755 files log tmp public/plugin_assets

We have configured everything we need from the non-privileged user. Switch back to the sudo user by running su - <username>.

Configure Apache

Add the Passenger module for Apache into the Apache configuration file. This will automatically load the Passenger module.

echo "LoadModule passenger_module /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so" | sudo tee -a /etc/httpd/conf.modules.d/00-base.conf

Create a new virtual host file for your Redmine application.

sudo nano /etc/httpd/conf.d/redmine.conf

Populate the file with the following content.

<VirtualHost *:80>
    ServerName redmine.example.com

    DocumentRoot /home/redmine/redmine/public

    PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
    PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
    PassengerUser redmine

    <Directory /home/redmine/redmine/public>
      Allow from all
      Options -MultiViews
      Require all granted
    </Directory>
</VirtualHost>

Make sure to replace redmine.example.com with your actual domain name. Also, make sure that the path to the PassengerRoot and PassengerRuby are correct. The path to the binaries may change when there is a new release of Ruby or Passenger. To find these paths, run the following command.

sudo su redmine -c "passenger-config about ruby-command"

You will get following output.

[user@vultr ~]$ sudo su redmine -c "passenger-config about ruby-command"
passenger-config was invoked through the following Ruby interpreter:
  Command: /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  Version: ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]
  To use in Apache: PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  To use in Nginx : passenger_ruby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  To use with Standalone: /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/bin/passenger start

Þegar sýndarhýsingarskráin er búin til skaltu endurræsa Apache vefþjóninn.

sudo systemctl restart httpd

Breyttu uppsetningu eldveggsins til að hleypa höfn í 80gegnum eldvegginn.

sudo firewall-cmd --zone=public --add-service=http --permanent
sudo firewall-cmd --reload

Þú getur nú fengið aðgang að Redmine viðmótinu þínu á http://redmine.example.com. Skráðu þig inn með notandanafni adminog lykilorði admin. Við fyrstu innskráningu mun Redmine biðja þig um að uppfæra lykilorðið.

Að tryggja Apache með Let's Encrypt SSL

Þar sem Redmine uppsetningin okkar er á almennum netþjóni er mælt með því að nota SSL til að tryggja skipti á gögnum frá netþjóninum.

Settu upp Certbot, sem er biðlaraforritið fyrir Let's Encrypt CA.

sudo yum -y install epel-release
sudo yum -y install certbot mod_ssl

Áður en þú getur beðið um skírteinin þarftu að leyfa port 80og 443eða staðal HTTPog HTTPSþjónustu í gegnum eldvegginn. Þar sem við höfum þegar leyft höfn 80fyrr, skulum við leyfa höfn 443.

sudo firewall-cmd --zone=public --add-service=https --permanent
sudo firewall-cmd --reload

Athugið: Til að fá skírteini frá Let's Encrypt CA verður lénið sem á að búa til skírteini að vera beint að þjóninum. Ef ekki, gerðu nauðsynlegar breytingar á DNS-skrám lénsins og bíddu eftir að DNS breiðist út áður en þú gerir vottorðsbeiðnina aftur. Certbot athugar lénsvaldið áður en það gefur upp vottorðin.

Búðu til SSL vottorðin.

sudo certbot certonly --webroot -w /home/redmine/redmine/public -d redmine.example.com

Líklegt er að útbúin skírteini séu geymd í /etc/letsencrypt/live/redmine.example.com/. SSL vottorðið verður geymt sem cert.pemog einkalykill verður geymdur sem privkey.pem.

Við skulum dulkóða vottorð renna út eftir 90 daga, þess vegna er mælt með því að setja upp sjálfvirka endurnýjun skírteina með Cron störf.

Opnaðu Cron vinnuskrána fyrir rootnotandann.

sudo crontab -e

Bættu við eftirfarandi línu í lok skráarinnar.

30 5 * * * /usr/bin/certbot renew --quiet

Ofangreind Cron starf mun keyra á hverjum degi klukkan 5:30. Ef skírteinið á að renna út verður það sjálfkrafa endurnýjað.

Breyttu sýndarhýsingarskránni sem við bjuggum til áðan fyrir Redmine.

sudo nano /etc/httpd/conf.d/redmine.conf

Breyttu sýndarhýsingarskránni þannig að hún líti út eins og eftirfarandi.

<VirtualHost *:80>
    Redirect permanent / https://www.example.com/
    ServerName redmine.example.com
</VirtualHost>

<VirtualHost *:443>
    ServerAdmin [email protected]
    ServerName redmine.example.com
    DocumentRoot "/home/redmine/redmine/public"
    <Directory "/home/redmine/redmine/public">
        Options None
        Require all granted
    </Directory>
    PassengerAppEnv production
    PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
    PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
    PassengerUser redmine
    PassengerHighPerformance on

    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/redmine.example.com/cert.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/redmine.example.com/privkey.pem
    SSLCertificateChainFile /etc/letsencrypt/live/redmine.example.com/chain.pem

    SSLProtocol             all -SSLv2 -SSLv3
    SSLHonorCipherOrder     on
    SSLCipherSuite          ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS

    <IfModule headers_module>
        Header always edit Set-Cookie ^(.*)$ $1;HttpOnly;Secure
        Header always set Strict-Transport-Security "max-age=15768000; includeSubDomains"
    </IfModule>
</VirtualHost>

Vistaðu skrána og farðu úr ritlinum.

Endurræstu Apache svo breytingarnar geti tekið gildi.

sudo systemctl restart httpd

Þú getur nú fengið aðgang að Redmine yfir HTTPSá https://redmine.example.com.

Til hamingju, þú hefur sett upp Redmine á CentOS 7 tilvikinu þínu. Byrjaðu að þróa verkefnið þitt annað hvort með því að búa til eða flytja inn verkefnið þitt.