قوالب التطبيق وremix

التوفر

سير عمل بيان القالب وسجل التطبيق منفّذ. يمكنه إدراج بيانات يعدّها المشغّل، وإنشاء سجل تطبيق جديد من أحدها، وزرع قيم بيئة غير سرية عندما يكون مخزن البيئة معدا، وإنشاء سجل remix نظيف من تطبيق مؤهل.

الاستنساخ لا ينشر التطبيق. قواعد البيانات، والحاويات، وخدمات المصادقة المعلنة لا تُجهَّز تلقائيا. بعض الخدمات المعلنة نفسها stub فقط، لذا إعلان بيان ليس دليلا على وجود اعتماد.

تصفح البيانات


GET /api/apps/templates?category=web&q=next
GET /api/apps/templates/{template_id}

المعرض للقراءة العامة. يصف البيان URL مصدر Git، وفرعا، وافتراضيات تشغيل، ومخطط متغيرات بيئة، وخدمات معلنة. راجع المستودع، والمراجعة الحالية، والرخصة، وحالة الصيانة، وأوامر التشغيل قبل الاستنساخ. البيان بيانات مشغّل وصفية، وليس تزكية أمنية.

يجعل بيانان بذريان مبنيان مسبقا واجهة API غير فارغة. يمكن لمستودعاتهما الخارجية أن تتغير أو تختفي، وليس هناك بعد اختبار دخان آلي لكل بذرة.

استنسخ


POST /api/apps/templates/{template_id}/instantiate
Content-Type: application/json
 
{
  "name": "My app",
  "env": {
    "NEXT_PUBLIC_APP_NAME": "My app"
  }
}

ينشئ الاستدعاء سجل تطبيق خاصا ويعيد app_id، ومعلومات المصدر، ونوع التشغيل، والخدمات المعلنة. تُقبل فقط المفاتيح التي يعلنها البيان. حقول السر لا تُزرع بهذا الاستدعاء.

بعد الاستنساخ:

افحص مصدر التطبيق الجديد وإعدادات تشغيله؛
قدّم الأسرار عبر متغيرات بيئة التطبيق؛
وفّر الاعتمادات الخارجية الحقيقية بنفسك ما لم تُبلَّغ خدمة بأنها جاهزة صراحة؛
استدعِ نقطة نهاية النشر؛ و
تابع النشر عبر البناء، وفحص الصحة، والتفعيل.

Remix


POST /api/apps/{source_app_id}/remix
Content-Type: application/json
 
{
  "name": "My private remix"
}

يجوز للمالكين عمل remix لتطبيقهم. يجوز لمستخدم آخر عمل remix فقط لتطبيق عام ومعلّم كقابل لـ remix معا. التطبيق الجديد خاص.

يحمل remix عنوان مصدر، وفرعا، ونوع نشر، ومنفذا، ونسبا. يتعمد عدم نسخ قيم البيئة، أو الأسرار، أو مراجع قاعدة البيانات أو الحاوية، أو روابط المصادقة، أو نقاط التحقق، أو حالة IDE، أو البيانات. كذلك لا يعمل fork للمستودع البعيد ولا يثبّت مراجعته. إذا غيّر مالك المصدر ذلك المستودع لاحقا أو أزاله، يمكن أن يختلف نشر جديد أو يفشل.

لـ remix دائم، اعمل fork للمصدر إلى مستودع تتحكم به، راجع وثبّت مراجعة، حدّث مصدر التطبيق الجديد، ثم انشر.

قائمة نشر قالب

قبل تقديم قالب كقابل للاستخدام:

أكد المستودع والرخصة؛
ثبّت أو سجّل مراجعة مختبرة؛
تحقق من سلوك التثبيت، والبناء، والتشغيل، والمنفذ، والصحة؛
اختبر حقول البيئة المطلوبة دون كشف أسرار؛
تحقق من أن كل خدمة معلنة متاحة فعلا؛ و
استنسخ، وانشر، واختبر دخانا، وأزله في بيئة نظيفة.