إدارة الخادم المحلي
استخدمyarn twenty docker:* للتحكّم في حاوية Twenty المحلية:
تظل البيانات محفوظة عبر عمليات إعادة التشغيل في وحدتي تخزين Docker (
twenty-app-dev-data لـ PostgreSQL، وtwenty-app-dev-storage للملفات). استخدم reset لمسح كل شيء.
تثبيت إصدار الخادم
عند عدم تمرير أي إصدار، يقومdocker:start باشتقاق الإصدار من النطاق engines.twenty في ملف package.json لتطبيقك — وهو نفس النطاق الذي يتحقق منه الخادم عند تثبيت تطبيقك. يشغّل أحدث صورة منشورة لـ twenty-app-dev التي تُلبي هذا النطاق، مع الرجوع إلى latest عندما يكون الحقل غير موجودًا أو لا يتطابق أي إصدار منشور:
yarn twenty docker:start 2.3.0. إذا كانت هناك حاوية موجودة بالفعل على إصدار مختلف، يقوم docker:start بترقيتها في مكانها (مع إعادة إنشاء الحاوية مع الحفاظ على وحدات تخزين بياناتك).
ترقية صورة الخادم
يقومyarn twenty docker:upgrade بسحب أحدث صورة، ومقارنة التجزئات، ولا يعيد إنشاء الحاوية إلا إذا حدث تغيير فعلي. تظل وحدات التخزين محفوظة — ويتم استبدال الحاوية فقط. إذا تم سحب صورة جديدة وكانت الحاوية تعمل، فستبدأ عملية الترقية تلقائيًا حاوية جديدة؛ شغّل بعد ذلك yarn twenty docker:start للانتظار حتى تصبح سليمة.
yarn twenty docker:status (يعرض قيمة APP_VERSION المضمنة في الحاوية).
تشغيل مثيل اختبار متوازٍ
مرّر--test إلى أي أمر docker:* لإدارة مثيل ثانٍ معزول تمامًا — مفيد لاختبارات التكامل أو للتجربة من دون لمس بيانات التطوير الرئيسية لديك:
يملك مثيل الاختبار حاويته الخاصة (
twenty-app-dev-test) ووحدات التخزين الخاصة به (twenty-app-dev-test-data، twenty-app-dev-test-storage) وتهيئته — ويعمل جنبًا إلى جنب مع مثيلك الرئيسي بدون تعارضات. اجمع --test مع --port لتجاوز المنفذ 2021.
إعداد يدوي (بدون أداة توليد الهيكل)
تجاوز أداة توليد الهيكل إذا كنت تضيف SDK إلى مشروع قائم:package.json:
yarn twenty dev، وyarn twenty docker:start، والبقية.
لا تثبّت
twenty-sdk عالميًا — ثبِّته لكل مشروع بحيث يستخدم كل تطبيق إصداره الخاص.