نقل ownCloud Classic إلى oCIS باستخدام عملية ترحيل مدعومة
خطط لعملية ترحيل من ownCloud 10 إلى oCIS باستخدام التطبيق المدعوم، والأوامر المرتبة، وفحوصات الهوية، وقائمة واضحة بالبيانات التي تحتاج إلى معالجة منفصلة.
بالنسبة لخادم ownCloud Server Classic 10، أنشئ علامتك التجارية كتطبيق سمات وضعها في مجلد تطبيقات مخصص لتقليل احتمالية استبدالها عند التحديث. استخدم هذه السمة لاستبدال الشعارات وتحديد ألوان CSS؛ إذ لا يوجد منتقي ألوان مدمج عام يطبق ألوان العلامة التجارية بشكل عشوائي على واجهة الويب. تغطي الخطوات التالية واجهة مستخدم الويب الخاصة بخادم Classic، وليس ownCloud Infinite Scale.
تم التحقق: يدعم ownCloud Classic 10 السمات كتطبيقات. يمكن للسمة تجاوز CSS والصور والقوالب والترجمات. ويشير دليل المطور الرسمي أيضًا إلى أن themeالإعداد القديم config.phpقد تم إيقافه في Classic 10. الإجراء: حدد منتجك وإصدارك قبل تغيير الملفات: هذا الإجراء خاص بـ ownCloud Server Classic 10.
يعتمد ذلك على إصدارك: خدمة ownBrander من ownCloud هي خيار تصميم علامة تجارية رسومية مُخصص لعملاء المؤسسات. تتيح هذه الخدمة إنشاء سمة ويب وتطبيقات تحمل علامة تجارية؛ ويعتمد الوصول إليها على اشتراك المؤسسات وأهلية الحساب. الإجراء: إذا كان لديك اشتراك المؤسسات، فاسأل مسؤول ownCloud أو جهة الاتصال بحسابك عما إذا كانت خدمة ownBrander مُفعّلة. وإلا، فاستخدم تطبيق سمة وتحقق من صحته على نسخة تجريبية.
سوء فهم شائع:theme.json يستخدم نظام Infinite Scale (oCIS) نموذج تخصيص ويب مختلفًا، بما في ذلك ملفات التكوين والسمات الخاصة به. لا تنطبق تعليمات oCIS على سمات Classic Server. الإجراء: لا تنسخ الملفات أو التكوين من دليل oCIS إلى تثبيت Classic Server.
من الافتراضات الشائعة الأخرى أن تغيير الشعار في شاشة الإعدادات يُغيّر جميع الشعارات والألوان والعملاء تلقائيًا. يشرح دليل مطوري Classic Server كيفية تجاوز السمات المستندة إلى نظام الملفات؛ وتعتمد إمكانية توفر الميزات وعلامة العميل التجارية على الإصدار والطريقة. الإجراء: خطط لصفحة تسجيل الدخول، وعنوان المستخدم المسجل، وأيقونة الموقع، وأي عملاء سطح مكتب أو جوال كفحوصات منفصلة.
قم بعمل نسخة احتياطية من نظامك واختبره أولاً على نسخة تجريبية. سجّل إصدار ownCloud، وحزمة PHP/runtime، ومجلدات التطبيقات، ومستخدم خادم الويب، وإعدادات القوالب الحالية. يُوصي الدليل الرسمي بتخزين القوالب المخصصة في مجلد تطبيقات مخصص لتقليل احتمالية فقدانها أثناء التحديثات. الإجراء: حدد موقع مجلد التطبيقات المخصص الذي قمت بتكوينه، أو استخدم apps-externalالمجلد الموثق إن وُجد؛ لا تفترض أن جميع الحزم تستخدم المسار نفسه.
يحتاج تطبيق السمة appinfo/info.xmlإلى ملف يحتوي على مُعرّف تطبيق مطابق لمجلده، ونوع <theme/>، ونطاق تبعيات ownCloud. يستخدم مثال دليل المطورين الإصدار Classic 10 كحد أدنى وأقصى. عدّل هذا ليتناسب مع الإصدارات التي تدعمها فعليًا بدلًا من نسخ نطاق عشوائي. الإجراء: ابدأ من مثال السمة الرسمي لـ ownCloud وراجع ملفاته الحالية قبل تعديله.
على سبيل المثال، قد يُسمى مجلد السمات theme-acmeويحتوي على ملفات appinfo/info.xmlو core/css/styles.cssو وتعديلات الصور ضمن مسارات تُطابق مسارات ownCloud المقابلة. <id>يجب أن يتطابق اسم المجلد مع القيمة. الإجراء: احتفظ بالسمات تحت نظام التحكم في الإصدارات واستخدم مُعرّفًا فريدًا لتجنب التعارض مع التطبيقات المُثبّتة.
لاستبدال صورة، احتفظ بمسارها النسبي داخل القالب. على سبيل المثال، المسار الافتراضي لشعار تسجيل الدخول هو ` /usr/local/ user core/img/logo-icon.svg...theme-acme/core/img/logo-icon.svg
لتغيير الألوان، أنشئ core/css/styles.cssملفًا في القالب. يوثّق الدليل الرسمي مُحدِّدات الألوان، مثل #body-loginخلفية تسجيل الدخول #body-public #headerوعنوان الصفحة بعد تسجيل الدخول. مثال بسيط:
#body-login {
background: #17324d;
}
#body-public #header {
background-color: #17324d;
}
يُغيّر هذا من خصائص تلك المناطق الموثقة؛ فهو ليس مجموعة ألوان كاملة للعلامة التجارية لكل تطبيق أو نافذة حوار أو واجهة طرف ثالث. الإجراء: استخدم أدوات مطوري المتصفح على نسختك لتحديد المكون المقصود، ثم أضف قواعد CSS محددة النطاق إلى ورقة أنماط السمة. تجنب المحددات العامة التي قد تجعل النص أو الأزرار أو حالات التركيز غير قابلة للقراءة.
استخدم شعارًا بديلًا يتناسب مع المساحة المتاحة، وتحقق من تباين النص العادي والروابط وعناصر التحكم وحالة التركيز باستخدام لوحة المفاتيح. قد تختلف المحددات الدقيقة وأبعاد العناصر باختلاف الإصدار المُثبَّت والسمة والتطبيقات. الإجراء: قارن التعديلات التي أجريتها مع DOM والعناصر الحالية في بيئة الاختبار بدلًا من افتراض أن المحدد القديم لا يزال متطابقًا.
بعد وضع القالب في مجلد التطبيق الصحيح وتعيين ملكيته ليتمكن خادم الويب من قراءته، قم بتفعيله باستخدام occأمر التثبيت. يُقدّم الدليل الرسمي docker compose exec owncloud occ app:enable theme-acmeمثالاً لتطبيق Docker؛ أما التطبيقات التي لا تستخدم Docker، فيجب عليها استخدام سياق الأوامر الخاص بها. يُمكن أيضًا تفعيل القوالب من شاشة تطبيقات الإدارة، حيث تظهر ضمن التطبيقات المعطلة. الإجراء: اتبع صيغة الأمر الخاصة بنشرك، وتأكد من تطابق مُعرّف التطبيق مع المجلد والبيانات الوصفية.
قد لا يحتوي قالب خاص على توقيع من متجر التطبيقات. توضح وثائق ownCloud كيفية إضافة مُعرّف التطبيق integrity.ignore.missing.app.signatureعند الحاجة لتجنب تحذير عدم وجود توقيع. هذا الاستثناء خاص بالقالب الخاص غير المُوقّع؛ ولا يعني تعطيل فحص سلامة الملفات بشكل عام. الإجراء: أضف مُعرّف القالب فقط إلى قائمة السماح الموثقة إذا أبلغ تثبيتك عن هذا التحذير، مع الحفاظ على جميع إجراءات حماية سلامة الملفات الأخرى.
يجب أن تسمح أذونات ملفات تطبيق القالب لخادم الويب بقراءة الملفات. تختلف أسماء المستخدمين والمجموعات باختلاف الحزمة والمضيف؛ لذا فإن www-dataالمثال المذكور في الوثائق ليس عامًا. الإجراء: تحقق من الحساب الفعلي للخدمة قيد التشغيل، وحدد ملكية مجلد القالب بدقة.
افتح صفحة تسجيل الدخول في نافذة متصفح خاصة، ثم سجّل الدخول وتفحّص رأس الصفحة، وقائمة التنقل، وقائمة الملفات، وصفحات الإعدادات، وأحجام العرض الأصغر. تأكد من وضوح الشعار، وبقاء النص مقروءًا، وبقاء مؤشرات التركيز مرئية، وعدم اختفاء أي عناصر تحكم في الخلفية. يُوصي الدليل بالاختبار في بيئة تطوير حقيقية واستخدام أدوات فحص المتصفح لتجربة تغييرات CSS. الإجراء: اختبر هذه المسارات على بيئة تجريبية أولًا، ثم كرّر العملية بعد النشر مع مسح ذاكرة التخزين المؤقت للمتصفح.
إذا لم يطرأ أي تغيير، فتأكد من تفعيل تطبيق السمات، وأن المجلد موجود ضمن مسار التطبيق المفحوص، وأن أسماء الملفات النسبية مطابقة للإعدادات الافتراضية، وأن مُحدِّد CSS لا يزال مطابقًا للصفحة. راجع سجلات ownCloud وخادم الويب بحثًا عن أخطاء التحميل أو الأذونات. قد يؤدي تخزين CSS أو موارد المتصفح مؤقتًا إلى تأخير ظهور التحديثات. الإجراء: امسح ذاكرة التخزين المؤقت للمتصفح أو استخدم نافذة خاصة بعد التأكد من حالة الملفات والتطبيق؛ لا تحذف بيانات الإنتاج أو تُعطِّل فحوصات التكامل كحل سريع للمشاكل.
أخيرًا، أعد اختبار القالب بعد كل تحديث لـ ownCloud. قد تتغير بنية الكود الأساسية ومسارات الأصول، مما قد يجعل أكواد CSS المخصصة غير فعالة أو تتعارض مع الواجهة الجديدة. يوضح الدليل منهجية القالب-التطبيق، لكنه لا يضمن بقاء جميع التعديلات متوافقة مع جميع الإصدارات. الإجراء: احتفظ بنسخة احتياطية، وقارن قالبك بالإصدار الذي تُحدّث إليه، واحذف التعديلات القديمة بعد الاختبار فقط.
خطط لعملية ترحيل من ownCloud 10 إلى oCIS باستخدام التطبيق المدعوم، والأوامر المرتبة، وفحوصات الهوية، وقائمة واضحة بالبيانات التي تحتاج إلى معالجة منفصلة.
استبدل شعارات ownCloud Classic 10 وقم بضبط ألوان واجهة المستخدم على الويب باستخدام تطبيق سمات، مع تجنب مخاطر الترقية وفحص السلامة.
قم بتعيين حدود التخزين المستندة إلى البايت لمستخدمي ownCloud Infinite Scale الجدد حسب الدور، مع مثال proxy.yaml وقائمة تحقق من الأمان.
استعد مزامنة سطح المكتب في ownCloud عن طريق التحقق من اسم مضيف الخادم، وسلسلة الشهادات، وثقة المرجع المصدق الخاص، ومشكلات البوابة المقيدة دون تعطيل التحقق من TLS.
استخدم تقرير الملفات غير الصالحة لتحديد ملفات النظام الأساسية غير المتطابقة أو توقيعات التطبيق، واستعادة ملفات الإصدار الصحيحة، والتحقق من سلامة النظام بأمان.
قم بنشر ownCloud Infinite Scale من مثال Compose الرسمي الخاص به، وقم بتكوين النطاقات والتخزين الدائم، ثم تحقق من TLS والحاويات وتسجيل الدخول الأول.
قم بإعداد برنامج تشغيل S3NG، وأذونات الحاوية، وتخزين البيانات الوصفية الدائمة، وحجم التحميل حتى يتمكن ownCloud Infinite Scale من تخزين محتويات الملفات بشكل موثوق.
اكتشف سبب توقف عملية تحميل الملفات على خادم ownCloud عند اقتراب اكتمالها من خلال التحقق من حالة الملف، والحصة المخصصة، ومساحة القرص المؤقتة، وحدود PHP، ومهلات الوكيل.
قم بتعيين AllowOverride All فقط لجذر الويب الخاص بـ ownCloud، وتحقق من صحة المضيف الظاهري النشط لـ Apache، وأعد التحميل بأمان لاستعادة قواعد .htaccess.
قم بتمكين تطبيق التدقيق المؤسسي الخاص بـ ownCloud، وقم بتوجيه أحداث admin_audit إلى ملف سجل محمي، وتأكد من تسجيل إجراءات المستخدم الحقيقية.