ربط Collabora Online بـ ownCloud Infinite Scale

استخدم خدمة التعاون في ownCloud Infinite Scale كجسر WOPI بين واجهة المستخدم الرسومية وCollabora Online. في حالة التثبيت الجديد، يُعدّ استخدام ocis_fullمثال Docker Compose الرسمي من ownCloud، والذي يتضمن Infinite Scale وCollaboration وCollabora وTraefik، الخيار الأمثل. حدّد عناوين URL العامة لـ Infinite Scale وCollabora وWOPI، واستخدم شهادات TLS صالحة، وحافظ على اتساق جميع بيانات الخدمة السرية. لا تُهيّئ هذا الإعداد كما لو كان Infinite Scale خادم ownCloud تقليديًا.

هذا التمييز مُوضّح في وثائق ownCloud الحالية: يدمج Infinite Scale حزم البرامج المكتبية عبر WOPI وخدمة التعاون الخاصة به. تحل هذه الخدمة محل cs3org/wopiالخادم الخارجي القديم في الإصدارات الأحدث، لذا يجب على المسؤولين الذين يُحدّثون نظامًا قديمًا اتباع تعليمات الترقية الخاصة بإصدارهم المُثبّت.

1. تحقق من متطلبات الإصدار والشبكة

تأكد من إصدار Infinite Scale المحدد قبل تثبيت أي شيء. تشير وثائق ownCloud الحالية إلى أن خدمة التعاون موجودة في وثائق تطوير الإصدار 9.0، وتنص على ضرورة تشغيلها بشكل منفصل عند تشغيل Infinite Scale في وضع الإشراف. كما يحذر مثال ownCloud الكامل من أن الإعداد يعتمد على الإصدارات التي تحتوي على خدمة التعاون، ولا يعمل مع إصدارات الإنتاج 5.x. استخدم الوثائق وملفات Compose المتوافقة مع الإصدار المُثبّت لديك؛ ولا تنسخ مثالًا متجددًا إلى نظام إنتاج قديم دون التحقق من التوافق.

للنشر العام، خطط لأسماء مضيفين منفصلة مثل cloud.example.com`< اسم المضيف office.example.com>` و`< wopi.example.comاسم المضيف>` و`<اسم المضيف>`. يجب أن يتمكن المتصفح من الوصول إلى عناوين URL الخاصة بالسحابة وCollabora، بينما يجب أن تتمكن Collabora من الوصول إلى نقطة نهاية WOPI التي توفرها Infinite Scale. يجب أن تعمل أنظمة أسماء النطاقات (DNS) وجدران الحماية وثقة TLS في كلا الاتجاهين. لا يكفي وجود مضيف يمكن الوصول إليه من جهاز الكمبيوتر المحمول الخاص بك ولكن ليس من حاوية Collabora.

يستخدم مثال نشر ownCloud برنامج Traefik كخادم وكيل عكسي، ويتطلب شهادة SSL صالحة لإعداد الخادم. يمكن لإعداد الاختبار المحلي استخدام شهادات موقعة ذاتيًا، ولكن يجب ألا تُعطّل عمليات التثبيت العامة التحقق من الشهادات تلقائيًا. حدد أسماء المضيفين والشهادات التي ستستخدمها قبل تهيئة البنية التحتية.

2. ابدأ من مثال Compose المطابق في ownCloud

1. افتح دليل نشر نظام oCIS الكامل المعياري مع WebOffice الرسمي من ownCloud ، بالإضافة إلى دليل الأمثلة ocis_full ذي الصلة . للاستخدام في بيئة الإنتاج، استخدم إصدارًا أو علامةً تتوافق مع إصدار Infinite Scale الخاص بك، بدلاً من الاعتماد على الفرع المتداول في المستودع.
2. راجع ملف المثال .env. عيّن OCIS_DOMAINأسماء المضيفين التي تُشير إلى خادمك. يُفعّل المثال برنامج Collabora باستخدام هذا الإعداد COLLABORA_DOMAIN؛ احتفظ بهذا الإعداد إذا كنت ترغب في استخدام Collabora كمحرر مكتبي.WOPISERVER_DOMAINCOLLABORA=:collabora.yml
3. قم بتعيين بيانات اعتماد قوية وخاصة للمسؤول، واتبع إرشادات TLS الخاصة بالإنتاج في المثال. لا تترك كلمات المرور التجريبية كما هي. إذا تم تغيير أسماء متغيرات البيئة أو بنية الملفات في إصدار المستودع، فاستخدم الملفات من نفس الإصدار المُوسَم بدلاً من استخدام تعليمات من إصدارات مختلفة.
4. راجع إعدادات Compose قبل تشغيلها. تأكد من أن خدمات Collabora وCollaboration وInfinite Scale والوكيل تشترك في نفس الشبكة والإعدادات المطلوبة. يُنبه دليل ownCloud إلى أنه في حال تشغيل Collaboration في حاوية منفصلة، ​​يجب مشاركة إعدادات Infinite Scale ذات الصلة والبيانات السرية المُنشأة مع الخدمات الأخرى.

يُعد مثال النشر هذا حزمة متكاملة، وليس تكوينًا عامًا لكل تثبيت موجود. إذا كنت تستخدم بالفعل Infinite Scale مع systemd أو Kubernetes أو وكيل عكسي مخصص، فاحتفظ بنموذج النشر هذا وقم بتكوين خدمة التعاون وسجل التطبيقات باستخدام وثائق هذا الإصدار بدلاً من إنشاء حزمة كاملة ثانية.

3. ربط التعاون بـ Collabora باستخدام WOPI

تحدد الإعدادات الأساسية عنوان URL الخاص بالمحرر ومصدر WOPI الذي يمكن الوصول إليه خارجيًا. في وثائق الخدمة الحالية، COLLABORATION_APP_NAMEيُمثل اسم التطبيق المعروض، COLLABORATION_APP_PRODUCTويُحدد المنتج، COLLABORATION_APP_ADDRويشير إلى Collabora، بينما COLLABORATION_WOPI_SRCيُمثل عنوان URL الذي تستخدمه Collabora لقراءة وكتابة الملفات عبر Infinite Scale. يبدو التكوين المفاهيمي كما يلي:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

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

تتطلب خدمة التعاون أيضًا قيم وقت التشغيل Infinite Scale OCIS_URL، OCIS_JWT_SECRETو، OCIS_REVA_GATEWAYو، و MICRO_REGISTRY_ADDRESS. يجب أن تتطابق هذه القيم مع مثيل التشغيل؛ يوفر مثال التطبيق الكامل الرسمي علاقات الخدمة لشبكة Compose الخاصة به. لا تقم بإنشاء أسرار جديدة لخدمة واحدة فقط أو تعطيل فحوصات مفتاح إثبات WOPI لتجاوز عدم التطابق. أبقِ التحقق من الشهادة مُفعّلاً للشهادات العامة الموثوقة؛ COLLABORATION_APP_INSECUREموثق فقط كخيار لشهادة تطبيق WOPI ذاتية التوقيع، وليس كحل عام للإنتاج.

يتحكم سجل التطبيقات في تطبيق Office الذي يظهر لكل نوع MIME والتطبيق الذي يُفتح افتراضيًا. إذا كان Collabora قيد التشغيل ولكن المستندات لا تُظهر خيار "فتح باستخدام"، فتحقق من إعدادات نوع MIME في السجل وقيمته default_app. يجب أن يتطابق الاسم المستخدم هناك مع اسم تطبيق Office المُكوّن. توثق ownCloud هذا كإعداد YAML؛ ولا تحل متغيرات البيئة محل تعيين نوع MIME.

4. ابدأ عملية التكامل واختبرها وشخص مشاكلها

باستخدام مثال Compose الرسمي، تحقق من صحة التكوين المُعالَج ثم ابدأ تشغيل المكدس من دليل النشر الخاص به:

docker compose config
docker compose up -d

إذا كنت لا تستخدم مثال Compose، فابدأ أولاً خدمات البوابة وموفر التطبيقات وCollaboration. في الوضع المُشرف، تُوثّق ownCloud بدء تشغيل Collaboration صراحةً باستخدام الأمر `cs` ocis collaboration server؛ فهو لا يبدأ تلقائيًا. تأكد من ملء متغيرات البيئة المطلوبة في عملية خدمة Collaboration قبل بدء تشغيلها.

1. افتح https://office.example.com/hosting/discoveryفي متصفح. يجب أن تُرجع نقطة النهاية التي يمكن الوصول إليها ملف XML الخاص باكتشاف Collabora بدلاً من خطأ DNS أو TLS أو الوكيل.
2. سجّل الدخول إلى Infinite Scale، وافتح مستندًا مدعومًا، واختر Collabora إذا كانت واجهة المستخدم تعرض تطبيقات مكتبية متعددة. اختبر كلاً من ملف موجود، وإذا كان ذلك مُفعّلاً في سجل التطبيقات، فأنشئ مستندًا جديدًا.
3. قم بإجراء تعديل بسيط، وانتظر حتى يستقر مؤشر الحفظ، ثم أغلق المحرر، وأعد فتح الملف للتأكد من استمرار التغيير.
4. إذا لم يفتح المحرر، فافحص سجلات Infinite Scale Collaboration وApp Provider، وسجلات Collabora، وسجلات الخادم الوكيل العكسي في نفس الطابع الزمني. تشير رسالة "مضيف WOPI غير مصرح به" إلى إعدادات ثقة WOPI في Collabora؛ ويشير فشل رد الاتصال أو خطأ TLS إلى إمكانية الوصول إلى عنوان URL أو موثوقية الشهادة؛ ويشير خيار التطبيق المفقود إلى سجل التطبيقات.

يعني التكامل الناجح تحميل المتصفح للمحرر، ووصول اتصال WOPI إلى Infinite Scale، وحفظ التعديلات بعد إعادة فتحه. تعتمد أسماء الحاويات الدقيقة، وربط عناوين URL، ومواقع ملفات التكوين على إصدار Infinite Scale وطريقة النشر. استخدم وثائق ownCloud المتوافقة مع الإصدار للاطلاع على هذه التفاصيل، خاصةً عند الترحيل من خادم WOPI الخارجي القديم.

المراجع: تكوين خدمة التعاون في ownCloud ، وتكوين سجل تطبيقات ownCloud ، وملاحظات إصدار Infinite Scale وملاحظات الترحيل .