نشر تطبيق Java على VPS: دليل خطوة بخطوة من الألف إلى الياء

نشر تطبيق Java على VPS: دليل خطوة بخطوة من الألف إلى الياء

تطوير تطبيق Java هو نصف المهمة فقط. النصف الثاني، الذي لا يقل أهمية، هو نشره (deploy) على خادم الإنتاج (production). في هذا الدليل، سنمر عبر دورة النشر الكاملة لتطبيق Java (Spring Boot) على خادم افتراضي مخصص (VPS) يعمل بنظام التشغيل Ubuntu 22.04. ستتعلم كيفية إعداد الخادم، بناء المشروع، تشغيله كخدمة نظامية، وتأمين الوصول عبر خادم الويب.

1. إعداد VPS وتثبيت البرامج اللازمة

الخطوة الأولى هي الاتصال بـ VPS الخاص بك عبر SSH وتثبيت Java Runtime Environment (JRE) و Git.

الاتصال بالخادم

ssh root@عنوان-ip-الخادم-الخاص-بك

تحديث الحزم وتثبيت Java (OpenJDK 17)

بالنسبة لـ Spring Boot 3.x، يُوصى باستخدام Java 17. سنقوم بتثبيت OpenJDK.

apt update && apt upgrade -y\napt install openjdk-17-jdk git -y\njava -version

يجب أن ترى معلومات حول إصدار Java 17.

تثبيت Nginx (لـ reverse proxy)

apt install nginx -y\nsystemctl start nginx\nsystemctl enable nginx

2. بناء تطبيق Java (Maven/Gradle)

على جهازك المحلي (أو مباشرة على الخادم إذا كنت تستنسخ المستودع)، يجب بناء ملف JAR. سننظر في كلا الخيارين.

الخيار أ: البناء محلياً ونسخه إلى الخادم

لنفترض أن لديك مشروع Spring Boot مع Maven.

# على الجهاز المحلي\nmvn clean package -DskipTests\n# سيظهر الملف في target/my-app-0.0.1-SNAPSHOT.jar

ثم انسخه إلى الخادم عبر SCP:

scp target/my-app-0.0.1-SNAPSHOT.jar root@عنوان-ip-الخادم:/opt/myapp/

الخيار ب: البناء مباشرة على الخادم

استنسخ المستودع وقم ببناء المشروع:

cd /opt\ngit clone https://github.com/اسم-المستخدم-خاصتك/اسم-المستودع-خاصتك.git myapp\ncd myapp\n./mvnw clean package -DskipTests\n# أو، إذا كان Maven مثبتاً بشكل عام:\nmvn clean package -DskipTests

3. إعداد تكوين الإنتاج وإنشاء خدمة systemd

لضمان تشغيل التطبيق تلقائياً عند بدء تشغيل النظام وإعادة تشغيله في حالة حدوث عطل، سنقوم بإنشاء ملف systemd unit.

إنشاء سكريبت التشغيل

أنشئ دليلاً للتطبيق (إذا لم تقم بإنشائه بعد):

mkdir -p /opt/myapp\n# انقل ملف JAR إلى هذا الدليل إذا لم يكن موجوداً بالفعل

إنشاء خدمة systemd

أنشئ ملفاً /etc/systemd/system/myapp.service:

nano /etc/systemd/system/myapp.service

ألصق المحتوى التالي (استبدل المسارات والمعلمات بما يتناسب مع مشروعك):

[Unit]\nDescription=تطبيق Java Spring Boot الخاص بي\nAfter=syslog.target network.target\n\n[Service]\nUser=root\nWorkingDirectory=/opt/myapp\nExecStart=/usr/bin/java -Xms256m -Xmx512m -jar /opt/myapp/my-app-0.0.1-SNAPSHOT.jar --server.port=8080\nSuccessExitStatus=143\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target

شرح المعلمات:

\n
• -Xms256m -Xmx512m — الحجم الأولي والأقصى لذاكرة Java heap.
\n
• --server.port=8080 — المنفذ الذي سيعمل عليه التطبيق.
\n
• Restart=always — إعادة التشغيل التلقائي عند التعطل.
\n

تشغيل الخدمة والتحقق منها

systemctl daemon-reload\nsystemctl start myapp\nsystemctl status myapp\nsystemctl enable myapp  # التشغيل التلقائي عند الإقلاع

تحقق من أن التطبيق يستجيب محلياً:

curl http://localhost:8080/actuator/health

يجب أن تحصل على استجابة JSON بالحالة UP.

4. إعداد Reverse Proxy عبر Nginx

الوصول المباشر إلى التطبيق عبر المنفذ 8080 غير آمن. سنقوم بإعداد Nginx كخادم وكيل (proxy) يستقبل الطلبات على