مقدمة

عندما نبدأ في بناء الأشياء كمطورين، فإن أحد أهدافنا الرئيسية هو مشاركة ما أنشأناه مع الآخرين. بالنسبة لمطوري الواجهة الأمامية، غالبًا ما يكون هذا الأمر واضحًا، وذلك بفضل خدمات الاستضافة الرائعة مثل Vercel وNetlify التي تدعم تطبيقات الواجهة الأمامية بسلاسة. ومع ذلك، بالنسبة لمطوري الواجهة الخلفية، قد يكون عرض عملنا أكثر صعوبة. نحن نبني واجهات برمجة التطبيقات، ونعمل مع قواعد البيانات، وعلى الرغم من أن JSON قد يكون قويًا، إلا أنه ليس جذابًا من الناحية المرئية مثل الرسوم المتحركة المبنية باستخدام CSS أو Lottie.

ولهذا السبب يعد العثور على طريقة فعالة وموثوقة لنشر التطبيقات الخلفية أمرًا بالغ الأهمية. يعمل Spring Boot، وهو إطار عمل شائع قائم على Java، على تبسيط عملية إنشاء تطبيقات جاهزة للإنتاج، ولكن لا يزال نشرها يمثل تحديًا. وهنا يأتي دور Koyeb. تقدم Koyeb نظامًا أساسيًا قويًا وسهل الاستخدام يسمح للمطورين بنشر تطبيقات Spring Boot الخاصة بهم بسرعة وبأقل قدر من الإعداد. في هذا الدليل، سنرشدك خلال العملية الكاملة لنشر تطبيق Spring Boot مع قاعدة بيانات PostgreSQL على Koyeb، من البداية إلى النهاية.

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

قبل أن نتعمق في عملية النشر، تأكد من أن لديك ما يلي:

• تطبيق Spring Boot الأساسي. إذا لم يكن لديك تطبيق، فيمكنك إنشاء مشروع بسرعة باستخدام Spring Initializr باستخدام هذه التبعيات:
  • شبكة الربيع
  • بيانات الربيع JPA
  • برنامج تشغيل PostgreSQL
• مستودع GitHub (أو GitLab/Bitbucket)، حيث تتم استضافة مشروع Spring Boot الخاص بك.
• حساب نيون. سجل في نيون
• حساب Koyeb. قم بالتسجيل في موقع Koyeb إذا لم يكن لديك حساب.
• تم تثبيت Maven أو Gradle ، اعتمادًا على كيفية تكوين مشروع Spring Boot الخاص بك.

2. قاعدة البيانات الإعداد

• على Koyeb، قم بإنشاء قاعدة بيانات مجانية PostgreSQL، والتي ستوفر عنوان URL لقاعدة البيانات ولكنها تقتصر على 50 ساعة شهريًا.

- في Neon، قم بإنشاء نسخة من قاعدة بيانات PostgreSQL المجانية، والتي ستوفر أيضًا عنوان URL لقاعدة البيانات.

3. ربط قاعدة البيانات مع Spring Boot

داخل دليل الموارد، ستقوم بإنشاء ملف يسمى env.properties، داخل هذا الدليل يخزن جميع متغيرات البيئة الخاصة بك، في هذه الحالة DB_URL، DB_USERNAME وDB_PASSWORD.

لا تقم أبدًا بإلزام بهذا الملف إلى مستودع جيثب الخاص بك.

ملف env.properties:

DB_USERNAME=
DB_PASSWORD=
DB_URL=

ملف application.properties الخاص بك:

application.propertiesfile:

server.port=${PORT:8080}

spring.datasource.url=${DB_URL}
spring.datasource.username=${DB_USERNAME}
spring.datasource.password=${DB_PASSWORD}

spring.jpa.hibernate.ddl-auto=update

spring.config.import=classpath:env.properties

توضيح

• server.port - هذا هو المنفذ الذي سيتم تشغيل التطبيق الخاص بك فيه. قمنا بتعيين متغير البيئة PORT مع احتياطي قدره 8080 في حالة كون PORT فارغًا.
• spring.datasource.url - هذا متغير بيئة يأتي من لوحة معلومات Neon أو Koyeb.
• spring.datasource.username - هذا متغير بيئة يأتي من لوحة معلومات Neon أو Koyeb.
• spring.datasource.password - هذا متغير بيئة يأتي من لوحة معلومات Neon أو Koyeb.
• spring.config.import - يؤدي هذا إلى استيراد الملف الذي تخزن فيه بياناتك الحساسة.

4. قم بإنشاء ملف system.properties

في جذر المشروع، قم بإنشاء ملف system.properties.

يحدد هذا الملف إصدار وقت تشغيل Java المطلوب استخدامه بحيث تقوم Koyeb Java buildpack بتنفيذ المشروع بالإصدار الصحيح.

تذكر: يقبل Koyeb قيم الإصدار الرئيسية 1.8 و11 و13 و15 و17 و19 و20.

إذا لم تحدد إصدار Java، فسيتم استخدام الإصدار 1.8.

أنا أستخدم Java 21. إذا كنت تستخدم إصدارًا آخر، قم بتغييره وفقًا لذلك.

خصائص النظام

java.runtime.version=21

5. إنشاء وحدة تحكم

ستعرض وحدة التحكم هذه رسالة Hello World على المسار /.

package com.example.demo.Modules.User.controller;

import org.springframework.web.bind.annotation.RestController;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;

@RestController
public class UserController {

    @GetMapping("/")
    public String helloWorld() {
        return "Hello World";
    }

}

6. ادفع الرمز إلى Github

أنشئ مستودعًا عامًا على Github وادفع الكود الخاص بك. احصل على عنوان URL لهذا المستودع.

7. نشر على كوييب

• أدخل حسابك في koyeb.
• انتقل إلى الخدمات > خدمات الويب > إنشاء خدمات الويب باستخدام Github.
• اتصل بـ Github أو الصق عنوان URL للمستودع العام.
• انتظر حتى يتم بناء المشروع.
• في حالة النجاح، سيتم إنشاء عنوان URL عام، وسيتمكن الجميع من الوصول إلى تطبيق Spring Boot الخاص بك.

خاتمة

هذا كل شيء! لقد قمت بإنشاء تطبيق Spring Boot، وربطته بقاعدة بيانات سحابية، ونشرت كل شيء على Koyeb. يمكن أن تكون هذه بداية مشروع تريد عرضه في محفظتك، مما يسمح للعملاء برؤية ما يمكنك فعله.

يمكنك زيادة هذا التطبيق باستخدام مقالة برنامج تحميل الصور.

شكرًا على القراءة!

؟ مرجع

• كويب - نشر Spring Boot
• كويب - مرجع جافا

؟ تحدث معي

• لينكد إن
• جيثب
• مَلَفّ