تثبيت "مستندات Google" الذكية

يتم تثبيت تطبيق "مستندات Google" تلقائيًا عند تثبيت النصوص البرمجية لاختبار التثبيت وتنفيذها الموضحة في اختبار التثبيت. كجزء من تشغيل النصوص البرمجية للاختبار، يمكنك تنفيذ الأوامر التالية:

/opt/apigee/apigee-service/bin/apigee-service apigee-validate install
/opt/apigee/apigee-service/bin/apigee-service apigee-validate setup -f configFile

يكون configFile هو ملف الإعداد نفسه الذي استخدمته لتثبيت Edge. يمكنك الاطّلاع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.

سيؤدي هذا الأمر إلى تثبيت تطبيق "مستندات Google" الذكية كجزء من إجراء الاختبارات.

لإكمال التثبيت:

  1. تحقّق من أنّ تطبيق "مستندات Google" مثبّتًا من خلال التأكّد من أنّ ملف smartdocs.zip مدرَج في الدليل التالي:

    /opt/apigee/apigee-validate/bundles/

    أو يمكنك تشغيل طلب البيانات من واجهة برمجة التطبيقات التالي في عقدة خادم الإدارة:

    curl -v -u adminEmail:adminPword 0:8080/v1/o/validate/apis

    من المفترض أن يعرض هذا الأمر ما يلي في حال تثبيت SmartDocuments:

    [ "smartdocs", "passthrough" ]
  2. من واجهة مستخدم Edge، يمكنك إنشاء وتحديث KVM باسم "smartdocs_ البيضاء" كما هو موضّح في الشكل أدناه. ويجب إنشاء الجهاز الافتراضي في المؤسسة والبيئة التي يتم فيها حاليًا نشر الخادم الوكيل الذكي في "مستندات Google".

    ملاحظة: تأكّد من عدم وضع علامة في المربّع مشفّر.

    • أضِف مفتاحًا يُسمى "is_القائمة_الخاصة بالإعداد"، حيث تكون القيمة "نعم".
    • أضِف مفتاحًا ثانيًا باسم "allowed_hosts"، حيث تتمثّل القيم في أسماء المضيفين أو عناوين IP المفصولة بمسافات من SmartDocuments. يجب أن تتضمن قيمة "allowed_hosts" أي مضيفات مضمّنة في مواصفات OpenAPI المضافة إلى SmartDocuments. على سبيل المثال، إذا كانت لديك إحدى مواصفات OpenAPI التي تطلب mocktarget.apigee.net، ستحتاج إلى إضافة mocktarget.apigee.net إلى القيمة "allowed_hosts". إذا لم يتم تضمين مضيف في الجهاز الافتراضي، ستكون الاستجابة SmartDocuments 400 Bad Request مع حمولة محتوى تبلغ Bad Request-Hostname not permitted.
    واجهة إنشاء KVM ملاحظة: في حال عدم إضافة هذا الجهاز الافتراضي (KVM) وضبطه، لن يفرض الخادم الوكيل قائمة بيضاء. قد يؤدي ذلك إلى الوصول غير المصرّح به إلى المضيفين وعناوين IP. يجب تضمين أسماء المضيفين وعناوين IP فقط لنقاط نهاية واجهة برمجة التطبيقات التي تم توثيقها باستخدام SmartDocuments في قيم "allowed_hosts".