لا تفيد عملية النشر إلا إذا استطاعت المنصة تشغيل ما تقبله. يحدد IaGenify SDK 0.3.1 بيئة التشغيل عند إنشاء الاستضافة: موقع ثابت أو شيفرة تعمل على Edge.
نوعان من المشاريع ومساران واضحان
للموقع الثابت، أنشئ البناء بإطار العمل الذي تستخدمه ثم أرسل الملفات الناتجة إلى استضافة `runtime: "static"`. تشمل الخيارات الموثقة HTML وVite وReact SPA وVue وAngular وAstro والتصدير الثابت لـ Next.js. تقدم المنصة الملفات من دون تشغيل عملية Node.js دائمة.
const site = await api.hosts.create({
label: "Product website",
runtime: "static",
framework: "vite",
});
await site.deploy({ files: "./dist" });لمعالج الطلبات، اختر `runtime: "edge"` مع Worker أو Hono. يتضمن النشر المعالج الذي يعمل على Edge ولا يعتمد على خادم Node.js دائم.
const endpoint = await api.hosts.create({
label: "Status endpoint",
runtime: "edge",
framework: "hono",
});
await endpoint.deploy({ code: source });الحد الواضح جزء من واجهة البرمجة
يختلف تصدير Next.js الثابت عن تطبيق Next.js الذي يحتاج إلى العرض على الخادم. يمكن نشر الأول كملفات، أما الثاني فيتطلب خادماً دائماً لا تدّعي هذه الخدمة توفيره. وتحتاج Express وFastify وNest أيضاً إلى بيئة دائمة.
يتحقق SDK من توافق بيئة التشغيل وإطار العمل قبل الرفع. ويُرفض الطلب غير المدعوم بوضوح بدلاً من إنشاء عنوان لا يستطيع خدمة التطبيق.
أنشئ البناء محلياً وانشر الناتج
يواصل الفريق استخدام خطوات البناء المعتادة: ينشئ Vite مجلد `dist` مثلاً، ثم ينشر SDK الملفات. أما تطبيق Edge فينشر المعالج. لا تدّعي المنصة تثبيت أي اعتماد أو تشغيل عملية عامة باستمرار.
يسهّل هذا الفصل الأتمتة أيضاً: يمكن لمسار العمل بناء الموقع ونشره، بينما يعالج endpoint منفصل على Edge الطلبات الخفيفة.
ينبغي لواجهة النشر أن توضح ما تستطيع تشغيله قبل قبول المشروع.
وعد أوضح للمطورين
يجعل SDK 0.3.1 استضافة IaGenify أكثر تحديداً: للمواقع الثابتة ومعالجات Edge مساران مباشران، وتظهر حدود الخدمة منذ إنشاء الاستضافة.
الأسئلة الشائعة
هل يمكنني نشر خادم Express أو Fastify؟
لا. البيئات الموثقة هي الملفات الثابتة ومعالجات Edge، ولا توفر خادماً دائماً لـ Node.js.
هل يمكنني نشر موقع Next.js؟
نعم، إذا بُني كتصدير ثابت. العرض على الخادم يتطلب بيئة تشغيل دائمة.
هل يبني SDK مشروعي؟
المسار الموثق هو إنشاء البناء محلياً ثم نشر ملفاته الناتجة، مثل `./dist`.
ما فائدة حقل runtime؟
يحدد ما إذا كانت الاستضافة تقدم ملفات ثابتة أو تشغل معالج Edge، ويسمح بالتحقق من إطار العمل المناسب.