العمل مع مبنى البانثيون

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

تستخدم Apigee خدمة Pantheon، وهي خدمة لإدارة المواقع الإلكترونية لاستضافة إصدارات مستنِدة إلى السحابة الإلكترونية من بوابة "خدمات المطوّرين". تم تصميم Pantheon للعمل مع Drupal لتتمكّن من تطوير البوابة واختبارها ونشرها في بيئة آمنة. تتوفّر خدمة إدارة المواقع الإلكترونية من Pantheon للعملاء الذين لديهم احتياجات لعمليات الاستضافة والتطوير في جميع أنحاء العالم.

توضّح الأقسام التالية كيفية استخدام Pantheon لتطوير البوابة الإلكترونية وإدارتها.

الدخول إلى لوحة تحكم Pantheon

عندما ترسل إليك Apigee عنوان URL الخاص بالبوابة، ستتلقى أيضًا عنوان URL للوحة بيانات Pantheon: https://dashboard.getpantheon.com/.

عند تسجيل الدخول لأول مرة إلى لوحة بيانات Pantheon، يتم نقلك إلى صفحة المواقع الإلكترونية، الموضحة أدناه:

ومن لوحة البيانات، يمكنك الوصول إلى موقعك الإلكتروني وضبط حسابك وإجراء عمليات أخرى.

اختَر صورة موقعك الإلكتروني (على سبيل المثال apigeedocs) لفتح لوحة البيانات لذلك الموقع الإلكتروني:

إدارة بيئاتك

في لوحة بيانات Pantheon، هناك ثلاث بيئات مدرجة في أعلى الصفحة: Dev، وTest، وLive. ويتم شرح كل منها في الجدول التالي.

البيئة	الوصف
إصدار مطوّري البرامج	بيئة Dev مرتبطة بمستودع Git. وتظهر أي تغييرات تجريها على Git مباشرةً في بيئة إصدار مطوّري البرامج. يظهر عنوان URL لهذا الموقع الإلكتروني في النموذج أدناه، حيث يشير org_name إلى اسم مؤسستك: http://dev-{org_name}.devportal.apigee.io/
الاختبار	بيئة الاختبار مُخصصة لاختبار أحدث رمز برمجي باستخدام نسخة من بيانات من البيئة مباشر. وهذه البيئة هي المكان الذي تختبر فيه تغييرات الرمز قبل إرساله إلى البيئة البث المباشر. يظهر عنوان URL لهذا الموقع الإلكتروني في النموذج أدناه، حيث يشير org_name إلى اسم مؤسستك: http://test-{org_name}.devportal.apigee.io/
مباشر	البيئة المباشرة هي بيئة الإنتاج التي تتيحها لعملائك. يظهر عنوان URL لهذا الموقع الإلكتروني في النموذج أدناه، حيث يشير org_name إلى اسم مؤسستك: http://live-{org_name}.devportal.apigee.io/

تطوير محتوى البوابة

توضّح الأقسام التالية كيفية تطوير محتوى البوابة.

• نظرة عامة على مستودع Git
• الوصول إلى الرمز
• نشر الرمز في بيئات البوابة
• إضافة وحدات ومظاهر مخصّصة
• تجاوز وحدات ومظاهر الملف الشخصي في Drupal

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

في حال كنت تريد...	يمكنك	مزيد من المعلومات
تغيير شكل الموقع الإلكتروني ومضمونه	أساسي: استخدِم إدخال قائمة المظهر على موقع البوابة الإلكتروني لإجراء تغييرات، مثل تعديل الشعار وألوان الموقع الإلكتروني.	راجِع تخصيص المظهر:
	إعدادات متقدمة: لإجراء تعديلات على الشكل والمظهر الكامل للموقع الإلكتروني، يمكنك توسيع مظهر Apigee السريع الاستجابة.	الاطّلاع على قسم تخصيص المظهر
تغيير سلوك وظائف الموقع الإلكتروني	أساسي: استخدِم إعدادات المشرف على البوابة لتغيير أو ضبط سلوك الموقع الإلكتروني.	اطلع على وثائق Apigee التي تبدأ من هنا
	إعدادات متقدمة: يمكنك إنشاء وحدة مخصّصة لتغيير أي سلوك على الموقع الإلكتروني.	اطّلِع على إنشاء وحدات مخصّصة في مستندات Drupal.

نظرة عامة على مستودع Git

يحتوي مستودع Git لرمز Drupal على كل رموز البوابة، ويتم تنظيمه باستخدام البنية التالية.

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

المجلد في Git repo	الوصف
/profiles/apigee	حافظت Apigee على وحدات ومظاهر، بما في ذلك: /profiles/apigee/modules/contrib: وحدات Drupal المشتركة التي تخضع لصيانة Apigee /profiles/apigee/themes/contrib: مظاهر مساهمة في Drupal تخضع لإدارة Apigee /profiles/apigee/modules/custom: الوحدات المخصّصة التي أنشأتها Apigee /profiles/apigee/themes/custom: مظاهر مخصّصة تم إنشاؤها من قِبل Apigee ملاحظة: لا تعدِّل المحتوى في الدليل /profiles/apigee، وإلّا ستواجهك مشاكل عند الترقية إلى إصدارات جديدة، وقد تواجه تعارضات في الدمج عند مراجعة التغييرات في Git. للتعرُّف على أفضل ممارسات Drupal، يمكنك الاطّلاع على عدم الاستيلاء على الموقع الإلكتروني مطلقًا.
/sites/all	وحدات ومظاهر Drupal المخصّصة. للحصول على معلومات حول إدارة المحتوى في هذا المجلد، يمكنك الاطّلاع على إضافة وحدات ومظاهر مخصّصة وإلغاء وحدات ومظاهر الملفات الشخصية في Drupal. ملاحظة: يجب تعديل المحتوى ضمن الدليل /sites/all فقط.

الوصول إلى الرمز

للوصول إلى مستودع الرموز في Git، عليك تنفيذ المهام الموضّحة في الأقسام التالية:

• تفعيل وصول SSH إلى الخادم
• الوصول إلى مستودع الرموز في Git

راجِع أيضًا كيف يمكنني الوصول إلى رمز مصدر بوابة مطوّري البرامج في Drupal 7؟

تفعيل دخول SSH إلى الخادم

قبل استخدام Git لإدارة رمز Drupal، يجب تفعيل بروتوكول النقل الآمن للوصول إلى الخادم عن طريق تحميل مفتاح SSH إلى Pantheon.

لتفعيل إمكانية وصول بروتوكول النقل الآمن إلى الخادم:

1. سجِّل الدخول إلى Pantheon على https://dashboard.getpantheon.com/.
2. في لوحة البيانات، اختر الحساب.
3. اختَر SSH Keys (مفاتيح SSH) في القائمة على يمين الصفحة.
4. أضِف مفتاحك واختَر إضافة مفتاح.
   إذا كنت بحاجة إلى المساعدة، اختَر رابط التعرّف على كيفية إنشاء مفتاح SSH.

الوصول إلى مستودع الرموز في Git

ملاحظة: يمكنك الاطّلاع على نظرة عامة على مستودع Git للحصول على نظرة عامة حول بنية مستودع Git.

للوصول إلى مستودع الرموز في Git:

1. سجّل الدخول إلى لوحة تحكم Pantheon.
2. من صفحة "مواقع Google" الرئيسية، اختَر رمز البوابة.
3. يظهر عنوان URL لمستودع Git على الصفحة على يسار وضع الاتصال، كما هو موضّح في الشكل السابق.
4. انسخ عنوان URL لـ Git repo واستنسِه في بيئة التطوير المحلي باستخدام الأمر:
   > git clone gitURL اسم الموقع
   على سبيل المثال:
   > git clone ssh://codeserver.dev.12@codeserver.dev.12.dمدخل.in:2222/~trepository.

تظهر أي تغييرات في الرمز ترسلها إلى مستودع Git مباشرةً في بيئة إصدار مطوّري البرامج من البوابة.

نشر الرمز في بيئات البوابة

للترميز في بيئات البوابة:

1. أرسِل تعديلات الرمز إلى Git، التي تؤدي إلى تعديل بيئة إصدار مطوّري البرامج على الفور.
2. سجّل الدخول إلى Pantheon، وحدد موقعك.
3. اختَر بيئة مطوّر البرامج.
4. اختَر </>الرمز في القائمة اليمنى لعرض رسالة بشأن تغيير الرمز في سجلّ الالتزام:
   
5. اختَر بيئة الاختبار في أعلى الصفحة.
   1. إذا لم يسبق لك تحميل إصدار مطوّري البرامج إلى الاختبار، سيُطلَب منك إجراء ذلك الآن.
   2. إذا كانت لديك بيئة اختبار، ستظهر رسالة تشير إلى أنّ هناك التزامًا من مطوّري البرامج جاهز للنشر:
      
6. إذا كنت قد أرسلت موقعًا إلكترونيًا إلى البيئة المباشرة، يمكنك اختياريًا وضع علامة في مربّع الاختيار الثالث لنسخ قاعدة البيانات المباشرة وأي ملفات حمّلها المطوّرون إلى الاختبار من البث المباشر. ويُعدّ هذا الإجراء مفيدًا إذا كنت تريد اختبار التغييرات التي تم إجراؤها على الرمز في ضوء أحدث البيانات المتاحة على البث المباشر.
7. اختر الزر نشر الرمز من التطوير.
8. اختبِر البوابة في بيئة الاختبار.
9. يجب إجراء أي إصلاحات للرموز في بيئة إصدار مطوّري البرامج، وإرسال الملفات مجددًا إلى الاختبار من أجل الاختبار.
10. عند اكتمال الاختبار، اختَر البيئة البث المباشر في أعلى الصفحة.
    1. إذا لم يسبق لك تحميل الفيديو الاختبار إلى البث المباشر، سيُطلب منك إجراء ذلك الآن.
    2. إذا كانت لديك بيئة مباشرة، ستظهر رسالة تشير إلى أنّ هناك التزام من الاختبار جاهز للنشر. انشر هذه التغييرات بالطريقة نفسها التي استخدمتها في الاختبار من إصدار مطوّري البرامج. وعند الانتهاء من الاختبار، أرسِل الرمز إلى بيئة البث المباشر.

مزيد من المعلومات:

• تقدّم منصة Pantheon مجموعة من المقالات المباشرة الحالية حول هذه العملية للاطّلاع عليها. من أهم المقالات هي مقالة استخدام سير عمل Pantheon التي تقدّم نظرة عامة حول كيفية تطوير موقعك الإلكتروني واختباره ونشره.

إضافة وحدات ومظاهر مخصصة

يمكنك توسيع وظائف البوابة من خلال إضافة الوحدات والمظاهر المخصّصة إلى المجلدات المدرَجة في الجدول التالي.

ملاحظة: يجب تعديل المحتوى ضمن الدليل /sites/all فقط. إذا عدَّلت محتوى خارج الدليل /sites/all، قد تواجه تعارضات في الدمج عند التحقق من التغييرات في Git.

الوحدة/الموضوع	مجلد في مستودع Git	مزيد من المعلومات (مستندات Drupal)
الوحدات المخصّصة	sites/all/modules/custom	إنشاء وحدات مخصّصة
مظاهر مخصصة	sites/all/themes	تخصيص المظهر Theming Drupal 7

بعد إضافة الوحدة أو المظهر المخصّص في بيئة إصدار مطوّري البرامج، يمكنك نشره في بيئة الاختبار، ثم نشره في البيئة المباشرة للإنتاج، كما هو موضّح في نشر الرموز البرمجية على بيئات البوابة.

تجاوز وحدات ومظاهر الملف الشخصي في Drupal

تلغي الوحدات والمظاهر في الأدلة التالية وحدات ومظاهر ملفات Drupal الشخصية التي تحتفظ بها Apigee وتوزّعها في /profiles/apigee. يُرجى الاطّلاع على نظرة عامة على مستودع Git.

على سبيل المثال، قد تريد إلغاء وحدة في توزيع Apigee Drupal في السيناريوهات التالية:

• تريد استخدام إصدار مختلف من وحدة معينة.
• لنفترض أنك بحاجة إلى تنفيذ تحديث أمان قبل إطلاق الإصدار المُجدوَل التالي من Apigee.

الوحدة/الموضوع	مجلد في مستودع Git	مزيد من المعلومات (مستندات Drupal)
الوحدات التي يساهم بها Drupal	sites/all/modules/contrib ملاحظة: إنّ الوحدات التي يتم تخزينها في أيّ مكان ضمن /sites/all/modules ستحلّ محلّ وحدات توزيع Apigee Drupal.	الوحدات التي تمت المساهمة بها ملاحظة: تلغي الوحدات التي ساهمت بها Drupal في هذا الدليل الوحدات المكافئة التي تحتفظ بها Apigee وتوزّعها في /profiles/apigee/modules. إذا أردت استخدام وحدات ملفات Drupal الشخصية التي تم الاحتفاظ بها في Apigee، عليك إزالة أي وحدات مكرّرة أضفتها إلى هذا المجلد.
المظاهر التي يساهم بها Drupal	sites/all/themes	المواضيع التي تمت المساهمة بها ملاحظة: تلغي المظاهر التي ساهمت بها Drupal في هذا الدليل الوحدات المكافئة التي تحتفظ بها Apigee وتوزّعها في /profiles/apigee/themes. أزِل أي وحدات مكرّرة أضفتها إلى هذا المجلد إذا أردت استخدام مظاهر الملفات الشخصية المحفوظة في Apigee.

معلومات عن ملف settings.php

يلتزم settings.php Drupal بمتجر Git الذي يتم تحميله من خلال بوابة مطوّري Apigee Drupal. إذا أردت إجراء تغييرات على ملف sites/default/settings.php، لا تعدِّل الملف مباشرةً. بدلاً من ذلك، يمكنك إنشاء ملف باسم sites/default/settings.local.php ووضع الرمز المخصّص فيه. يتم تضمين sites/default/settings.local.php في ملف settings.php.

على سبيل المثال، عند إعداد نطاق خاص لموقع إلكتروني مباشر باتّباع التعليمات الواردة من Pantheon، بدلاً من تعديل ملف settings.php مباشرةً، يمكنك إضافة التحديثات المطلوبة في sites/default/settings.local.php.

تأمين البوابة

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

قد تحتاج إلى إخفاء الموقع الإلكتروني للمطوّرين واختبار من الجمهور وإخفاء موقعك الإلكتروني المباشر إلى حين إكمال عملية التطوير. تتيح لك منصة Pantheon إمكانية إضافة عنصر تحكّم في اسم المستخدم/كلمة المرور لقفل الموقع الإلكتروني، بحيث لا يمكن لأحد الوصول إليه سوى المستخدمين الذين لديهم بيانات اعتماد مناسبة.

يمكنك إضافة قفل إلى أي من البيئات الثلاث عن طريق اختيار الأمان في القائمة اليمنى للبيئة. لمزيد من المعلومات، راجع قفل موقعك الإلكتروني.

إذا كنت تريد تفعيل بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة لموقعك الإلكتروني، يمكنك الاطّلاع على استخدام بروتوكول أمان طبقة النقل (TLS) على البوابة.

تطبيق تحديث Apigee على البوابة

عندما تنشر Apigee إصدارًا جديدًا من البوابة، تظهر رسالة على لوحة بيانات Pantheon.

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

لتطبيق تحديث:

1. سجِّل الدخول إلى Pantheon على https://dashboard.getpantheon.com/ واختَر موقعك الإلكتروني.
2. اختَر بيئة مطوّر البرامج.
3. حدد إدخال قائمة </>الرمز على اليمين. في حال توفُّر أي تحديثات لـ Apigee، سيتم إدراجها.
4. طبِّق التحديث:
   1. ضع علامة في مربع الاختيار تشغيل update.php بعد سحب الرمز.
   2. ضَع علامة في مربّع الاختيار محو ذاكرات التخزين المؤقت بعد سحب الرمز، إن توفّر.
   3. انقر على الزر نشر الرمز.
5. بعد اكتمال عملية التحديث، اختَر عنصر القائمة الحالة على يمين لوحة البيانات.
6. في منطقة الحالة في البيئة، قد تلاحظ خطأ متعلقًا بتحديث قاعدة البيانات، كما هو موضح أدناه:

   

   إذا ظهر لك هذا الخطأ في أي بيئة، يمكنك تعديل قاعدة البيانات يدويًا:

   1. سجّل الدخول إلى المنصة كمستخدم لديه امتيازات المشرف أو امتيازات إنشاء المحتوى.
   2. انقر على رمز الصفحة الرئيسية > تنفيذ التحديثات في أعلى يمين البوابة.
   3. اتبع التعليمات لتحديث قاعدة البيانات.
7. أرسِل التغييرات في الرمز إلى بيئة الاختبار، ثم ادفع التغييرات إلى محتوى مباشر على النحو الموضّح أعلاه.

نقل الميزات المخصَّصة

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

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

إذا أنشأت أي عمليات ضبط مخصَّصة، استخدِم إحدى الطرق التالية لنقلها:

الطريقة	الوصف
تصدير الإعدادات إلى الرمز	تكون العديد من الإعدادات الشائعة "قابلة للتصدير" إلى رمز برمجي باستخدام وحدة الميزات. على سبيل المثال، طرق العرض واللوحات وذاكرة التخزين المؤقت للصور وما إلى ذلك.
تنفيذ دالة hook_update_N()	يدير Drupal تغييرات قاعدة البيانات والإعدادات باستخدام hook_update_N(). إذا كانت لديك وحدة مخصّصة، يمكنك: أضِف دوال hook_update_N() إلى ملف .install في الوحدة لمعالجة التغييرات. انشر هذه التغييرات مع الرمز. شغِّل update.php لنقل التغييرات في بيئات Stage وProd.

راجِع أيضًا المقالة استخدام مسار عمل Pantheon الذي يقدّم نظرة عامة حول كيفية تطوير موقعك الإلكتروني واختباره ونشره. تتضمن هذه المقالة قسم إدارة الإعداد.

تهيئة نطاق خاص

أسماء النطاقات التي توفِّرها Apigee للبوابة التلقائية على apigee.io، كما هو موضّح في القسم إدارة بيئاتك، وقد لا تكون هذه الأسماء هي ما تريد عرضه لعملائك.

يمكن لخطط البوابة المدفوعة ضبط اسم نطاق خاص للبوابة (لا يمكن لحسابات مطوّري البرامج أو الحسابات المجانية إنشاء نطاق خاص). لاستخدام نطاق خاص، أنشئ CNAME في نظام أسماء النطاقات ووجِّه نطاقك إلى edge.apigee.getpantheon.com.

على سبيل المثال، لضبط النطاق الخاص لشركة اسمها Mytech:

1. اضبط الإعداد التالي لنظام أسماء النطاقات:
   developer.mytech.com. 3600 IN CNAME Edge.apigee.getpantheon.com
   قد يستغرق تنفيذ هذا التغيير على نظام أسماء النطاقات على جميع أجهزة العملاء ما يصل إلى 48 ساعة.
2. استخدم إدخال قائمة النطاقات / طبقة المقابس الآمنة (SSL) على الجانب الأيمن من لوحة البيانات لإضافة هذا النطاق إلى لوحة بيانات Pantheon للبيئة Live فقط.
   في معظم الحالات، يمكنك إعداد نظام أسماء النطاقات للبيئة المباشرة فقط، وليس لكل من إصدار مطوّري البرامج والاختبار. يجب عدم استخدام البيئتَين مطوّرو البرامج أو الاختبار للإنتاج.

لمزيد من المعلومات، يُرجى الاطّلاع على وثائق Pantheon هنا.

إضافة مشرفي البوابة

عندما تتلقّى رسالة إلكترونية من Apigee تفيد بأنّ البوابة الإلكترونية جاهزة، يعني ذلك أنّ Apigee قد أعدت قائمة مشرفي البوابة. يمكنك الاطّلاع على هذه القائمة من خلال النقر على رابط الفريق في أعلى يسار لوحة بيانات الموقع الإلكتروني.

لإضافة مشرفين إضافيين، يُرجى الاطّلاع على إنشاء مستخدمين مشرفين.

الاحتفاظ بنسخة احتياطية من البوابة

للاحتفاظ بنسخة احتياطية من البوابة، استخدم علامة التبويب النُسخ الاحتياطية في لوحة بيانات Pantheon. يمكنك إنشاء نسخة احتياطية تلقائية أو عند الطلب. في Pantheon، تتكون النسخة الاحتياطية من ثلاثة أرشيفات منفصلة: قاعدة البيانات، والملفات، والرموز.

لمزيد من المعلومات، يُرجى الاطّلاع على أداة النسخ الاحتياطية في مستندات Pantheon.

الاشتراك في تحديثات الحالة

ويمكنك الاشتراك في إشعارات إصدار Apigee وحالته على status.apigee.com. انقر على الاشتراك في التحديثات، وأدخِل معلومات الاتصال الخاصة بك، مثل عنوان البريد الإلكتروني، عندما يُطلب منك ذلك، ثم انقر على اشتراك. في صفحة إدارة الإشعارات عبر البريد الإلكتروني، تأكَّد من اختيار بوابة المطوّرين وبدِّل إعدادات الإشعارات الأخرى كما هو مطلوب وانقر على تعديل الإعدادات المفضّلة.

يمكنك الاشتراك في خدمة تلقّي إشعارات الحالة في Pantheon وتقارير الحوادث، مثلاً عند حدوث انقطاع في الخدمة، من خلال http://status.getpantheon.com. انقر على الاشتراك في التحديثات للاشتراك.