ابدأ مع تطبيقات الويب
تطبيق الويب تطبيق تبنيه المنصّة من مستودع GitHub وتشغّله لك، في حاوية خاصة به على الشبكة الخاصة لمساحة عملك. تكتشف المنصّة بنية مشروعك، وتبني صورة، وتقدّمها عبر HTTPS على اسم مضيف خاص بها، وتعيد البناء مع كل دفعة إلى الفرع الذي تتابعه. وإن أخفق إصدار جديد في فحص السلامة، يبقى الإصدار السابق يقدّم الخدمة.
قبل أن تبدأ
- دور في مساحة العمل: مالك أو مسؤول أو مطوّر.
- حساب على GitHub يستطيع رؤية المستودع.
1. اربط GitHub
يُربط GitHub بحسابك مرة واحدة، ثم يصبح متاحًا في كل مساحة عمل تنتمي إليها.
- افتح الحساب ← التكاملات واختر ربط GitHub تحت GitHub.
- اختر تثبيت تطبيق GitHub، وحدّد حساب GitHub أو المؤسسة التي تملك المستودع، ثم اختر على GitHub المستودعات التي يُسمح للتطبيق برؤيتها.
ولتوسيع الاختيار لاحقًا، استخدم عدّل صلاحيات تطبيق GitHub في صفحة الاستيراد، أو صفحة التكاملات نفسها.
2. استورد المستودع
افتح تطبيقات الويب واختر نشر تطبيق. وفي استيراد مستودع Git، اختر المستودع، ثم املأ:
- الفرع: الفرع الذي تنشره. والدفع إليه يبدأ عملية نشر.
- المجلد الجذر: اتركه
./، أو حدّد المجلد الذي يُبنى منه في المستودع الأحادي (monorepo). - النشر التلقائي: مفعّل، لإعادة النشر مع كل دفعة.
- اسم التطبيق: أحرف لاتينية صغيرة وأرقام وشُرَط داخلية، مثل
storefront. ويصبح جزءًا من رابط التطبيق. - الموارد المتصلة: اربط نسخة من مساحة العمل، فيُضاف رابط اتصالها متغيّرَ بيئة يشير إلى اسمها الخاص.
- متغيرات البيئة: الإعدادات والأسرار التي يحتاجها تطبيقك. الصق ملف
.envكاملًا في حقل مفتاح لتُضاف كل أسطره دفعة واحدة.
اختر نشر. فيبدأ البناء الأول فورًا.
3. تابع النشر
يسرد تبويب عمليات النشر للتطبيق كل بناء، ويفتح كل صف سجل البناء الحيّ الخاص به. وتمرّ عملية النشر بالخطوات استنساخ المستودع ثم اكتشاف إطار العمل ثم بناء الصورة ثم نشر الحاوية ثم مباشر. وتُذكر الخطوة الفاشلة باسمها، ومعها مخرجات البناء.
تكتشف المنصّة Next.js وNuxt وAstro وSvelteKit وReact Router وVite وNode.js وPython وGo والمواقع الساكنة، وتبني ملف Dockerfile الخاص بك حين يحتوي المستودع على واحد. ولتثبيت طريقة البناء، أودِع ملف sahabti.json في المستودع: انظر إعدادات البناء.
4. افتحه
يُقدَّم التطبيق على اسم مضيف خاص به، يظهر في صفحته بمجرد إنشائه:
https://storefront-k3x9mq.sahabti.app
ويفتحه زر زيارة. ويجب أن يستمع تطبيقك على المنفذ الذي تمنحه إياه المنصّة: انظر تشغيل تطبيق الويب.
5. أضف نطاقك الخاص
افتح صفحة النطاقات للتطبيق واختر إضافة نطاق. أدخل اسم مضيف تملكه، مثل www.example.com، ثم اختر إعداد بجانبه:
- أثبت ملكيتك للنطاق بسجل TXT الذي يعرضه، مرة واحدة لكل نطاق.
- وجّه اسم المضيف إلى المنصّة بسجل CNAME يشير إلى
apps.sahabti.app.
وما إن يُتحقَّق من النطاق ويُنشر سجل CNAME، حتى تصدر الشهادة من تلقاء نفسها ويظهر اسم المضيف نشط. ويبقى الرابط الافتراضي يعمل. انظر ابدأ مع النطاقات.
عبر PromptOps
في مساحة عمل شُغّل فيها PromptOps، اطلب ما تريد في المحادثة. وهو يستأذنك قبل أن يغيّر أي شيء، وقبل أن يقرأ سجلات تطبيقك:
- «لماذا فشل آخر نشر لـ storefront؟»
- «أعد نشر storefront.»
- «أرجِع storefront إلى عملية النشر التي سبقت الأخيرة.»
- «اعرض ما طبعه storefront في الساعة الأخيرة.»
واستيراد مستودع ليس من إجراءاته: انشر التطبيق الجديد من لوحة التحكم.
عبر الواجهة البرمجية أو MCP
يقرأ استيراد المستودع حسابك أنت على GitHub، لذا يتطلب أن تكون قد سجّلت الدخول إلى لوحة التحكم. وبعدها يستطيع مفتاح API بإجراءات project أن يسرد التطبيقات، ويقرأ عمليات النشر، ويعيد النشر:
curl -X POST "https://api.sahabti.com/v1/apps/$APP_ID/redeploy" \
-H "x-api-key: $SAHABTI_TOKEN"
يسرد GET /v1/apps?orgId=$WORKSPACE_ID تطبيقات مساحة العمل مع معرّفاتها. وعبر MCP، استخدم list_apps وlist_deployments وget_app_logs وredeploy_app.
ما التكلفة
لا حجم تختاره. انظر صفحة الأسعار لتعرف ما تشمله كل خطة، وصفحة الاستخدام لتعرف ما استهلكته تطبيقات مساحة العمل هذا الشهر.
الفحوص الأولى
- تظهر أحدث عملية نشر مباشر، ويفتح زر زيارة التطبيق عبر HTTPS.
- تعرض صفحة السجلات ما يطبعه التطبيق، مباشرةً.
- تسرد صفحة العمليات العمليات قيد التشغيل.
- يظهر كل اسم مضيف من أسمائك الخاصة في النطاقات بحالة نشط.
الخطوات التالية
- تطبيقات الويب — النشر عند الدفع، وإعادة النشر، والتراجع، ومتغيّرات البيئة
- إعدادات البناء — ثبّت طريقة البناء بملف
sahabti.json - تشغيل تطبيق الويب — المنفذ، وفحص السلامة، والعمليات، والأسماء الخاصة
- ابدأ مع قواعد البيانات — قاعدة بيانات لتطبيقك