N8n 2.30.4 – استعادة آمنة لعقدة مفقودة مع حماية المعرّف والإصدار الأصليين

مرحبا بك في مجتمع n8n،

نحتاج إلى إرشادات بشأن إصلاح سير عمل موجود بأمان في n8n 2.30.4 ذاتي الاستضافة، دون المخاطرة بتغييرات غير مقصودة.

الوضع الحالي

  • سير العمل غير نشط وغير منشور.
  • يحتوي حاليًا على 26 عقدة.
  • عقدة جدول البيانات واحدة (n8n-nodes-base.dataTable، typeVersion 1.1) مفقودة.
  • العقدة المفقودة الأصلية لها معرّف b4-17.
  • تم التحقق من النسخ الاحتياطية لسير العمل الحالي والتصميم الأصلي ذي 27 عقدة.
  • يجب استعادة العقدة المفقودة فقط واتصالاتها الاثنان.
  • يجب أن تظل جميع العقد الموجودة والبيانات الاعتماديّة والمسارات المتعلقة بـ webhook وإعدادات سير العمل والهوية الخاصة به دون تغيير.

حاولنا سابقًا لصق جزء JSON جزئي في المحرر وقد غيّر ذلك بشكل غير متوقع عنوان سير العمل. توقفنا وقمنا لاحقًا باستعادة العنوان المقصود.

نحن لا نريد تكرار هذا الأسلوب بدون حماية موثوقة.

الأسئلة

1. استعادة عقدة برقم معرّف أصلي

هل يدعم محرر n8n 2.30.4 الأصلي إدراج أو استعادة عقدة مع الحفاظ على معرّف JSON الأصلي الدقيق (b4-17)؟

إذا لم يكن هذا مدعومًا، هل الحفاظ على معرّف العقدة الأصلي ضروريًا من الناحية الفنية، شريطة أن تظل اسم العقدة والمعاملات والتعبيرات والاتصالات صحيحة؟

هل هناك أي مراجع داخلية أو آليات قد تعتمد على هذا المعرّف؟

2. حماية تضارب الإصدارات

هل يحمي n8n 2.30.4 بشكل موثوق من التعديلات المتزامنة عند حفظ سير عمل من خلال المحرر؟

بالنسبة لنقطة نهاية واجهة برمجية التطبيقات PUT /api/v1/workflows/{id}، هل توفر versionId قفل تفاؤلي فعال في هذا الإصدار المحدد؟

تشير وثائق واجهة برمجية التطبيقات الحالية إلى قفل تفاؤلي، لكن versionId يظهر أيضًا كقراءة فقط في مخطط التحديث. نود الحصول على توضيح بشأن السلوك المدعوم الفعلي.

3. أسلم إجراء إصلاح مدعوم رسميًا

ما هو الأسلوب الموصى به لاستعادة عقدة مفقودة واحدة بالضبط واتصالاتها الاثنان في سير عمل موجود غير نشط؟

أولوياتنا هي:

  • الحفاظ على معرّف سير العمل والعنوان الموجودة.
  • الحفاظ على كل عقدة موجودة واتصال غير ذي صلة.
  • الحفاظ على البيانات الاعتماديّة ومسارات webhook وإعدادات الأمان.
  • منع التنشيط أو النشر غير المقصود.
  • إنشاء مقارنة JSON كاملة قبل وبعد.
  • تجنب الكتابة فوق التغييرات المتزامنة.

هل توصي بعملية محرر محكومة أم تحديث واجهة برمجية لـ n8n 2.30.4؟

نود بشكل خاص الحصول على إشارات إلى الوثائق الرسمية أو كود المصدر ذي الصلة بالإصدار المحدد.

لأسباب أمنية، لا ننشر ملف JSON سير العمل الكامل أو مفاتيح واجهة برمجية التطبيقات أو البيانات الاعتماديّة أو تفاصيل البنية التحتية الداخلية.

شكرًا على مساعدتك!

مرحباً @Zafer_Imre، في الإصدار 2.30.4 معالج PUT العام يعيّن forceSave: true. لذلك فإن تمرير versionId لا يحمي من الكتابة فوق التغيير المتزامن.

  1. لصق الحافظة العادي يعيد إنشاء معرّفات العقدة. يطبّق المستورد أيضاً name على مستوى أعلى، والذي يمكن أن يعيد تسمية سير العمل. تستخدم الاتصالات العادية وتعبيرات اسم العقدة الأسماء، لذلك عادة لا يكون b4-17 مطلوباً للتوجيه. لا تزال المعرّفات مهمة في أماكن أخرى، على سبيل المثال nodeGroups.nodeIds.

  2. يرسل المحرر expectedChecksum، لكن المتحكم يتجاوز هذا الفحص عند تعطيل دعم المشاركة. عملية فحص قيمة التجزئة والتحديث في قاعدة البيانات منفصلة. لا توفر أي من المسارات حماية ذرية غير مشروطة versionId في هذا الإصدار.

  3. إذا كان يجب الاحتفاظ بـ b4-17، فسأستخدم واجهة برمجية التطبيقات العامة مع حظر جميع كتّاب المحرر/واجهة برمجية التطبيقات الآخرين، وإعادة بروفة الإصلاح على نسخة معزولة 2.30.4 أولاً. احصل على GET جديد لسير العمل الحالي المكون من 26 عقدة وادمج كائن العقدة الأصلي فقط، مع الحفاظ على معرّفه و typeVersion 1.1، بالإضافة إلى الاتصالين المقصودين. استخدم الرسم البياني الحالي كأساس، بدلاً من استبداله بنسخة احتياطية قديمة من 27 عقدة. راجع الفرق المقصود قبل إرسال PUT إلى معرّف سير العمل الموجود.

يجب أن يتبع جسم PUT مخطط قابل للكتابة في هذا الإصدار، بما في ذلك name والعقد والاتصالات الكاملة وsettings؛ لا ترسل استجابة GET الكاملة مع البيانات الوصفية للقراءة فقط. تأكد من أن activeVersionId فارغ قبل التحديث: هذا المسار ينشر مجدداً سير عمل منشوراً بالفعل، لكنه لا ينشر سير عمل غير منشور.

احصل عليه مرة أخرى واحتفظ بفرق JSON الكامل قبل/بعد. توقع تغييرات المراجعة والطابع الزمني التي يديرها الخادم؛ تحقق من بقاء العنوان والعقد الموجودة والإشارات إلى بيانات الاعتماد ومسارات webhook والإعدادات والاتصالات غير ذات الصلة دون تغيير. لا يمكن لمقارنة GET/compare قبل PUT وحدها منع سباق. إذا لم يكن المعرّف الأصلي مطلوباً، فإعادة إنشاء العقدة واتصالاتها فقط في المحرر أبسط.

مصدر 2.30.4:

الطريقة الأكثر أماناً هي تجاوز لصق المحرر تماماً. قم بتصدير JSON سير العمل، أضف كائن العقدة مرة أخرى إلى مصفوفة العقد برقم معرفها الأصلي، ثم أضف مدخلاته الاثنين تحت الاتصالات يدوياً. استورد ذلك كسير عمل جديد، قارنه مقابل نسختك الاحتياطية، وفقط بعد ذلك استبدله.

تصدير ملف JSON لسير العمل الخام وإدراج كتلة العقدة يدويًا برقم معرّفها الأصلي يحافظ على جميع مراجع المسامير التابعة ويمنع خطوط الاتصال المكسورة.

اختبار سير العمل الملصوق على مسودة مكررة قبل حفظ التغييرات على سير العمل النشط يضمن لك تجنب توقف الإنتاج العرضي.