كيفية تثبيت Redmine على CentOS 7

• المتطلبات الأساسية
• قم بتثبيت أباتشي
• قم بتثبيت PostgreSQL
• تثبيت روبي
• قم بتثبيت Passenger
• قم بتثبيت Redmine
• تكوين أباتشي
• تأمين Apache باستخدام Let's Encrypt SSL

Redmine أداة مجانية ومفتوحة المصدر لإدارة المشاريع على شبكة الإنترنت. هو مكتوب في Ruby on Rails ويدعم خوادم قاعدة بيانات متعددة لتخزين قاعدة البيانات. وهو تطبيق غني بالميزات يدعم مشاريع متعددة ، وقائمة ACL تعتمد على الأدوار ونظام تتبع المشكلات. كما أن لديها مخطط جانت ودعم التقويم ، وإدارة الملفات ، لكل مشروع ومنتدى ، بالإضافة إلى العديد من الميزات الأخرى. وهو يدعم أنظمة التحكم في الإصدار مثل Git أو SVN أو CVS. كما أنها متعددة اللغات ، وتدعم ما يصل إلى 49 لغة.

تمت كتابة هذا الدليل لـ Redmine 3.4.4 ، ولكن قد ينطبق على الإصدارات الأحدث أيضًا.

المتطلبات الأساسية

• نسخة خادم Vultr CentOS 7.
• A المستخدم سودو .
• أشار اسم المجال نحو الخادم.

في هذا البرنامج التعليمي ، سوف نستخدم 192.168.1.1كعنوان IP عام redmine.example.comولكونه اسم النطاق الموجه نحو مثيل Vultr. يرجى التأكد من استبدال كل تكرارات مثال اسم المجال وعنوان IP بالحدث الفعلي.

قم بتحديث نظامك الأساسي باستخدام الدليل كيفية تحديث CentOS 7 . بمجرد تحديث النظام الخاص بك ، انتقل إلى تثبيت التبعيات.

قم بتثبيت أباتشي

Redmine مكتوب في Ruby on Rails ، وبالتالي سنطلب من Phusion Passenger التكامل مع خادم الويب Apache لخدمة التطبيق. قم بتثبيت أباتشي.

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

تثبيت روبي

يوصى باستخدام مستخدم غير مميز لتشغيل التطبيق لإبقائه معزولًا عن بقية النظام. قم بإنشاء مستخدم جديد لـ Redmine والتبديل إلى المستخدم الذي تم إنشاؤه حديثًا.

sudo adduser redmine
sudo su - redmine

سنقوم بتثبيت أحدث إصدار من Ruby باستخدام Ruby Version Manager أو RVM. يتم استخدامه لتثبيت وإدارة إصدارات متعددة من روبي.

أضف مفتاح 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

سترى قائمة طويلة من إصدارات روبي.

[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

استخدم الإصدار المثبت من روبي.

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

تم تثبيت روبي الآن. قبل تثبيت Redmine ، سنحتاج إلى تثبيت Phusion Passenger.

قم بتثبيت Passenger

قم بتشغيل الأمر التالي لتثبيت Passenger.

gem install passenger

توفير إذن التنفيذ إلى الدليل الرئيسي redmineللمستخدم. يحتاج المسافر إلى تنفيذ الثنائيات لخدمة التطبيق.

chmod o+x "/home/redmine"

قم بتثبيت وحدة Apache الخاصة بـ Passenger.

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" لتخطي هذه الخطوة.

أخيرًا ، سيقوم البرنامج النصي للمثبت بالتحقق من صحة التثبيت وسترى تحذيرًا يقول أن وحدة Passenger غير محددة في تكوين 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

فورثر ، ابحث عن الخطوط التي تم التعليق عليها ، مع 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. سيؤدي ذلك إلى تحميل وحدة الركاب تلقائيًا.

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صحيحة. قد يتغير المسار إلى الثنائيات عندما يكون هناك إصدار جديد من Ruby أو Passenger. للعثور على هذه المسارات ، قم بتشغيل الأمر التالي.

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

بمجرد إنشاء ملف Virtual host ، أعد تشغيل خادم الويب 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 باستخدام Let's Encrypt SSL

نظرًا لأن تثبيت Redmine الخاص بنا موجود على خادم يواجه الجمهور ، فمن المستحسن استخدام SSL لتأمين تبادل البيانات من الخادم.

قم بتثبيت Certbot ، وهو تطبيق العميل لـ Let's 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's 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

سيتم تشغيل وظيفة Cron المذكورة أعلاه كل يوم الساعة 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>

احفظ الملف واخرج من المحرر.

أعد تشغيل Apache حتى تصبح التغييرات نافذة المفعول.

sudo systemctl restart httpd

يمكنك الآن الوصول إلى Redmine HTTPSعلى https://redmine.example.com.

تهانينا ، لقد نجحت في تثبيت Redmine على مثيل CentOS 7. ابدأ في تطوير مشروعك إما عن طريق إنشاء أو استيراد مشروعك.