Railway هي منصة بنية تحتية حيث يمكنك توفير البنية التحتية وتطويرها محليًا ثم نشرها في السحابة. تتيح عمليات النشر الفوري من GitHub بدون أي تكوين و SSL تلقائي وتوفير قاعدة بيانات مدمج.

يرشدك هذا الدليل خلال نشر تطبيق Bun مع قاعدة بيانات PostgreSQL (اختياري)، وهو ما يوفره القالب أدناه تمامًا.

يمكنك إما اتباع هذا الدليل خطوة بخطوة أو ببساطة نشر القالب المُهيأ مسبقًا بنقرة واحدة:

---

المتطلبات الأساسية:

• تطبيق Bun جاهز للنشر
• حساب Railway
• Railway CLI (لطريقة النشر عبر CLI)
• حساب GitHub (لطريقة النشر عبر لوحة التحكم)

---

الطريقة 1: النشر عبر CLI

الخطوة 1

تأكد من تثبيت Railway CLI.

bun install -g @railway/cli

الخطوة 2

سجل الدخول إلى حساب Railway الخاص بك.

railway login

الخطوة 3

بعد المصادقة بنجاح، قم بتهيئة مشروع جديد.

railway init

الخطوة 4

بعد تهيئة المشروع، أضف قاعدة بيانات وخدمة جديدة.

NOTE

الخطوة 4 ضرورية فقط إذا كان تطبيقك يستخدم قاعدة بيانات. إذا لم تكن بحاجة إلى PostgreSQL، انتقل إلى الخطوة 5.

# إضافة قاعدة بيانات PostgreSQL. تأكد من إضافتها أولاً!
railway add --database postgres

# إضافة خدمة التطبيق الخاص بك.
railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}

الخطوة 5

بعد إنشاء الخدمات وربطها، قم بنشر التطبيق إلى Railway. بشكل افتراضي، يمكن الوصول إلى الخدمات فقط داخل شبكة Railway الخاصة. لجعل تطبيقك متاحًا للعامة، تحتاج إلى إنشاء نطاق عام.

# نشر التطبيق الخاص بك
railway up

# إنشاء نطاق عام
railway domain

تطبيقك الآن يعمل! يقوم Railway بالنشر التلقائي مع كل دفعة GitHub.

---

الطريقة 2: النشر عبر لوحة التحكم

الخطوة 1

إنشاء مشروع جديد

1. انتقل إلى لوحة تحكم Railway
2. انقر على "+ New" → "GitHub repo"
3. اختر المستودع الخاص بك

الخطوة 2

أضف قاعدة بيانات PostgreSQL، واربط قاعدة البيانات هذه بالخدمة

NOTE

الخطوة 2 ضرورية فقط إذا كان تطبيقك يستخدم قاعدة بيانات. إذا لم تكن بحاجة إلى PostgreSQL، انتقل إلى الخطوة 3.

1. انقر على "+ New" → "Database" → "Add PostgreSQL"
2. بعد إنشاء قاعدة البيانات، حدد الخدمة الخاصة بك (وليس قاعدة البيانات)
3. انتقل إلى علامة التبويب "Variables"
4. انقر على "+ New Variable" → "Add Reference"
5. حدد DATABASE_URL من postgres

الخطوة 3

إنشاء نطاق عام

1. حدد الخدمة الخاصة بك
2. انتقل إلى علامة التبويب "Settings"
3. ضمن "Networking"، انقر على "Generate Domain"

تطبيقك الآن يعمل! يقوم Railway بالنشر التلقائي مع كل دفعة GitHub.

---

التكوين (اختياري)

بشكل افتراضي، يستخدم Railway Nixpacks للكشف تلقائيًا عن تطبيق Bun وبنائه بدون أي تكوين.

ومع ذلك، يوفر استخدام منشئ التطبيقات Railpack دعمًا أفضل لـ Bun و سيدعم دائمًا أحدث إصدار من Bun. تستخدم القوالب المُهيأة مسبقًا Railpack بشكل افتراضي.

لتفعيل Railpack في مشروع مخصص، أضف ما يلي إلى railway.json الخاص بك:

{
  "$schema": "https://railway.com/railway.schema.json",
  "build": {
    "builder": "RAILPACK"
  }
}

لمزيد من إعدادات تكوين البناء، راجع وثائق Railway.