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

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

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

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

الوصول إلى لوحة تحكم Pantheon

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

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

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

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

إدارة البيئات

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

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

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

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

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

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

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

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

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

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

المجلد في مستودع Git	الوصف
/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 إلى خادمك
• الوصول إلى مستودع الرموز البرمجية في جيت

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

تمكين دخول SSH إلى خادمك

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

لتمكين دخول SSH إلى خادمك:

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

الوصول إلى مستودع التعليمات البرمجية في Git

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

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

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

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

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

لإنشاء ترميز لبيئات البوابة:

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

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

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

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

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

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

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

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

إلغاء وحدات الملف الشخصي في 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. إذا أردت استخدام Apigee، أزِل أي وحدات مكرّرة أضفتها إلى هذا المجلد. صيانة وحدات ملف Drupal الشخصي.
المظاهر التي يساهم بها 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.

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

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

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

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

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

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

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

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

لتطبيق التعديل:

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

لمزيد من المعلومات، يمكنك الاطّلاع على مستندات البانثيون هنا.

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

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

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

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

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

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

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

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

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