صيانة المؤسسات والبيئة

يتناول هذا القسم العديد من العمليات الإدارية، مثل إنشاء وإدارة وإزالة مؤسسات Apigee والبيئات والمضيفين الافتراضيين في Apigee Edge لتثبيت Private Cloud.

للاطّلاع على مقدمة عن المؤسسات والبيئات والمضيفين الافتراضيين، راجِع المقالة لمحة عن الكواكب والمناطق والقرون والمؤسسات والبيئات والمضيفين الافتراضيين.

جارٍ التحقق من حالة المستخدمين والمؤسسة والبيئة

يلعب خادم الإدارة دورًا حيويًا في الاحتفاظ بجميع المكوّنات الأخرى معًا في عملية تثبيت Edge Private Cloud داخل الشركة. يمكنك التحقق من حالة المستخدم والمؤسسة والنشر على "خادم الإدارة" من خلال إصدار أوامر curl التالية:

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

يجب أن يعرض النظام حالة HTTP 200 لجميع المكالمات. وإذا تعذّر ذلك، يمكنك تنفيذ ما يلي:

1. تحقَّق من سجلّات خادم الإدارة في /opt/apigee/var/log/apigee/management-server بحثًا عن أي أخطاء.
2. استدعِ خادم الإدارة للتحقق مما إذا كان يعمل بشكل صحيح.
3. أزِل الخادم من ELB، ثم أعِد تشغيل خادم الإدارة:

   /opt/apigee/bin/apigee-service management-server restart

لمحة عن استخدام ملفات الإعداد

تأخذ الأوامر الموضحة أدناه ملف إعداد كإدخال. على سبيل المثال، يمكنك ضبط ملف إعداد إلى الأمر setup-org لتحديد جميع خصائص المؤسسة، بما في ذلك البيئة والمضيف الافتراضي.

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

لمحة عن إعداد مضيف افتراضي

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

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

• اسم المضيف الافتراضي الذي تستخدمه للإشارة إليه في الخوادم الوكيلة لواجهة برمجة التطبيقات.
• المنفذ على جهاز التوجيه للمضيف الظاهري. تبدأ هذه المنافذ عادةً من 9001 وتزيد بمقدار واحد لكل مضيف افتراضي جديد.
• الاسم المستعار للمضيف للمضيف الظاهري. ويكون عادةً اسم نظام أسماء النطاقات للمضيف الافتراضي.

  يقارن جهاز توجيه Edge عنوان المضيف للطلب الوارد بقائمة الأسماء المستعارة للمضيف كجزء من عملية تحديد الخادم الوكيل لواجهة برمجة التطبيقات الذي يعالج الطلب. وعند تقديم طلب من خلال مضيف افتراضي، يمكنك تحديد اسم نطاق يتطابق مع الاسم المستعار للمضيف لمضيف افتراضي، أو تحديد عنوان IP لجهاز التوجيه وعنوان المضيف الذي يتضمن الاسم المستعار للمضيف.

على سبيل المثال، إذا أنشأت مضيفًا افتراضيًا باستخدام اسم مضيف مستعار هو myapis.apigee.net على المنفذ 9001، يمكنك تنفيذ طلب curl لواجهة برمجة تطبيقات من خلال هذا المضيف الظاهري باستخدام أحد النماذج التالية:

• إذا كان لديك إدخال نظام أسماء النطاقات للنطاق myapis.apigee.net:

  curl http://myapis.apigee.net:9001/proxy-base-path/resource-path

• إذا لم يكن لديك إدخال نظام أسماء نطاقات لـ myapis.apigee.net:

  curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

  في النموذج الثاني، يمكنك تحديد عنوان IP لجهاز التوجيه، وإدخال الاسم المستعار للمضيف في عنوان المضيف.

الخيارات عندما لا يتوفر لديك إدخال نظام أسماء نطاقات للمضيف الظاهري

أحد الخيارات عندما لا يتوفّر لديك إدخال لنظام أسماء النطاقات هو ضبط الاسم المستعار للمضيف على عنوان IP لجهاز التوجيه ومنفذ المضيف الافتراضي، مثل routerIP:port. مثلاً:

192.168.1.31:9001

بعد ذلك، أدخِل الأمر curl في النموذج أدناه:

curl http://routerIP:9001/proxy-base-path/resource-path

ويُفضَّل استخدام هذا الخيار لأنّه يعمل بشكل جيد مع واجهة مستخدم Edge.

إذا كانت لديك عدة أجهزة توجيه، أضِف اسمًا مستعارًا لمضيف لكل جهاز توجيه، مع تحديد عنوان IP لكل جهاز توجيه ومنفذ المضيف الافتراضي.

بدلاً من ذلك، يمكنك ضبط الاسم المستعار للمضيف على قيمة، مثل temp.hostalias.com. بعد ذلك، عليك ضبط العنوان Host في كل طلب:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

أو يمكنك إضافة اسم المضيف البديل إلى ملف /etc/hosts. على سبيل المثال، أضِف هذا السطر إلى /etc/hosts:

192.168.1.31   temp.hostalias.com

بعد ذلك، يمكنك تقديم الطلب كما لو كان لديك إدخال DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path