كيفية إعداد مزرعة تصيير Blender Flamenco: ضبط Manager وWorker

ما الذي ستتعلمه في هذا الدليل؟

يوفّر Blender Flamenco سير عمل لتوزيع مهام التصيير بين مكوّنَي Manager وWorker. سنتناول في هذا الدليل وظيفة ملفات إعداد Manager وWorker، وكيفية تحديد مسار التخزين المشترك، وأنواع المهام التي يمكن أن يتولاها Worker، خطوةً خطوة. كما سنتطرق إلى وظيفة أمر تصيير Blender والنقاط التي ينبغي التحقق منها أثناء الإعداد.

يتولى Manager إدارة المهام، بينما ينفّذ Worker المهام. وتُتابَع حالات الأعمال والمهام كلٌّ على حدة؛ فعلى سبيل المثال، يمكن أن تنتقل حالة العمل إلى «مكتمل» بعد إنجاز مهامه بنجاح. تشمل أوامر Flamenco تصيير Blender، وتحويل تسلسل الصور إلى فيديو باستخدام FFmpeg، وعمليات إدارة الملفات.

المتطلبات وملفات الإعداد

لا تحدد الأدلة الرسمية إصدارًا معينًا من Blender، أو حزمة تثبيت، أو متطلبات حساب، أو رسوم ترخيص. لذلك لا نفترض هنا إصدارًا محددًا من البرامج أو متطلبات للأجهزة. تفترض الأمثلة توفّر بيئة Flamenco تتيح تعديل إعدادات Manager وWorker وضبط مساحة تخزين مشتركة.

يقرأ Manager إعداداته من الملف flamenco-manager.yaml. ويوجد هذا الملف بجوار الملف التنفيذي flamenco-manager. إذا لم يكن الملف موجودًا عند تشغيل Manager للمرة الأولى، فسيظهر معالج الإعداد. أما Worker فيقرأ إعداداته الأساسية من الملف flamenco-worker.yaml الموجود في دليل التشغيل. يمكن مشاركة هذا الملف الأساسي بين عدة Workers، لكن بيانات اعتماد Worker وقاعدة بيانات تحديثات المهام تكون منفصلة لكل Worker.

إعداد Manager وWorker

1. أنشئ ملف Manager. استخدم معالج الإعداد عند التشغيل الأول. وإذا احتجت إلى إعداد الملف يدويًا، يوضح المثال التالي الإعدادات الأساسية:

_meta:
  version: 3
manager_name: Flamenco Manager
database: flamenco-manager.sqlite
listen: ":8080"
autodiscoverable: true
local_manager_storage_path: ./flamenco-manager-storage
shared_storage_path: /path/to/storage
shaman:
  enabled: true
  garbageCollect:
    period: 24h
    maxAge: 744h

يحدد manager_name اسم Manager، بينما يحدد database مسار ملف قاعدة بيانات SQLite. أما الإعداد listen فيعرّف عنوان IP والمنفذ اللذين سيستقبل Manager الاتصالات من خلالهما. وتشير الوثائق الرسمية إلى أن هذا العنوان يُستخدم لواجهة الويب وواجهة API وإرسال الملفات عبر Shaman، وأنه المنفذ الوحيد الذي يحتاج إليه Manager. ويحدد autodiscoverable ما إذا كان بإمكان Workers على الشبكة نفسها العثور على Manager تلقائيًا.

يُستخدم local_manager_storage_path لملفات Manager المحلية، بينما يُستخدم shared_storage_path للأعمال والمخرجات التي يصل إليها Manager وWorker معًا. استبدل المسار /path/to/storage في المثال بالموقع المشترك المستخدم في بيئتك. نظام تخزين Shaman اختياري؛ وهو مفعّل في المثال، الذي يعرض أيضًا مدد تنظيف الملفات.

1. حدّد اتصال Worker ونطاق المهام. يمكنك تحديد عنوان Manager وأنواع المهام التي سيقبلها Worker في ملف الإعداد المشترك:

manager_url: http://flamenco.local:8080/
task_types: [blender, ffmpeg, file-management, misc]
restart_exit_code: 47

إذا تُرك manager_url فارغًا أو حُذف، فسيحاول Worker العثور على Manager عبر الشبكة. أما task_types فتحدّد المهام التي يمكن إسنادها إلى Worker. تضم القائمة في المثال الأنواع التي تستخدمها نصوص تجميع الأعمال الافتراضية؛ لذا تحقّق من توافق الإعدادات إذا كانت نصوص تجميع الأعمال لديك تُنتج أنواعًا مختلفة. وتتيح قيمة restart_exit_code غير الصفرية وضع علامة على Worker بأنه قابل لإعادة التشغيل.

1. احتفظ بالملفات الخاصة بكل Worker. لكل Worker ملف بيانات اعتماد باسم flamenco-worker-credentials.yaml، وقاعدة بيانات flamenco-worker.sqlite تضع تحديثات المهام في قائمة انتظار عند تعذّر الوصول إلى Manager. هذه الملفات منفصلة عن ملف الإعداد الأساسي، وليست مصممة للتعديل اليدوي. المواقع الافتراضية المذكورة في الدليل هي $HOME/.local/share/flamenco على Linux، وC:\Users\UserName\AppData\Local\Blender Foundation\Flamenco على Windows، و$HOME/Library/Application Support/Flamenco على macOS.

2. تابع مهمة Blender. تُنفّذ مهام تصيير Blender باستخدام الأمر blender-render. يستخدم الأمر الملف التنفيذي لـBlender وملف .blend المراد فتحه، إلى جانب الوسائط الإضافية الواردة من نص تجميع الأعمال. إذا عُرّف الملف التنفيذي باسم blender، فسيبحث عنه Worker؛ ويمكنه أيضًا الاستفادة من اقتران ملفات .blend في Windows. تُرسل الصور الناتجة أثناء التصيير بواسطة Worker لتظهر كمعاينات في واجهة Manager.

تُتابَع الأعمال والمهام بحالات منفصلة. ويمكن إسناد المهام الموجودة في قائمة الانتظار إلى Workers المناسبين؛ ويكتمل العمل عند نجاح جميع المهام. أما إذا فشلت إحدى المهام حتى بعد إعادة تجربتها على Workers مختلفين، فقد ينتقل العمل إلى حالة الفشل. تؤدي إعادة عمل مكتمل إلى قائمة الانتظار إلى إعادة إدراج جميع مهامه، بينما لا تُعاد إلى القائمة في العمل الذي يتضمن مهام غير مكتملة إلا تلك المهام.

تأثير ذلك في سير عمل العمارة والتصميم الداخلي والتصور المعماري

يمكن للمكاتب المعمارية وفرق التصور التي تستخدم Blender توزيع مهام التصيير عبر إضافة عدة Workers إلى سير العمل نفسه. ويساعد حصر أنواع المهام لكل Worker على تنظيم أنواع الأعمال التي يتولاها الجهاز، مثل تصيير Blender أو إدارة الملفات أو FFmpeg. كما تشمل الخيارات الموثقة أمر FFmpeg الذي يحوّل تسلسل الصور إلى فيديو.

يكتسب الوصول إلى الملفات والتوافق أهمية خاصة أثناء الإعداد. يجب أن تكون ملفات .blend ومخرجات التصيير موجودة في تخزين مشترك يمكن لـManager وWorker الوصول إليه. كذلك ينبغي أن تتوافق إعدادات task_types مع المهام التي تنتجها نصوص تجميع الأعمال. وتشير الأدلة إلى أن تكرار أخطاء المهام قد يرتبط بكون العمل مرهقًا لأجهزة Worker؛ لذلك من المفيد متابعة حالات فشل الأعمال. وبما أن الوثائق لا تحدد متطلبات الأجهزة أو توافق إصدارات Blender أو تكلفة الترخيص، فينبغي التحقق من هذه الأمور على نحو منفصل بحسب البيئة المستخدمة.

أخطاء شائعة

• استخدام مسار تخزين غير صحيح: لا يؤدي دليل التخزين المحلي لـManager الغرض نفسه الذي يؤديه التخزين المشترك. حدّد موقعًا مشتركًا لملفات الأعمال ومخرجات التصيير.

• تعذّر حصول Worker على مهام: تحقّق من إعدادَي manager_url وtask_types، ومن أنواع المهام التي تنتجها نصوص تجميع الأعمال.

• مشاركة الملفات الخاصة بـWorker: بيانات الاعتماد وقاعدة بيانات تحديثات المهام خاصتان بكل Worker، ولا ينبغي الخلط بينهما وبين ملف الإعداد الأساسي.

• ترك سجل قديم عند إعادة الضبط: لإعادة ضبط Worker، أوقفه واحذف ملفاته المحلية المعنية، ثم أزل سجل Worker القديم من واجهة Manager على الويب، وبعد ذلك أعد تشغيل Worker.

• إضافة إعدادات اختيارية دون حاجة: إعداد MQTT غير إلزامي. إذا لم تكن تعرف الغرض منه، يُنصح بعدم إضافته إلى الإعدادات.

الخطوات التالية

ابدأ بالتحقق من الإعداد الأساسي باستخدام Manager وWorker واحد. بعد ذلك، تأكد من إمكانية الوصول إلى ملفات الأعمال من التخزين المشترك، ومن قدرة Worker على استلام أنواع المهام المتوقعة. إذا احتجت إلى تحويل تسلسل الصور إلى فيديو، فراجع إعدادات الأمر frames-to-video. ويمكن أيضًا النظر في الإعداد الاختياري oom_score_adjust عند استخدام Linux؛ فهذا الخيار مخصص لنظام Linux، ويقبل قيمًا من 0 إلى 1000، وقد أُضيف في Flamenco v3.5.

المصدر والترخيص

أُعدّ هذا الدليل بالاستناد إلى الأدلة الرسمية المفتوحة الترخيص الخاصة بإعداد Manager وWorker، وبالأعمال والمهام والأوامر في Flamenco، وتُرجم إلى التركية.