شغّل تطبيقك على حسابك الخاص في Cloudflare
باختصاراربط رمز API من Cloudflare في الخدمات السحابية ← السحابة، فيعمل تطبيقك على حسابك الخاص في Cloudflare، بـ Worker الخاص بك وقاعدة بيانات D1 الخاصة بك ونطاقك وفاتورتك، بدلًا من حساب MonstarX. وتستطيع شفرته أيضًا استخدام خدمات Cloudflare مثل KV وR2 وQueues وVectorize وWorkers AI، التي ينشئها MonstarX على حسابك.
ينشر MonstarX كل تطبيق على سحابته الخاصة، دون أن تدير أنت أي شيء. أما إن كان نشاطك التجاري يستخدم Cloudflare أصلًا، أو كنت تريد أن يكون التطبيق وبياناته وفاتورته باسمك، فاربط حسابك في Cloudflare. يتغير أمران:
- الاستضافة. عندما تنشر، يذهب التطبيق إلى حسابك أنت في Cloudflare: Worker الخاص بك (البرنامج الذي يقدّم التطبيق)، وقاعدة بيانات D1 الخاصة بك (قاعدة بيانات SQL من Cloudflare)، ونطاقك، وفاتورتك.
- خدمات Cloudflare. تستطيع شفرة تطبيقك استخدام خدمات Cloudflare الأخرى، كالتخزين وقوائم الانتظار والذكاء الاصطناعي وغيرها، ويعدّها MonstarX على حسابك نيابةً عنك.
قبل أن تبدأ
Section titled “قبل أن تبدأ”تحتاج إلى رمز API من Cloudflare. في Cloudflare، انتقل إلى Manage Account → API Tokens، وأنشئ رمزًا من القالب Edit Cloudflare Workers، وأضف D1: Edit. ثم أضف الصلاحية الخاصة بكل خدمة إضافية تريد أن يستخدمها التطبيق:
| الخدمة | الغرض منها | الصلاحية التي تضيفها |
|---|---|---|
| KV | مخزن سريع لأزواج المفاتيح والقيم، للإعدادات والذاكرة المؤقتة ومفاتيح تفعيل الميزات والرموز قصيرة الأجل | Workers KV Storage: Edit |
| R2 | تخزين ملفات دون رسوم على التنزيل: الملفات المرفوعة والصور وملفات التصدير والنسخ الاحتياطية | Workers R2 Storage: Edit |
| Queues | مهام في الخلفية: تسلّم العمل ضمن طلب وتُنهيه لاحقًا، مع إعادة المحاولة | Queues: Edit |
| Vectorize | فهرس متجهات للبحث حسب المعنى | Vectorize: Edit |
| Workers AI | نماذج ذكاء اصطناعي مفتوحة للنصوص والتمثيلات المتجهية والصور، على حسابك | Workers AI: Edit |
| Browser Rendering | متصفح حقيقي للقطات الشاشة وملفات PDF والنص المقروء من أي صفحة | Browser Rendering: Edit |
| Images | تخزين الصور وتغيير أحجامها، مع نسخ متعددة وعنوان للعرض | Cloudflare Images: Edit |
| Analytics Engine | تسجيل أحداثك الخاصة بأي حجم والاستعلام عنها بـ SQL | Account Analytics: Read |
كيف أربط حسابي في Cloudflare؟
Section titled “كيف أربط حسابي في Cloudflare؟”-
افتح مشروعك وانقر على الخدمات السحابية في الشريط العلوي، ثم على السحابة.
-
في قسم الموصلات، انقر على ربط بجانب Cloudflare. (يفتح إنشاء رمز صفحة الرموز في Cloudflare إن لم تكن قد أنشأت رمزًا بعد.)
-
الصق الرمز في حقل رمز API وانقر على ربط Cloudflare.
-
إذا كان الرمز يصل إلى أكثر من حساب، فاختر الحساب الذي يجب أن يعمل عليه التطبيق وانقر على استخدام هذا الحساب. وإن لم يتمكن MonstarX من عرض حساباتك بهذا الرمز، يطلب منك معرّف الحساب (32 محرفًا، يظهر في لوحة تحكم Cloudflare).
يتحقق MonstarX بعد ذلك مما يُسمح للرمز بفعله. لن يربط MonstarX الحساب دون صلاحيتَي Workers وD1، وسيخبرك بالضبط بالصلاحية التي يجب إضافتها. وإن كانت خدمة إضافية غير متاحة، يذكر ذلك، «لا يتيح هذا الرمز الوصول إلى …»، ويبقى الباقي يعمل.
كيف أنشر على حسابي الخاص؟
Section titled “كيف أنشر على حسابي الخاص؟”بعد الربط، تعرض بطاقة Cloudflare في الخدمات السحابيةالسحابة حسابك ومفتاح تشغيل باسم تشغيل هذا التطبيق في حساب Cloudflare الخاص بي. عندما يكون مفعّلًا، يوضح نشر أنه سينشر التطبيق «على حساب Cloudflare الخاص بك» ويذكر الحساب والعنوان.
عندما تنشر:
- ينشئ MonstarX قاعدة بيانات D1 باسم المشروع على حسابك (أو يعيد استخدام قاعدة بالاسم نفسه)، ويعدّ كل الجداول التي يحتاج إليها التطبيق.
- ينشئ التطبيق ويرفعه كـ Worker باسم تطبيقك.
- يجيب التطبيق على
your-app.your-subdomain.workers.dev، أو على نطاقك الخاص.
لاستخدام أحد نطاقاتك، انقر على استخدام نطاقي في بطاقة Cloudflare. يعرض MonstarX النطاقات الموجودة في حسابك في Cloudflare، فاختر واحدًا، واكتب العنوان (النطاق نفسه أو أي عنوان تحته)، وانقر على استخدام هذا العنوان. يضيف Cloudflare سجل DNS وشهادة HTTPS. ويسري التغيير في المرة التالية التي تنشر فيها. ويعيدك استخدام workers.dev إلى العنوان السابق.
كيف يستخدم تطبيقي خدمات Cloudflare؟
Section titled “كيف يستخدم تطبيقي خدمات Cloudflare؟”اطلب ما تريده: «احفظ الصور المرفوعة في R2»، «خزّن قائمة الطعام مؤقتًا في KV»، «لخّص المراجعات باستخدام Workers AI». ينشئ MonstarX الخدمة على حسابك (باسم المشروع، أو يعيد استخدام خدمة بالاسم نفسه)، ويربطها بالتطبيق، ويكتب الشفرة. وتعمل في المعاينة فورًا أيضًا.
ويمكنك أيضًا إدارتها بنفسك من قائمة خدمات Cloudflare في بطاقة Cloudflare: انقر على إضافة لإضافة خدمة، وأعطها اسمًا قصيرًا (مثل uploads أو sessions)، وانقر على إنشاء. أما إيقاف استخدامها فيفصل الخدمة عن التطبيق، ولا يُحذف شيء في Cloudflare، وتبقى البيانات في حسابك.
من المفيد أن تعرف
Section titled “من المفيد أن تعرف”- حدودك وفاتورتك. يحاسب Cloudflare حسابك على ما يستخدمه التطبيق. وحدود الطلبات في Cloudflare لكل حساب، فالتطبيق المزدحم على حسابك لا يبطئ تطبيقات غيرك أبدًا، وتطبيقاتهم لا تبطئ تطبيقك.
- إلغاء النشر يحذف Worker من حسابك، وتبقى قاعدة بيانات D1 والخدمات الأخرى.
- تغيير الحساب أو قطع اتصاله يُرفض ما دام التطبيق منشورًا عليه. ألغِ النشر أولًا، أو أوقف تشغيل هذا التطبيق في حساب Cloudflare الخاص بي وانشر. ونقل التطبيق إلى حسابك أو منه يزيل Worker من مكانه السابق.
- بياناتك في Supabase أو Railway؟ يواصل التطبيق استخدام تلك القاعدة، ولا تُنشأ له قاعدة بيانات D1.
- التطبيقات المستوردة تُنشر على حسابك كملفات ثابتة ينتجها الإنشاء الخاص بها. ولا تحصل على قاعدة بيانات، ولا تستطيع استخدام أداة خدمات Cloudflare المساعدة.
- ملفات التصدير تتضمن إعداد Cloudflare نفسه، فيربط
wrangler deployمن الشفرة المنزّلة الخدمات نفسها. راجع صدّر شفرتك.
الأسئلة الشائعة
Section titled “الأسئلة الشائعة”ما الصلاحيات التي يحتاج إليها الرمز؟
ابدأ من القالب Edit Cloudflare Workers في Cloudflare وأضف D1: Edit. ثم أضف صلاحية لكل خدمة إضافية، مثل Workers R2 Storage: Edit لخدمة R2.
لماذا تختلف بيانات تطبيقي المنشور عن المعاينة؟
على حسابك الخاص في Cloudflare يملك التطبيق المنشور قاعدة بيانات D1 خاصة به تبدأ فارغة. وتحتفظ المعاينة ببيانات MonstarX التجريبية، فتختبر دون المساس بسجلات عملائك الحقيقيين.
هل يمكنني استخدام نطاقي الخاص؟
نعم، إن كان النطاق في حسابك في Cloudflare. انقر على استخدام نطاقي في بطاقة Cloudflare، واختر النطاق، واكتب العنوان، وانشر مجددًا.
هل يحذف MonstarX أي شيء من حسابي في Cloudflare؟
لا يحذف إلا Worker الخاص بالتطبيق، عندما تلغي النشر أو تنقل التطبيق من الحساب. أما قواعد البيانات والخدمات فلا يحذفها إيقاف استخدامها أبدًا.
هل يمكنني العودة إلى استضافة MonstarX؟
نعم. أوقف تشغيل هذا التطبيق في حساب Cloudflare الخاص بي وانشر مجددًا. ويُزال Worker من حسابك بعد أن ينتقل التطبيق إلى MonstarX.