نشر تطبيق من GitHub في السعودية مع رصيف
دليل عملي لمؤسسي SaaS: انشر تطبيقك من GitHub داخل السعودية، واربط PostgreSQL عبر شبكة خاصة، واضبط HTTPS واستعد لاستقبال أول مستخدميك.
يعمل نموذج منتجك على جهازك، لكن الخطوة التالية ليست رسم مخطط جديد للبنية التحتية؛ بل الوصول إلى رابط يستطيع عميلك المحتمل فتحه وتجربة المنتج من خلاله.
إذا كنت مطورًا أو مؤسس منتج برمجي كخدمة (SaaS) يستهدف السوق السعودي، فغالبًا تحتاج في البداية إلى تطبيق ويب، وقاعدة بيانات، وطريقة واضحة لنشر التحديثات. يشرح هذا الدليل كيف تجمع هذه العناصر على رصيف: من مستودع GitHub إلى تطبيق يعمل عبر HTTPS على خوادم داخل المملكة.
رصيف متاح حاليًا ضمن تجربة خاصة تستقبل فرقًا محدودة. يمكنك طلب الوصول إذا لم يكن لديك حساب، وتجهيز مستودعك بالخطوات التالية إلى حين تفعيله.
كيف تبدو البنية المناسبة لأول إطلاق؟
ابدأ بأبسط بنية تدعم رحلة حقيقية للعميل:
| المكوّن | وظيفته | طريقة الوصول |
|---|---|---|
| تطبيق الويب أو واجهة API | تشغيل وظائف المنتج | رابط HTTPS عام |
| PostgreSQL | حفظ بيانات التطبيق | اتصال خاص داخل البيئة نفسها |
| وحدة تخزين قاعدة البيانات | الاحتفاظ بالملفات بين عمليات النشر | مرتبطة بخدمة قاعدة البيانات |
اجعل تطبيق الويب دون حالة محلية قدر الإمكان؛ أي لا تعتمد على ملفات داخل الحاوية للاحتفاظ ببيانات المستخدمين. إذا احتجت إلى ملفات دائمة، فاستخدم وحدة تخزين مناسبة.
توضح وثائق رصيف أن الخدمات والبيانات التي تحتفظ بها تُستضاف داخل السعودية. وراجع بشكل مستقل مكان معالجة البيانات التي ترسلها إلى خدمات خارجية، مثل أدوات التحليلات والبريد الإلكتروني ومزودي الدفع.
1. جهّز مستودع GitHub قبل النشر
تحقق من هذه النقاط قبل فتح لوحة التحكم:
- أنت مالك حساب GitHub الشخصي الذي ستربطه، أو أحد مالكي المؤسسة على GitHub.
- يحتوي المشروع على أمر تشغيل يعمل في بيئة الإنتاج.
- يقرأ التطبيق المنفذ من المتغير
PORT، ويستمع على0.0.0.0وليسlocalhostفقط. - المتغيرات المطلوبة موثقة في ملف مثل
.env.example، دون كلمات مرور أو مفاتيح حقيقية.
في تطبيق Express موجود، يمكن ضبط الاستماع بهذه الصورة:
const port = Number(process.env.PORT || 8080);
app.listen(port, '0.0.0.0');يستطيع رصيف بناء التطبيق من المستودع سواء احتوى على Dockerfile أم لا. وإذا كان المستودع يضم عدة تطبيقات، فتأكد من اختيار التطبيق والمجلد الجذر الصحيحين. يوضح دليل النشر من GitHub صلاحيات الربط وإعدادات المصدر.
2. اربط GitHub وانشر خدمة التطبيق
من لوحة التحكم، اختر New project → GitHub Repository، ثم اربط GitHub وحدد المستودع والفرع. يطلب تطبيق رصيف على GitHub صلاحية قراءة المستودعات التي تختارها.
اختر Deploy Now لبدء البناء والنشر. إذا اكتشف رصيف متغيرات معلنة في المستودع، يظهر Add Variables بدلًا منه؛ أدخل القيم المطلوبة قبل النشر. تابع عملية البناء في Builds ومخرجات التطبيق في Logs.
للخدمة التي سيصل إليها العملاء، اختر Public web (HTTPS)، أو فعّل Public HTTP ضمن إعدادات الشبكة، وحدد المنفذ الذي يستمع عليه التطبيق فعليًا. بعد نجاح النشر، تحصل الخدمة العامة على عنوان HTTPS ضمن raseef.run.
افتح الرابط واختبر صفحة أو وظيفة من المنتج، وليس الصفحة الرئيسية فقط. يمكنك متابعة تسلسل الخطوات في دليل البداية السريعة.
3. اربط PostgreSQL عبر الشبكة الخاصة
داخل المشروع والبيئة نفسيهما، اختر Create → PostgreSQL وسمّ الخدمة db. ينشئ القالب قاعدة البيانات مع وحدة تخزين خاصة بها وكلمة مرور مولّدة.
في Variables الخاصة بتطبيق الويب، أضف:
DATABASE_URL=${{ db.DATABASE_URL }}عند نشر التطبيق، يُستبدل هذا المرجع بسلسلة الاتصال بقاعدة البيانات عبر عنوانها الخاص. بهذه الطريقة لا تحتاج إلى نسخ كلمة المرور إلى الشفرة المصدرية.
انشر قاعدة البيانات أولًا، ثم التطبيق الذي يعتمد عليها. حفظ المتغيرات وحده لا يغيّر التطبيق الجاري: أعد النشر لتطبيق القيم الجديدة. وإذا تغيرت قيمة مرجعية في قاعدة البيانات لاحقًا، فأعد نشر التطبيق المستهلك لها عندما تكون جاهزًا.
تقتصر الشبكة الخاصة على الخدمات داخل البيئة نفسها؛ فلا يستطيع مشروع آخر أو بيئة أخرى الوصول إلى هذا العنوان الخاص. راجع مراجع المتغيرات لمعرفة تفاصيل استخدامها.
4. خطط للتحديث التالي، لا للإطلاق الأول فقط
قبل دعوة المستخدمين، اضبط فحص جاهزية HTTP على مسار مثل /healthz، بحيث لا يستجيب بالنجاح إلا عندما يكون التطبيق جاهزًا لخدمة الطلبات. فتح منفذ TCP وحده لا يعني أن التطبيق انتهى من التهيئة.
في الخدمات التي لا ترتبط بوحدة تخزين، يشغّل رصيف الإصدار الجديد بجانب الإصدار الحالي وينقل إليه الطلبات بعد نجاح فحص الجاهزية. أما الخدمة المرتبطة بوحدة تخزين فتُعاد تهيئتها أثناء النشر، وقد تتوقف لفترة قصيرة. ضع ذلك في حسابات الإطلاق.
يعيد التراجع عن النشر صورة الخدمة وإعداداتها السابقة ضمن المدة التي تسمح بها خطتك، لكنه لا يتراجع عن ترحيلات قاعدة البيانات ولا يستعيد محتواها. يُفضّل تنفيذ تغييرات متوافقة مع الإصدار السابق من التطبيق، حتى يظل التراجع ممكنًا عند الحاجة. اقرأ دليل عمليات النشر قبل أول تحديث.
النشر التلقائي عند كل دفع إلى GitHub اختياري، ويكون معطلًا للخدمة الجديدة. فعّله عندما يصبح الفرع ومسار إصدار التحديثات جاهزين، وتحقق منه مجددًا بعد تعديل إعدادات المصدر، لأن حفظها يعطّله.
قائمة تحقق قبل استقبال أول مستخدمي SaaS
- افتح رابط HTTPS ونفّذ رحلة كاملة، مثل التسجيل وإنشاء سجل جديد.
- أعد تشغيل التطبيق أو نشره، ثم تأكد من بقاء السجل في PostgreSQL.
- راجع سجلات بدء التشغيل والطلبات دون طباعة بيانات الدخول أو المفاتيح.
- تأكد من أن مسار فحص الجاهزية يعكس جاهزية التطبيق الفعلية.
- راجع التخزين والنسخ الاحتياطي: تشمل الخطط المدفوعة نسخًا احتياطية لوحدات التخزين، بينما لا تشملها الخطة المجانية. حدد طريقة الاستعادة واختبرها.
- أضف نطاقًا مخصصًا عندما تستعد لمشاركة رابط يحمل اسم منتجك.
- راجع حدود المنصة والأسعار وفق احتياج التطبيق المتوقع.
أطلق المنتج وتعلّم من استخدامه الحقيقي
النتيجة المهمة ليست ظهور حالة نشر ناجحة فقط، بل أن يستطيع العميل فتح تطبيقك، وإنجاز مهمة، والعودة إلى بياناته المحفوظة، وأن يعرف فريقك كيف ينشر التحسين التالي.
يجمع رصيف النشر من GitHub، والاتصال الخاص بين الخدمات، والوصول العام عبر HTTPS في مسار واحد، مع استضافة أحمال العمل داخل السعودية. ابدأ بتطبيق واحد وقاعدة بيانات واحدة، وتحقق من رحلة العميل، ثم وسّع البنية عندما يحتاج المنتج إلى ذلك.
اطلب الوصول إلى تجربة رصيف الخاصة لتنتقل بمستودعك نحو أول إصدار متاح للعملاء. وإذا كان لديك حساب، فابدأ من دليل البداية السريعة.