البيئة المحلية

ابدأ Twenty محليًا

ثبّت Docker وابدأ تشغيله، ثم نفّذ:

twenty local start
twenty auth login --url http://localhost:2020 --name local

يشغّل local start واجهة الويب وAPI والعامل وقواعد البيانات. يعمل خارج مجلد التطبيق وينتظر حتى تصبح البيئة جاهزة، ويطبع عنوان URL الخاص بها. تسجيل الدخول خطوة منفصلة. لتثبيت تطبيقك بعد ذلك، شغّل twenty app apply --create --remote local من دليله. بالنسبة إلى مثيل جديد، مرّر إصدارًا صراحةً أو دع واجهة سطر الأوامر تختار أعلى إصدار منشور يطابق engines.twenty الخاص بتطبيقك. خارج تطبيق يتضمن هذا الإعداد، يستخدم latest. تحتفظ المثيلات الحالية بإصدارها وبياناتها. بالنسبة إلى مثيل موجود، يُتحقق من التوافق مع engines.twenty باستخدام APP_VERSION الخاص بالصورة، بما في ذلك عندما تكون علامتها latest. يؤدي الإصدار المفقود أو غير الصالح أو غير المتوافق إلى إصدار تحذير ومتابعة بدء التشغيل.

twenty local start 2.53.1
twenty local status
twenty local logs
twenty local logs --lines 100 --no-follow
twenty local stop

تستمع المثيلات الجديدة فقط على واجهة الاسترجاع المحلي، على المنفذ 2020. استخدم --port \<port> عند إنشاء مثيل لاختيار منفذ آخر. استخدم سياق مقبس Docker محليًا؛ لا تدعم هذه الأوامر محركات Docker البعيدة.

الترقية أو إعادة التعيين

twenty local upgrade 2.53.1

تسحب الترقية الصورة المطلوبة قبل استبدال المثيل. تحافظ على منافذه وقاعدة بياناته ووحدات تخزين ملفاته وتجاوزات البيئة الخاصة به. تُطبَّق الإعدادات الافتراضية الجديدة لـ CLI على المثيلات المنشأة حديثًا؛ وتحافظ الترقيات على قيم البيئة الحالية. من دون إصدار، يتبع اختيار الإصدار نفسه كما في بدء جديد. تُرفَض تخطيطات التخزين المخصصة. تُرفَض عمليات الرجوع إلى إصدار أقدم قبل استبدال الحاوية، بما في ذلك عند استخدام وسم مثل latest. يجب أن تعلن كلتا الصورتين عن APP_VERSION صالح حتى يتمكن CLI من مقارنة إصداريهما الفعليين. مرّر 2.53 للبدء أو الترقية باستخدام وسم صورة v2.53 العائم، أو 2.53.1 لاختيار إصدار تصحيح محدد. إذا فشل إنشاء البديل أو أُلغي، يستعيد CLI الحاوية والإعدادات السابقتين. بمجرد بدء الإصدار الجديد، تحتفظ الترقيات الفاشلة بوحدات تخزين البيانات، لكنها لا تتراجع عن ترحيلات قاعدة البيانات. يحتفظ stop بجميع البيانات. لحذف المثيل وبياناته نهائيًا، شغّل:

twenty local reset
twenty local start

يطلب إعادة التعيين التأكيد. يجب أن تمرر البرامج النصية --yes. لا تُزال الاتصالات البعيدة المحفوظة وبيانات الاعتماد.

اختبارات التكامل

استخدم مثيل الاختبار المنفصل، بالمنفذ الافتراضي 2021:

twenty local start --test
twenty local status --test
TWENTY_API_URL=http://localhost:2021 yarn test

عيّن TWENTY_API_KEY إلى مفتاح لذلك المثيل. تثبّت اختبارات التكامل تطبيقًا وتلغي تثبيته، لذا أبقها منفصلة عن مساحة عمل التطوير الخاصة بك. مرّر --test إلى السجلات أو الإيقاف أو الترقية أو إعادة التعيين عند إدارة هذا المثيل. يوفّر سير عمل CI المُنشأ مثيلًا معزولًا عبر twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main ويثبّت واجهة سطر الأوامر المستقلة بشكل منفصل.

إعدادات محلية أخرى

بالنسبة إلى نسخة مصدر تم سحبها من Twenty، تعمل بيئة التطوير الحالية أيضًا:

bash packages/twenty-utils/setup-dev-env.sh
yarn start
twenty auth login --url http://localhost:3000 --name local --use

استخدم عنوان URL والمنفذ الفعليين لخادمك. بالنسبة إلى مساحات العمل ذات النطاقات الفرعية، استخدم اسم مضيف مساحة العمل. للنشر في بيئة الإنتاج، اتبع دليل الاستضافة الذاتية.

تبعيّات المشروع

يُعلن twenty app init عن twenty-sdk وtwenty-client-sdk وtwenty-ui في devDependencies، لكنه لا يثبّتها. بعد تثبيت واجهة سطر الأوامر twenty على مستوى النظام، شغّل yarn install من دليل التطبيق المُنشأ قبل تشغيل twenty app typecheck أو twenty app build أو twenty app apply.

المطورون

التطبيقات

واجهة برمجة التطبيقات

الاستضافة الذاتية

المساهمة

مكتبة واجهة المستخدم

ابدأ Twenty محليًا

الترقية أو إعادة التعيين

اختبارات التكامل

إعدادات محلية أخرى

تبعيّات المشروع

​ابدأ Twenty محليًا

​الترقية أو إعادة التعيين

​اختبارات التكامل

​إعدادات محلية أخرى

​تبعيّات المشروع

ابدأ Twenty محليًا

الترقية أو إعادة التعيين

اختبارات التكامل

إعدادات محلية أخرى

تبعيّات المشروع