نحوه نصب Redmine در CentOS 7

• پیش نیازها
• آپاچی را نصب کنید
• PostgreSQL را نصب کنید
• Ruby را نصب کنید
• نصب مسافر
• Redmine را نصب کنید
• آپاچی را پیکربندی کنید
• امنیت Apache با Letry Encrypt SSL

Redmine یک ابزار مدیریت وب رایگان و منبع باز است. در Ruby on Rails نوشته شده است و از چندین سرور پایگاه داده برای ذخیره دیتابیس پشتیبانی می کند. این نرم افزار غنی از ویژگی های پشتیبانی از پروژه های متعدد ، مبتنی بر نقش ACL و سیستم ردیابی مسئله است. همچنین دارای نمودار Gantt و پشتیبانی تقویم ، مدیریت پرونده ، ویکی و تالار گفتگوی پروژه و همچنین بسیاری از ویژگی های دیگر است. این سیستم از سیستم های کنترل نسخه مانند Git ، SVN یا CVS پشتیبانی می کند. همچنین این زبان چند زبانه است و از 49 زبان پشتیبانی می کند.

این راهنما برای Redmine 3.4.4 نوشته شده است ، اما ممکن است در نسخه های جدیدتر نیز کاربرد داشته باشد.

پیش نیازها

• نمونه سرور Vultr CentOS 7.
• کاربران از sudo .
• نام دامنه به سمت سرور نشان داده شده است.

برای این آموزش ، ما به 192.168.1.1عنوان آدرس IP عمومی و redmine.example.comبه عنوان نام دامنه به سمت نمونه Vultr اشاره خواهیم کرد. لطفاً اطمینان حاصل کنید که تمام وقایع نام دامنه و آدرس IP را با نمونه واقعی جایگزین کنید.

سیستم پایه خود را با استفاده از راهنمای نحوه به روزرسانی CentOS 7 به روز کنید . پس از به روزرسانی سیستم ، نصب وابستگی ها را انجام دهید.

آپاچی را نصب کنید

Redmine در Ruby on Rails نوشته شده است ، بنابراین ما به Phusion Passenger نیاز خواهیم داشت تا با وب سرور آپاچی یکپارچه شود تا برنامه را به خدمت بگیرد. آپاچی را نصب کنید.

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

برای ساختن برنامه Redmine به برخی از ابزارهای توسعه نیز احتیاج خواهیم داشت. ابزارهای مورد نیاز را نصب کنید.

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

PostgreSQL را نصب کنید

Redmine از انواع مختلفی از سرورهای پایگاه داده مانند MySQL ، PostgreSQL و MSSQL پشتیبانی می کند. در این آموزش از PostgreSQL برای میزبانی سرور پایگاه داده Redmine استفاده خواهیم کرد.

PostgreSQL یک سیستم پایگاه داده رابطه ای است. yumمخزن پیش فرض شامل نسخه قدیمی PostgreSQL است ، بنابراین مخزن PostgreSQL را به سیستم اضافه کنید.

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

سرور پایگاه داده PostgreSQL را نصب کنید.

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

اولویت بندی پایگاه داده.

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

سرور PostgreSQL را راه اندازی کنید و آن را فعال کنید تا به طور خودکار در زمان بوت شروع شود.

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

گذرواژه را برای کاربر پیش فرض PostgreSQL تغییر دهید.

sudo passwd postgres

به عنوان کاربر PostgreSQL وارد شوید.

sudo su - postgres

یک کاربر جدید PostgreSQL برای Redmine ایجاد کنید.

createuser redmine

شما مجاز به استفاده از هر نام کاربری به جای آن هستید redmine. PostgreSQL psqlپوسته را برای اجرای نمایش داده ها در پایگاه داده فراهم می کند . به پوسته PostgreSQL بروید.

psql

یک رمز عبور برای کاربر تازه ایجاد شده برای دیتابیس Redmine تنظیم کنید.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

DBPasswordبا یک رمز عبور ایمن جایگزین کنید . برای نصب Redmine یک پایگاه داده جدید ایجاد کنید.

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

از psqlپوسته خارج شوید.

\q

به sudoکاربر تغییر دهید.

exit

pg_hba.confبرای فعال کردن احراز هویت مبتنی بر MD5 ، پرونده را ویرایش کنید.

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

یافتن خطوط زیر و تغییر ارزش peerها و identدر METHODستون به trustو md5، به ترتیب.

# 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

پس از بروزرسانی ، پیکربندی باید به این شکل باشد.

# 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

PostgreSQL را مجدداً راه اندازی کنید تا تغییرات مؤثر واقع شوند.

sudo systemctl restart postgresql-10

چند مورد وابستگی PostgreSQL مورد نیاز دیگر را نصب کنید.

sudo yum -y install libpqxx-devel protobuf-devel

Ruby را نصب کنید

توصیه می شود برای اجرای برنامه از یک کاربر غیر شخصی استفاده کنید تا آن را از بقیه سیستم جدا کند. برای Redmine کاربر جدیدی ایجاد کنید و به کاربر تازه ایجاد شده تغییر دهید.

sudo adduser redmine
sudo su - redmine

ما آخرین نسخه Ruby را با استفاده از Ruby Version Manager یا RVM نصب خواهیم کرد. برای نصب و مدیریت چندین نسخه از Ruby استفاده می شود.

کلید GPG RVM را به سرور خود اضافه کنید.

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

RVM را نصب کنید.

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

لیست نسخه های موجود Ruby را بگیرید.

rvm list known

لیست طولانی از نسخه های Ruby را مشاهده خواهید کرد.

[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

...

آخرین نسخه Ruby را از لیست نصب کنید.

rvm install 2.4

از نسخه نصب شده Ruby استفاده کنید.

rvm use 2.4

می توانید نسخه آن را تأیید کنید.

ruby -v

یک خروجی مشابه را خواهید دید.

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

bundler را نصب کنید ، که مدیر وابستگی برای برنامه Ruby است.

gem install bundler

اکنون Ruby نصب شده است. قبل از نصب Redmine ، ما نیاز به نصب Phusion Passenger داریم.

نصب مسافر

دستور زیر را برای نصب Passenger اجرا کنید.

gem install passenger

مجوز اجرای را به فهرست اصلی redmineکاربر ارائه دهید. مسافر برای خدمت به برنامه باید باینری ها را اجرا کند.

chmod o+x "/home/redmine"

ماژول Apache را برای مسافر نصب کنید.

passenger-install-apache2-module

اسکریپت نصاب از شما سؤالاتی می پرسد. ابتدا اطلاعات مربوط به فرآیند نصب را در اختیار شما قرار می دهد. سپس از شما می خواهد که زبانی را که استفاده می کنید انتخاب کنید. از آنجا که برنامه ما در Ruby on Rails نوشته شده است ، Ruby را از فهرست انتخاب کرده و "" را فشار دهید Enterتا ادامه یابد.

Which languages are you interested in?

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

 ‣ ⬢  Ruby
   ⬡  Python
   ⬡  Node.js
   ⬡  Meteor

اکنون نصب کننده موارد مورد نیاز را بررسی می کند. نصب با هیچگونه وابستگی مفقودی روبرو نمی شود و به طور خودکار اقدام به تهیه و نصب ماژول می کند.

پس از نصب ماژول ، از شما خواسته می شود که ماژول را در پرونده پیکربندی Apache اضافه کنید.

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.

اکنون این مورد را می خواهیم رد کنیم و بعداً آن را در آموزش کامل خواهیم کرد زیرا کاربری که با او وارد شده ایم sudoمجوز ندارد. Enterبرای جستجوی این مرحله " " را فشار دهید .

سرانجام ، اسکریپت نصب کننده نصب را تأیید می کند و هشداری را مشاهده خواهید کرد که می گوید ماژول مسافر در پیکربندی Apache مشخص نشده است.

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.

اکنون که ماژول Passenger را برای Apache نصب کرده ایم ، اقدام به بارگیری و نصب Redmine کنید.

Redmine را نصب کنید

آخرین نسخه Redmine را از صفحه رسمی بارگیری Redmine بارگیری کنید .

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

به خاطر راحتی ، بایگانی را استخراج کرده و فهرست را تغییر نام دهید.

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

پرونده های پیکربندی نمونه را در محل تولید آن کپی کنید.

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

پرونده پیکربندی بانک اطلاعاتی را که فقط کپی کرده ایم باز کنید تا جزئیات پایگاه داده را وارد کنید.

nano config/database.yml

به طور پیش فرض ، پرونده پایگاه داده برای MySQL پیکربندی شده است. پیکربندی های تولید و توسعه را پیدا کنید و آزمایشاتی را انجام دهید که از آداپتور MySQL استفاده می کند. تمام این خطوط را کامنت کنید.

#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 ، با داشتن productionپیکربندی برای postgresqlآداپتور ، خطوطی را که اظهار نظر می شود پیدا کنید . خطوط آنرا لغو کنید و نام بانک اطلاعاتی و اعتبار کاربر را به روز کنید. حتما از تورفتگی درست استفاده کنید که دو فاصله است.

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

برنامه را برای استفاده از پیکربندی PostgreSQL پیکربندی کنید.

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

وابستگی های برنامه مورد نیاز برنامه را نصب کنید.

bundle install --without development test

پیام زیر را در انتهای نصب مشاهده خواهید کرد.

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.

دستور زیر علائم مخفی را برای رمزگذاری داده های جلسه ایجاد می کند.

bundle exec rake generate_secret_token

پایگاه داده PostgreSQL را بنویسید.

RAILS_ENV=production bundle exec rake db:migrate

دستور زیر را که داده های پیش فرض را در پایگاه داده PostgreSQL می نویسد ، اجرا کنید.

RAILS_ENV=production bundle exec rake redmine:load_default_data

دستور فوق از شما می خواهد که زبان پیش فرض مورد استفاده را با برنامه انتخاب کنید. انتخاب پیش فرض انگلیسی است. مطابق ترجیح خود انتخاب کنید.

[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.

نصب برنامه Redmine اکنون به پایان رسیده است. مالکیت و مجوزهای دایرکتوری ها و پرونده ها را تغییر دهید.

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

ما همه چیز مورد نیاز خود را از کاربر غیر ممتازی پیکربندی کرده ایم. sudoبا دویدن به کاربر بازگردید su - <username>.

آپاچی را پیکربندی کنید

ماژول Passenger را برای Apache در پرونده پیکربندی Apache اضافه کنید. این به طور خودکار ماژول Passenger را بارگذاری می کند.

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

یک فایل میزبان مجازی جدید را برای برنامه Redmine خود ایجاد کنید.

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

پرونده را با محتوای زیر پر کنید.

<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>

حتماً redmine.example.comنام دامنه واقعی خود را جایگزین کنید. همچنین ، مطمئن شوید که مسیر رسیدن به PassengerRootو PassengerRubyصحیح است. هنگامی که نسخه جدیدی از روبی یا مسافر وجود دارد ، مسیر باینری ها ممکن است تغییر کند. برای یافتن این مسیرها ، دستور زیر را اجرا کنید.

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

خروجی زیر را دریافت خواهید کرد.

[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

پس از ایجاد پرونده میزبان مجازی ، سرور وب Apache را مجدداً راه اندازی کنید.

sudo systemctl restart httpd

پیکربندی فایروال را اصلاح کنید تا 80از طریق فایروال امکان عبور از آن فراهم شود.

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

اکنون می توانید به رابط Redmine خود دسترسی پیدا کنید http://redmine.example.com. ورود نام کاربری adminو رمز عبور admin. در اولین ورود به سیستم ، Redmine از شما خواسته می شود که رمز عبور را به روز کنید.

امنیت Apache با Letry Encrypt SSL

از آنجا که نصب Redmine ما روی یک سرور روبرو است ، توصیه می شود از SSL استفاده کنید تا تبادل داده ها از سرور تضمین شود.

Certbot را نصب کنید ، که برنامه مشتری برای Let Encrypt CA است.

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

قبل از اینکه شما می توانید برای گواهی درخواست، شما نیاز به اجازه پورت 80و 443یا استاندارد HTTPو HTTPSخدمات از طریق فایروال. از آنجا که قبلاً به بندر اجازه داده ایم 80، اجازه دهید پورت را مجاز کنیم 443.

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

توجه: برای به دست آوردن گواهینامه ها از Let Encrypt CA ، دامنه تولید شده برای صدور گواهینامه ها باید به سمت سرور هدایت شود. در این صورت ، تغییرات لازم را در سوابق DNS دامنه ایجاد کرده و منتظر انتشار DNS قبل از درخواست مجوز مجدد باشید. Certbot قبل از ارائه گواهینامه ها ، دامنه را بررسی می کند.

صدور گواهینامه SSL را ایجاد کنید.

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

گواهینامه های تولید شده احتمالاً در آنها ذخیره می شوند /etc/letsencrypt/live/redmine.example.com/. گواهینامه SSL ذخیره می شود cert.pemو کلید خصوصی نیز به عنوان ذخیره می شود privkey.pem.

بیایید مجوزهای رمزگذاری در مدت 90 روز منقضی شوند ، از این رو توصیه می شود با استفاده از مشاغل Cron ، تمدید خودکار گواهینامه ها را تنظیم کنید.

پرونده کار Cron را برای rootکاربر باز کنید.

sudo crontab -e

در انتهای پرونده خط زیر را اضافه کنید.

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

کار فوق کرون هر روز در ساعت 5:30 دقیقه صبح اجرا می شود. اگر گواهی برای انقضا موقت باشد ، به طور خودکار تمدید می شود.

پرونده میزبان مجازی را که قبلاً برای Redmine ساخته ایم ویرایش کنید.

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

پرونده میزبان مجازی را تغییر دهید تا به شکل زیر ظاهر شود.

<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>

پرونده را ذخیره کرده و از ویرایشگر خارج شوید.

آپاچی را مجدداً راه اندازی کنید تا تغییرات مؤثر واقع شوند.

sudo systemctl restart httpd

شما هم اکنون می توانید دسترسی مدیریت موارد نرم افزارهای بیش از HTTPSدر https://redmine.example.com.

تبریک می گویم ، شما Redmine را با موفقیت در نمونه CentOS 7 خود نصب کرده اید. با ایجاد یا وارد کردن پروژه خود ، توسعه پروژه خود را شروع کنید.