كيفية تثبيت وتكوين redmine على أوبونتو 18.04

Redmine هي واحدة من أكثر أدوات إدارة المصادر المفتوحة للمشاريع وأدوات تتبع المشكلات. إنها منصة مشتركة وقاعدة بيانات مشتركة ومبنية على أعلى إطار عمل Ruby on Rails.

يتضمن Redmine دعمًا لمشاريع متعددة ، ويكي ، ونظام تتبع المشكلات ، والمنتديات ، والتقويمات ، وإشعارات البريد الإلكتروني ، وغير ذلك الكثير.

يصف هذا البرنامج التعليمي كيفية تثبيت أحدث إصدار من Redmine وتكوينه على خادم Ubuntu 18.04 باستخدام MySQL كقاعدة بيانات خلفية و Passenger + Nginx كخادم تطبيق Ruby.

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

تأكد من أنك استوفيت الشروط التالية قبل المتابعة مع هذا البرنامج التعليمي:

• لديك اسم مجال يشير إلى عنوان IP العمومي للخادم الخاص بك. في هذا البرنامج التعليمي ، سوف نستخدم example.com . لقد سجلت الدخول كمستخدم لديه امتيازات sudo. لديك Nginx مثبتًا باتباع هذه التعليمات. لديك شهادة SSL مثبتة لنطاقك. يمكنك تثبيت شهادة Let's Encrypt SSL المجانية من خلال اتباع هذه التعليمات.

إنشاء قاعدة بيانات MySQL

Redmine يدعم MySQL / MariaDB ، Microsoft SQL Server ، SQLite 3 و PostgreSQL. في هذا البرنامج التعليمي ، سنستخدم MySQL كقاعدة بيانات خلفية.

تسجيل الدخول إلى قذيفة الخلية عن طريق كتابة الأمر التالي:

sudo mysql

من داخل MySQL shell ، قم بتشغيل عبارة SQL التالية لإنشاء قاعدة بيانات جديدة:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

بعد ذلك ، قم بإنشاء حساب مستخدم MySQL ومنح حق الوصول إلى قاعدة البيانات:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; تأكد من تغيير change-with-strong-password مع كلمة مرور قوية.

بمجرد الانتهاء من ذلك ، قم بالخروج من وحدة التحكم mysql بكتابة:

EXIT;

تثبيت روبي

أسهل طريقة لتثبيت Ruby على نظام Ubuntu الخاص بك هي من خلال مدير الحزمة apt . في وقت كتابة هذا التقرير ، كان الإصدار في مستودعات Ubuntu هو 2.5.1 وهو أحدث إصدار ثابت من Ruby.

تثبيت روبي عن طريق الكتابة:

sudo apt install ruby-full

تثبيت الركاب و Nginx

Passenger هو خادم تطبيق ويب سريع وخفيف الوزن لـ Ruby و Node.js و Python يمكن دمجهما مع Apache و Nginx. سنقوم بتثبيت Passenger كوحدة Nginx.

تأكد من اتباع المتطلبات الأساسية وتثبيت Nginx قبل المتابعة مع الخطوات التالية.

ابدأ بتثبيت الحزم اللازمة:

sudo apt install dirmngr gnupg apt-transport-https ca-certificates

قم باستيراد مفتاح GPG لمستودع التخزين وقم بتمكين مستودع Phusionpassenger:

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7 sudo add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger bionic main'

بمجرد تمكين مستودع apt ، قم بتحديث قائمة الحزم وتثبيت وحدة Passenger Nginx باستخدام:

sudo apt update sudo apt install libnginx-mod-http-passenger

تثبيت Redmine على أوبونتو

سنبدأ بتثبيت التبعيات اللازمة لبناء Redmine:

sudo apt install build-essential libmysqlclient-dev imagemagick libmagickwand-dev

في وقت كتابة هذا المقال ، أحدث إصدار ثابت من Redmine هو الإصدار 4.0.0.

قبل المتابعة مع الخطوة التالية ، يجب عليك التحقق من صفحة تنزيل Redmine لمعرفة ما إذا كان هناك إصدار أحدث متاح.

1. تنزيل Redmine

قم بتنزيل أرشيف Redmine باستخدام الأمر curl التالي:

sudo curl -L http://www.redmine.org/releases/redmine-4.0.0.tar.gz -o /tmp/redmine.tar.gz

بمجرد اكتمال التنزيل ، استخرج الأرشيف وانقله إلى الدليل /opt :

cd /tmp sudo tar zxf /tmp/redmine.tar.gz sudo mv /tmp/redmine-4.0.0 /opt/redmine

2. تكوين قاعدة بيانات Redmine

ابدأ بنسخ ملف تكوين مثال Redmine:

sudo cp /opt/redmine/config/database.yml.example /opt/redmine/config/database.yml

افتح الملف باستخدام محرر النصوص الخاص بك:

sudo nano /opt/redmine/config/database.yml

ابحث عن قسم production وأدخل قاعدة بيانات MySQL ومعلومات المستخدم التي أنشأناها مسبقًا:

/opt/redmine/config/database.yml

production: adapter: mysql2 database: redmine host: localhost username: redmine password: "change-with-strong-password" encoding: utf8

بمجرد الانتهاء من ذلك ، احفظ الملف واخرج من المحرر.

3. تثبيت تبعيات روبي

انتقل إلى دليل redmine وتثبيت bundler وتبعيات Ruby الأخرى:

cd /opt/redmine/ sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite

4. إنشاء مفاتيح وترحيل قاعدة البيانات

قم بتشغيل الأمر التالي لإنشاء المفاتيح وترحيل قاعدة البيانات:

cd /opt/redmine/ sudo bundle exec rake generate_secret_token sudo RAILS_ENV=production bundle exec rake db:migrate

5. تعيين الأذونات الصحيحة

يعمل Nginx كمستخدم ومجموعة www-data . قم بتعيين الأذونات الصحيحة عن طريق إصدار الأمر chown التالي:

sudo chown -R www-data: /opt/redmine/

تكوين Nginx

الآن ، يجب أن يكون لديك بالفعل Nginx مع شهادة SSL مثبتة على نظامك ، إن لم تكن تحقق من المتطلبات الأساسية لهذا البرنامج التعليمي.

افتح محرر النصوص الخاص بك وقم بإنشاء ملف كتلة خادم Nginx التالي:

sudo nano /etc/nginx/sites-available/example.com /etc/nginx/sites-available/example.com

# Redirect HTTP -> HTTPS server { listen 80; server_name www.example.com example.com; include snippets/letsencrypt.conf; return 301 https://example.com$request_uri; } # Redirect WWW -> NON WWW server { listen 443 ssl http2; server_name www.example.com; ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; return 301 https://example.com$request_uri; } server { listen 443 ssl http2; server_name example.com; root /opt/redmine/public; # SSL parameters ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; include snippets/letsencrypt.conf; # log files access_log /var/log/nginx/example.com.access.log; error_log /var/log/nginx/example.com.error.log; passenger_enabled on; passenger_min_instances 1; client_max_body_size 10m; } لا تنسَ استبدال example.com بنطاق Redmine الخاص بك وتعيين المسار الصحيح لملفات شهادة SSL. سيتم إعادة توجيه جميع طلبات HTTP إلى HTTPS. يتم إنشاء المقتطفات المستخدمة في هذا التكوين في هذا الدليل.

قم بتمكين كتلة الخادم عن طريق إنشاء رابط رمزي إلى الدليل الذي sites-enabled :

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

قبل إعادة تشغيل خدمة Nginx ، قم بإجراء اختبار للتأكد من عدم وجود أخطاء في بناء الجملة:

sudo nginx -t

إذا لم تكن هناك أخطاء ، فيجب أن يبدو الإخراج كما يلي:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful

أخيرًا ، أعد تشغيل خدمة Nginx بكتابة:

sudo systemctl restart nginx

الوصول إلى Redmine

افتح المستعرض الخاص بك ، اكتب نطاقك وافترض أن التثبيت ناجح ، ستظهر شاشة مشابهة للشاشة التالية:

بمجرد تغيير كلمة المرور ، سيتم إعادة توجيهك إلى صفحة حساب المستخدم.

استنتاج

لقد قمت بتثبيت Redmine بنجاح على نظام Ubuntu الخاص بك. يجب عليك الآن التحقق من وثائق Redmine ومعرفة المزيد حول كيفية تكوين واستخدام Redmine.

أوبونتو redmine روبي mysq nginx