النشر على Railway

Railway يوفر تجربة نشر سهلة لعقد Kora مع شهادة SSL تلقائية وإدارة النطاقات ومراقبة مدمجة. سيرشدك هذا الدليل خلال إعداد عقدة Kora على Railway باستخدام صورة Docker بسيطة وواجهة سطر أوامر Railway.

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

• حساب Railway
• واجهة سطر أوامر Railway مُثبتة
• واجهة سطر أوامر سولانا لإنشاء المفتاح الخاص
• نقطة نهاية RPC لسولانا

الخطوة 1: تحضير ملفات النشر

أنشئ دليلاً جديداً لعقدة Kora الخاصة بك:

mkdir my-kora-node
cd my-kora-node

أضف الملفات النموذجية إلى دليلك:

• kora.toml
• signers.toml
• Dockerfile

يجب أن يبدو دليلك الآن كالتالي:

my-kora-node/
├── kora.toml
├── signers.toml
└── Dockerfile

الخطوة 2: النشر على Railway

من دليل مشروعك، قم بتسجيل الدخول إلى Railway

# Login to Railway
railway login

اتبع التعليمات الظاهرة على الشاشة لتسجيل الدخول بحسابك.

قم بتهيئة مشروع Railway في دليلك.

railway init

سيطالبك Railway بـ:

1. إنشاء مشروع جديد أو اختيار مشروع موجود
2. اختيار اسم للمشروع (مثلاً، "my-kora-node")

نشر تطبيقك

# Deploy the application
railway up

سيؤدي هذا إلى:

• رفع ملفاتك إلى Railway
• بناء صورة Docker
• نشر تطبيقك

الناتج المتوقع:

Build time: 121.81 seconds
Deploy complete
Starting Container

رائع! لقد أكملنا الإعداد! ربما ستلاحظ وجود خطأ في السجلات ("error: a value is required for --rpc-url <RPC_URL> but none was supplied "). هذا لأننا لم نقم بعد بتكوين متغيرات البيئة--لذا دعنا نفعل ذلك الآن.

الخطوة 3: تكوين متغيرات البيئة

افتح لوحة تحكم Railway الخاصة بك على railway.app وانتقل إلى مشروعك. في مشروعك، انقر على "الإعدادات" > "المتغيرات"

متغيرات البيئة في Railway لـ Kora

أضف متغيرات البيئة التالية:

تحذير أمني: مفتاحك الخاص لديه إمكانية الوصول إلى SOL لدفع الرسوم. استخدم زوج مفاتيح مخصص لعقدة Kora الخاصة بك وقم بتمويله فقط بمقدار SOL الذي ترغب في إنفاقه على رسوم المعاملات. للمزيد من المعلومات حول الموقّعين، راجع دليل الموقّعين.

الحصول على مفتاحك الخاص

إذا كنت بحاجة إلى إنشاء زوج مفاتيح جديد:

# Generate new keypair
solana-keygen new --outfile ~/.config/solana/kora-keypair.json

تأكد من إيداع كمية كافية من SOL للاختبار/تشغيل عقدتك.

الخطوة 4: إعادة النشر

بعد حفظ متغيراتك، ستُطالب بإعادة نشر الخادم الخاص بك--قم بذلك.

الخطوة 5: اختبار النشر الخاص بك

إنشاء نقطة نهاية عامة

لإرسال الطلبات إلى نقطة النهاية الخاصة بك، ستحتاج إلى إنشاء نطاق عام. من عملية النشر الخاصة بك، انتقل إلى "الإعدادات" > "إنشاء نطاق".

إعداد النطاق في Railway

استخدم المنفذ الافتراضي، "8080" وانقر على "إنشاء نطاق".

يجب عليك الحصول على نطاق مثل https://my-kora-node.railway.app/

نقطة نهاية اختبار الإعدادات

curl -X POST https://my-kora-node.railway.app \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getConfig","params":[]}' | jq

الاستجابة المتوقعة:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "fee_payer": "YourPublicKeyHere...",
    "validation_config": {
      "max_allowed_lamports": 1000000,
      "allowed_programs": [...],
      "allowed_spl_paid_tokens": [...]
      // ...
    }
  }
}

أحسنت! عقدة Kora الخاصة بك نشطة الآن.

هل تحتاج إلى مساعدة؟

• دليل مشغلي عقدة Kora - المشاكل الشائعة والحلول
• وثائق Railway - مساعدة خاصة بالمنصة
• مشاكل GitHub - الإبلاغ عن الأخطاء أو الحصول على الدعم
• منصة Solana Stack Exchange - طرح الأسئلة/مشاركة المعرفة (تأكد من استخدام وسم kora)