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

مقدمة: لماذا يتطلب نشر تطبيق Kotlin نهجًا خاصًا

التطوير باستخدام Kotlin هو نصف النجاح فقط. النصف الآخر هو النشر الصحيح (التوزيع) لتطبيقك على خادم بعيد. بدون هذه المرحلة، سيبقى كودك مجرد مشروع محلي، غير متاح للمستخدمين.

في هذا الدليل، سنقوم بتحليل الدورة الكاملة لنشر تطبيق Kotlin على VPS (خادم خاص افتراضي). ستتعلم كيفية بناء المشروع في ملف JAR قابل للتنفيذ، وإعداد بيئة الخادم، وتشغيل التطبيق كخدمة، وضمان عمله المستقر. المقالة موجهة للمطورين الذين لديهم بالفعل معرفة أساسية بـ Kotlin و Linux.

1. تحضير المشروع وبناء ملف JAR

قبل تحميل الكود إلى الخادم، يجب بناء التطبيق في قطعة أثرية واحدة. لمشاريع Kotlin المكتوبة باستخدام Spring Boot أو Ktor، التنسيق القياسي هو ملف JAR (أرشيف Java).

1.1. إعداد ملف build.gradle.kts

تأكد من وجود إضافة (plugin) في ملف build.gradle.kts الخاص بك لبناء JAR قابل للتنفيذ. بالنسبة لـ Spring Boot، يبدو الأمر كالتالي:

plugins {\n    kotlin("jvm") version "1.9.22"\n    id("org.springframework.boot") version "3.2.2"\n    id("io.spring.dependency-management") version "1.1.4"\n}\n\ndependencies {\n    implementation("org.springframework.boot:spring-boot-starter-web")\n    implementation("com.fasterxml.jackson.module:jackson-module-kotlin")\n}\n

بالنسبة لـ Ktor الخالص (بدون Spring)، استخدم الإضافة application:

plugins {\n    kotlin("jvm") version "1.9.22"\n    application\n}\n\napplication {\n    mainClass.set("com.example.ApplicationKt")\n}\n

1.2. بناء المشروع

نفذ أمر البناء في المجلد الجذر للمشروع:

./gradlew clean build

بعد البناء الناجح، سيظهر ملف app-0.0.1-SNAPSHOT.jar في الدليل build/libs/ (الاسم يعتمد على التكوين). انسخه إلى جهاز الكمبيوتر المحلي الخاص بك.

2. إعداد خادم VPS

للنشر، سنحتاج إلى VPS مثبت عليه نظام تشغيل Ubuntu 22.04 LTS. من المفترض أن لديك وصول عبر SSH وصلاحيات المستخدم المتميز (sudo).

2.1. تثبيت Java (JRE)

يتم تجميع Kotlin إلى كود بايت JVM، لذلك يجب تثبيت بيئة تشغيل Java (JRE) الإصدار 17 أو أعلى على الخادم:

sudo apt update\nsudo apt install openjdk-17-jre -y\njava -version

2.2. إنشاء مستخدم للتطبيق

لأسباب أمنية، لا يُنصح بتشغيل التطبيق كمستخدم root. سنقوم بإنشاء مستخدم منفصل:

sudo useradd -m -s /bin/bash kotlinapp\nsudo passwd kotlinapp

2.3. تحميل ملف JAR إلى الخادم

استخدم SCP لنسخ الملف من الجهاز المحلي إلى VPS:

scp build/libs/app-0.0.1-SNAPSHOT.jar kotlinapp@your-server-ip:/home/kotlinapp/app.jar

3. تشغيل التطبيق وإعداد Systemd

لكي يبدأ التطبيق تلقائيًا عند بدء تشغيل النظام ولا يتوقف عند فقدان اتصال SSH، سنقوم بإعداده كخدمة Systemd.

3.1. التشغيل اليدوي (للتحقق)

اتصل بالخادم كمستخدم kotlinapp ونفذ:

cd /home/kotlinapp\njava -jar app.jar

إذا بدأ التطبيق واستجاب على المنفذ 8080، انتقل إلى الخطوة التالية. أوقف العملية (Ctrl+C).

3.2. إنشاء ملف وحدة Systemd

أنشئ ملف الخدمة:

sudo nano /etc/systemd/system/kotlin-app.service

ألصق المحتوى التالي:

[Unit]\nDescription=Kotlin Application Service\nAfter=net