JIRA هي أداة لإدارة المشاريع (project management) تم تطويرها بواسطة Atlassian والتي تستخدم لتتبع المشاكل الأخطاء.
إنها أداة تجارية ومتاحة كإصدار تجريبي لفترة محدودة.
يمكنك استخدام JIRA في الدعم وخدمات العملاء لإنشاء tickets وتتبع حالة tickets التي تم إنشاؤها.
يأتي مزودًا بلوحة معلومات بسيطة وسهلة الاستخدام تساعدك على تتبع تقدم العمل والمشكلات.
إنه يوفر مجموعة غنية من الميزات بما في ذلك إدارة الأخطاء والعيوب وإعداد التقارير المتقدمة والبحث والتصفية ، وسير العمل القابل للتخصيص ولوحات المعلومات القابلة للتخصيص.
سنشرح هنا تثبيت JIRA على خادم Ubuntu 20.04.
شرح تثبيت Jira Agile الجزء الأول
شرح تثبيت Jira Agile الجزء الثاني
المتطلبات الأساسية
خادم يعمل بنظام Ubuntu 20.04 مع ذاكرة وصول عشوائي لا تقل عن 4 جيجابايت.
اسم مجال (domain name) صالح يشير إلى عنوان IP الخاص بالخادم.
إعداد كلمة مرور لـ root على الخادم.
ينصح بتحديث النظام بأحدث إصدار.
يمكنك تحديثها باستخدام الأمر التالي:
apt-get update -y
بمجرد تحديث جميع الحزم قم بتثبيت الحزم الأخرى المطلوبة باستخدام الأمر التالي:
apt-get install unzip fontconfig -y
تثبيت وإعداد قاعدة بيانات MariaDB
تستخدم JIRA قاعدة بيانات MySQL / MariaDB لتخزين بياناتها.
سوف تحتاج إلى تثبيت خادم MariaDB في الخادم الخاص بك.
يمكنك تثبيته بالأمر التالي:
apt-get install mariadb-server -y
قم بتسجيل الدخول إلى MariaDB shell باستخدام الأمر التالي:
mysql
أنشئ قاعدة بيانات ومستخدمًا لـ JIRA باستخدام الأمر التالي:
MariaDB [(none)]> CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
MariaDB [(none)]> CREATE USER 'jirauser'@'localhost' IDENTIFIED BY 'password';
امنح jiradb جميع الصلاحيات بالأمر التالي:
MariaDB [(none)]> GRANT ALL ON jiradb.* TO 'jirauser'@'localhost' WITH GRANT OPTION;
بعد ذلك ، امسح الصلاحيات الحالية واخرج من MariaDB shell باستخدام الأمر التالي:
MariaDB [(none)]> FLUSH PRIVILEGES; MariaDB [(none)]> EXIT;
قم بتعديل الملف الافتراضي MariaDB.
nano /etc/mysql/mariadb.conf.d/50-server.cnf
أضف الأسطر التالية:
default-storage-engine= INNODB
character_set_server = utf8mb4
innodb_default_row_format = DYNAMIC
innodb_large_prefix = ON
innodb_file_format = Barracuda
innodb_log_file_size = 2G
sql_mode = NO_AUTO_VALUE_ON_ZERO
احفظ وأغلق الملف عند الانتهاء.
أعد تشغيل خدمة MariaDB لتطبيق التغييرات:
systemctl restart mariadb.service
تثبيت JIRA
قم بتنزيل أحدث إصدار من JIRA من موقع الويب الرسمي الخاص بهم.
يمكنك تنزيله باستخدام الأمر wget:
wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-8.7.1-x64.bin
قم بتغيير صلاحيات الملف الذي تم تنزيله باستخدام الأمر التالي:
chmod a+x atlassian-jira-software-8.11.0-x64.bin
قم بتثبيت برنامج JIRA عن طريق تشغيل البرنامج الذي تم تنزيله:
./atlassian-jira-software-8.11.0-x64.bin
سترى النتيجة التالية:
This will install Jira Software 8.11.0 on your computer.
OK [o, Enter], Cancel [c]
اضغط على Enter للمتابعة سترى النتيجة التالية:
Click Next to continue, or Cancel to exit Setup.
Choose the appropriate installation or upgrade option.
Please choose one of the following:
Express Install (use default settings) [1], Custom Install (recommended for advanced users) [2, Enter], Upgrade an existing Jira installation [3]
2
اكتب 2 واضغط على Enter للتثبيت المخصص.
سترى النتيجة التالية:
Select the folder where you would like Jira Software to be installed.
Where should Jira Software be installed?
[/opt/atlassian/jira]
حدد مسار تثبيت Jira واضغط على Enter .
سترى النتيجة التالية:
Default location for Jira Software data
[/var/atlassian/application-data/jira]
اضغط على Enter للمتابعة.
سترى النتيجة التالية:
Configure which ports Jira Software will use.
Jira requires two TCP ports that are not being used by any other
applications on this machine. The HTTP port is where you will access Jira
through your browser. The Control port is used to startup and shutdown Jira.
Use default ports (HTTP: 8080, Control: 8005) - Recommended [1, Enter], Set custom value for HTTP and Control ports [2]
1
اكتب 1 واضغط على Enter لاستخدام منفذ HTTP الافتراضي.
سترى النتيجة التالية:
Jira can be run in the background.
You may choose to run Jira as a service, which means it will start
automatically whenever the computer restarts.
Install Jira as Service?
Yes [y, Enter], No [n]
y
اكتب y واضغط على Enter لتثبيت Jira كخدمة.
سترى النتيجة التالية:
Details on where Jira Software will be installed and the settings that will be used.
Installation Directory: /opt/atlassian/jira
Home Directory: /var/atlassian/application-data/jira
HTTP Port: 8080
RMI Port: 8005
Install as service: Yes
Install [i, Enter], Exit [e]
i
اكتب i واضغط على Enter لبدء التثبيت.
سترى النتيجة التالية:
Please wait a few moments while Jira Software is configured.
Installation of Jira Software 8.11.0 is complete
Start Jira Software 8.11.0 now?
Yes [y, Enter], No [n]
y
اكتب y واضغط على Enter لبدء برنامج Jira.
بمجرد الانتهاء من التثبيت بنجاح سترى النتيجة التالية:
Please wait a few moments while Jira Software starts up.
Launching Jira Software ...
Installation of Jira Software 8.11.0 is complete
Your installation of Jira Software 8.11.0 is now ready and can be accessed
via your browser.
Jira Software 8.11.0 can be accessed at http://localhost:8080
Finishing installation ...
إعداد JIRA
ستحتاج إلى تنزيل MySQL JDBC ونسخه إلى دليل تثبيت Jira.
قم بتنزيله باستخدام الأمر التالي:
wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-8.0.18.zip
قم بفك ضغط الملف الذي تم تنزيله باستخدام الأمر التالي:
unzip mysql-connector-java-8.0.18.zip
انسخ MySQL connector باستخدام الأمر التالي:
cp mysql-connector-java-8.0.18/mysql-connector-java-8.0.18.jar /opt/atlassian/jira/lib
اوقف وابدأ خدمة Jira لتطبيق التغييرات:
/etc/init.d/jira stop
/etc/init.d/jira start
إعداد Proxy لـ JIRA
بعد ذلك ، ستحتاج إلى تحديد proxy في Jira.
إذا كنت ترغب في الوصول إلى Jira باستخدام المجال (domain) الخاص بك.
يمكنك تحديده عن طريق تعديل الملف /opt/atlassian/jira/conf/server.xml:
nano /opt/atlassian/jira/conf/server.xml
ابحث عن الأسطر التالية:
<Connector port="8080" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^\`"<>"
maxThreads="150" minSpareThreads="25" connectionTimeout="20000" enableLookups="false"
maxHttpHeaderSize="8192" protocol="HTTP/1.1" useBodyEncodingForURI="true" redirectPort="8443"
acceptCount="100" disableUploadTimeout="true" bindOnInit="false"/>
استبدلها بالأسطر التالية:
<Connector port="8080" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^\`"<>"
maxThreads="150" minSpareThreads="25" connectionTimeout="20000" enableLookups="false"
maxHttpHeaderSize="8192" protocol="HTTP/1.1" useBodyEncodingForURI="true" redirectPort="8443"
acceptCount="100" disableUploadTimeout="true" bindOnInit="false" scheme="http"
proxyName="jira.example.com" proxyPort="80"/>
قم بتشغيل الأمر التالي لتطبيق الإعدادات الجديدة.
configuration.
/etc/init.d/jira stop
/etc/init.d/jira start
إعداد Nginx كوكيل عكسي (Reverse Proxy) لـ Jira
بعد ذلك ، ستحتاج إلى إعداد Nginx كوكيل عكسي إذا كنت تريد الوصول إلى Jira على المنفذ 80.
قم بتثبيت خادم الويب Nginx باستخدام الأمر التالي:
apt-get install nginx -y
أنشئ ملف Nginx virtual host جديد:
nano /etc/nginx/sites-available/jira.conf
أضف الأسطر التالية:
server {
listen 80;
server_name jira.example.com;
location / {
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Server $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://localhost:8080;
client_max_body_size 10M;
}
}
احفظ وأغلق الملف.
قم بتنشيط ملف Nginx virtual host بالأمر التالي:
ln -s /etc/nginx/sites-available/jira.conf /etc/nginx/sites-enabled/
تحقق من Nginx بحثًا عن أي خطأ باستخدام الأمر التالي:
nginx -t
سترى النتيجة التالية:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
أعد تشغيل خدمة Jira و Nginx لتطبيق التغييرات:
/etc/init.d/jira stop
/etc/init.d/jira start
systemctl nginx restart
الوصول إلى Jira Web UI
افتح متصفح الويب الخاص بك وقم بالوصول إلى واجهة ويب Jira باستخدام عنوان URL http://jira.example.com
ستتم إعادة توجيهك إلى الشاشة التالية:
اختار i'will set it up myself ثم Next . يجب أن سترى الشاشة التالية:
اختار My Own Database وقدم تفاصيل قاعدة البيانات الخاصة بك وانقر على زر Next.
سترى الشاشة التالية:
أدخل عنوان التطبيق والوضع (Mode) وعنوان URL وانقر على زر Next.
سترى الشاشة التالية:
أدخل trial license key الخاص بك وانقر فوق الزر Next.
سترى الشاشة التالية:
أدخل تفاصيل حساب المسؤول (administrator) الخاص بك وانقر على زر Next.
سترى الشاشة التالية:
انقر فوق الزر Finish لإكمال التثبيت.
ستشاهد شاشة اختيار اللغة:
سترى الشاشة التالية:
اختر الصورة الرمزية الخاصة بك وانقر على زر Next.
سترى الشاشة التالية:
اضغط Create new project لإنشاء مشروعك الأول.
سترى الشاشة التالية:
اختار Scrum software development وانقر على زر Next.
سترى الشاشة التالية:
اضغط على Select لتحديد سير العمل (Workflow) الخاص بك.
سترى الشاشة التالية:
أدخل اسم المشروع والمفتاح.
اضغط Submit.
ستشاهد لوحة تحكم Jira في الشاشة التالية:
