تثبيت أداة إعداد واجهة برمجة التطبيقات Edge

Edge for Private Cloud الإصدار 4.19.01

لتثبيت Edge على عقدة، يجب أولاً تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge. إذا كنت في بيئة لا تحتوي العُقد فيها على اتصال خارجي بالإنترنت، يجب أيضًا تثبيت نسخة محلية من مستودع Apigee.

دليل التثبيت التلقائي: /opt/apigee

يثبّت Edge جميع الملفات في دليل /opt/apigee. ولا يمكنك تغيير هذا الدليل. ومع ذلك، يمكنك إنشاء رابط رمزي لربط /opt/apigee بموقع جغرافي آخر، إذا أردت ذلك. لمزيد من المعلومات، اطّلِع على متطلبات التثبيت.

المتطلبات الأساسية: إيقاف SELinux

يجب إيقاف SELinux أو ضبطه على الوضع المتساهِل قبل تثبيت الأداة المساعدة Edge apigee-setup أو أي من مكونات Edge. وإذا لزم الأمر، بعد تثبيت Edge، يمكنك إعادة تمكين SELinux.

  • لضبط SELinux على الوضع المتساهِل مؤقتًا، نفِّذ الأمر التالي:
    1. على نظام التشغيل Linux 6.x:
      sudo echo 0 > /selinux/enforce

      لإعادة تمكين SELinux بعد تثبيت Edge:

      sudo echo 1 > /selinux/enforce
    2. على نظام التشغيل Linux 7.x:
      sudo setenforce 0

      لإعادة تمكين SELinux بعد تثبيت Edge:

      sudo setenforce 1
  • لإيقاف SELinux بشكل دائم أو ضبطه على الوضع المتساهِل:
    1. فتح /etc/sysconfig/selinux في محرِّر
    2. ضبط SELINUX=disabled أو SELINUX=permissive
    3. احفظ التعديلات.
    4. أعِد تشغيل العُقدة.
    5. إذا لزم الأمر، يمكنك إعادة تفعيل SELinux بعد تثبيت Edge من خلال تكرار هذا الإجراء لضبط SELINUX=enabled.

المتطلبات الأساسية: تفعيل مستودع EPEL

يجب تفعيل الحزم الإضافية لنظام التشغيل Enterprise Linux (أو EPEL) لتثبيت إصدار Edge أو تحديثه أو لإنشاء مستودع محلي. ويعتمد الأمر الذي تستخدمه على إصدار RedHat/CentOS الذي تستخدمه:

  • بالنسبة إلى RedHat/CentOS/Oracle 7.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • بالنسبة إلى RedHat/CentOS/Oracle 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
    sudo rpm -ivh epel-release-latest-6.noarch.rpm

الشرط الأساسي: التحقّق من إصدار مكتبة libdb4 على RedHat 7.4 وCentOS 7.4

على RedHat 7.4 وCentOS 7.4، تحقَّق من إصدار libdb4 RPM قبل التثبيت. يتطلب Edge الإصدار 4.8، ويتم استخدام بعض إصدارات RedHat 7.4 وCentOS 7.4 مع إصدار أحدث. إذا كان لديك إصدار أحدث، فألغِ تثبيته وستثبّت أداة تثبيت Edge بعد ذلك الإصدار 4.8.

يمكنك استخدام الأمر التالي للتحقّق من الإصدار:

rpm -qa | grep libdb4

إذا رأيت أنّ إصدار libdb4 RPM أحدث من الإصدار 4.8، عليك إلغاء تثبيته.

تثبيت أداة إعداد واجهة برمجة تطبيقات Edge على عقدة تتضمن اتصال إنترنت خارجي

لتثبيت Edge على عقدة متصلة بالإنترنت:

  1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك username:password حالي لموقع Apigee ftp الإلكتروني، يمكنك استخدام بيانات الاعتماد هذه.
  2. تسجيل الدخول إلى العقدة كجذر لتثبيت Edge RPMs
  3. تثبيت yum-utils وyum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. عطِّل SELinux كما هو موضح أعلاه.
  5. فعِّل مستودع EPEL كما هو موضّح أعلاه.
  6. افحص إصدار libdb4 كما هو موضح أعلاه.
  7. إذا كنت تثبّت على Oracle 7.x، شغِّل الأمر التالي:
    sudo yum-config-manager --enable ol7_optional_latest
  8. إذا كنت تثبّت على AWS، شغِّل أوامر yum-configure-manager التالية:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. نزِّل ملف bootstrap_4.19.01.sh لبرنامج Edge إلى /tmp/bootstrap_4.19.01.sh:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  10. ثبِّت الأداة المساعدة الخاصة بخدمة Edge apigee وملحقاتها:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذَين تلقّيتهما من Apigee. إذا لم تستخدم pWord، سيُطلب منك إدخاله.

    تتحقّق أداة التثبيت تلقائيًا من تثبيت Java 1.8. وإذا لم يكن لديك حساب، سيتم تثبيته نيابةً عنك. استخدِم الخيار JAVA_FIX لتحديد كيفية التعامل مع تثبيت Java. تستخدِم السمة JAVA_FIX القيم التالية:

    • 1: تثبيت OpenJDK 1.8 (الخيار التلقائي)
    • ج: المتابعة بدون تثبيت Java
    • س: إنهاء. للاستفادة من هذا الخيار، عليك تثبيت Java بنفسك.

    يؤدي تثبيت الأداة المساعدة apigee-service إلى إنشاء ملف /etc/yum.repos.d/apigee.repo الذي يحدّد مستودع Apigee. لعرض ملف التعريف، استخدِم الأمر:

    cat /etc/yum.repos.d/apigee.repo

    للاطّلاع على محتوى المخزن، استخدِم الأمر:

    sudo yum -v repolist 'apigee*'
  11. استخدم apigee-service لتثبيت الأداة المساعدة لإعداد apigee:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. استخدم إعداد apigee لتثبيت مكونات Edge وتهيئتها على العقدة. راجع تثبيت مكونات Edge على عقدة لمزيد من المعلومات.

تثبيت أداة إعداد واجهة برمجة التطبيقات Edge على عقدة بدون اتصال خارجي بالإنترنت

إذا كانت عُقد Edge خلف جدار ناري أو كانت محظورة من الوصول إلى الإنترنت بطريقة أخرى، يجب إنشاء عدة مستودعات أو نسخ متطابقة تحتوي على الملفات التي ستحتاجها أثناء التثبيت. ويجب أن تكون هذه المرايا قابلة للوصول من جميع العُقد. وبعد إنشائها، يمكن للعُقد الوصول إلى هذه النسخ المطابقة المحلية لتثبيت Edge.

تتطلّب عملية تثبيت Apigee Edge للعُقد التي لا تتضمن اتصالات إنترنت الوصول إلى repos المحلية التالية:

إنشاء مستودع Apigee محلي

لإنشاء مستودع Apigee داخلي، يجب أن يكون لديك عقدة مزودة بإمكانية وصول خارجي إلى الإنترنت لتتمكن من تنزيل Edge RPMs والتبعيات. بعد إنشاء المخزن الداخلي، يمكنك نقله إلى عقدة أخرى أو إتاحة الوصول إلى تلك العقدة من عُقد Edge لتثبيتها.

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

لإنشاء مستودع Apigee محلي:

  1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك حاليًا اسم المستخدم:كلمة مرور لموقع Apigee ftp الإلكتروني، يمكنك استخدام بيانات الاعتماد هذه.
  2. سجِّل الدخول إلى العُقدة كجذر لتثبيت Edge RPMs.
  3. عطِّل SELinux كما هو موضح أعلاه.
  4. نزِّل ملف bootstrap_4.19.01.sh لبرنامج Edge إلى /tmp/bootstrap_4.19.01.sh:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  5. ثبِّت الأداة المساعدة الخاصة بخدمة Edge apigee وملحقاتها:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذَين تلقّيتهما من Apigee. إذا لم تستخدم pWord، سيُطلب منك إدخاله.

  6. ثبِّت الأداة المساعدة apigee-mirror في العقدة:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  7. استخدِم الأداة apigee-mirror لمزامنة مستودع Apigee مع الدليل /opt/apigee/data/apigee-mirror/repos/.

    لتقليل حجم الريبو، يمكنك تضمين --only-new-rpms لتنزيل أحدث الأرباح لكل ألف مشاهدة (RPM). تحتاج إلى مساحة على القرص 1.6 غيغابايت تقريبًا للتنزيل:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    إذا أردت تنزيل الريبو بأكمله، بما في ذلك الأرباح القديمة لكل ألف ظهور، احذف --only-new-rpms. تحتاج إلى مساحة على القرص قدرها 6 غيغابايت تقريبًا للتنزيل الكامل:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    لديك الآن نسخة محلية من مستودع Apigee. يوضّح القسم التالي طريقة تثبيت الأداة apigee-setup Edge من المخزن المحلي.

  8. (اختياري) إذا أردت تثبيت Edge من المخزن المحلي على العقدة نفسها التي تستضيف الريبو المحلي، عليك أولاً تشغيل الأوامر التالية:
    1. شغِّل bootstrap_4.19.01.sh من المخزن المحلي لتثبيت أداة apigee-service:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. استخدِم apigee-service لتثبيت الأداة apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. استخدِم apigee-setup لتثبيت مكوّنات Edge وضبطها على العقدة. راجِع تثبيت مكونات Edge على عقدة للحصول على مزيد من المعلومات.

تثبيت إعداد apigee على عقدة بعيدة من مستودع محلي

لديك خياران لتثبيت Edge من المخزن المحلي. يمكنك تنفيذ إجراء مما يلي:

  • أنشِئ ملف .tar من ملف repo، وانسخ ملف .tar إلى عقدة، ثم ثبِّت Edge من ملف .tar.
  • قم بتثبيت خادم ويب على العقدة باستخدام الريبو المحلي حتى تتمكن العُقد الأخرى من الوصول إليه. يوفر لك Apigee خادم ويب Nginx لتستخدمه، أو يمكنك استخدام خادم الويب الخاص بك.

التثبيت من ملف .tar

للتثبيت من ملف .tar:

  1. في العقدة التي تتضمّن repo المحلي، استخدِم الأمر التالي لتجميع ملفات repo المحلية في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. انسخ ملف tar إلى العقدة التي تريد تثبيت Edge فيها. على سبيل المثال، انسخها إلى الدليل /tmp على العقدة الجديدة.
  3. في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
  4. في العقدة الجديدة، تأكَّد من أنه يمكنك الوصول إلى مستودع Yum Utility ومستودع EPEL المحلي.
  5. تأكَّد من أنّه تم إيقاف جميع مستودعات الإنترنت الخارجية (من المفترض أن تكون هذه هي الحالة لأنّك تثبّتها على جهاز لا يتصل بالإنترنت):
    sudo yum repolist

    يجب إيقاف جميع المستودعات الخارجية، ولكن يجب تفعيل مستودع Apigee المحلي والمستودع الداخلي.

  6. في العقدة الجديدة، ثبِّت yum-utils وyum-plugin-priorities من مستودعك المحلي:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
    .

    على فريق العمليات أو أي مجموعة أخرى داخل مؤسستك إعداد مستودع محلي لك حتى تتمكّن من تثبيت أدوات Yum.

  7. في العقدة الجديدة، تحقَّق من إصدار libdb4 كما هو موضَّح أعلاه.
  8. إذا كنت تثبّت على Oracle 7.x، شغِّل الأمر التالي:
    sudo yum-config-manager --enable ol7_optional_latest
  9. إذا كنت تثبّت على AWS، شغِّل أمر yum-configure-manager التالي:
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. في العقدة الجديدة، أزِل الملف إلى الدليل /tmp:
    tar -xzf apigee-4.19.01.tar.gz

    ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف .tar. مثلاً: /tmp/repos.

  11. ثبِّت الأداة المساعدة الخاصة بخدمة Edge apigee والتبعيات من /tmp/repos:
    sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    لاحظ أنك تقوم بتضمين المسار إلى دليل repos في هذا الأمر.

  12. استخدِم apigee-service لتثبيت الأداة apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. استخدِم apigee-setup لتثبيت مكوّنات Edge وضبطها على العقدة. راجِع تثبيت مكونات Edge على عقدة للحصول على مزيد من المعلومات.

التثبيت من المخزن باستخدام خادم الويب Nginx

للتثبيت من المخزن باستخدام خادم الويب Nginx:

  1. ثبِّت خادم الويب Nginx على عقدة Repo:
    opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. يتم ضبط Nginx تلقائيًا لاستخدام المضيف المحلي كاسم الخادم والمنفذ 3939. لتغيير هذه القيم:
    1. فتح /opt/apigee/customer/application/mirror.properties في محرِّر أنشئ الملف إذا لم يكن موجودًا.
    2. اضبط القيم التالية حسب الضرورة:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. أعِد تشغيل Nginx:
      /opt/nginx/scripts/apigee-nginx restart
  3. بشكل تلقائي، يتطلب المخزن اسم مستخدم:كلمة مرور لـ admin:admin. لتغيير بيانات الاعتماد هذه، عليك ضبط متغيرات البيئة التالية:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. في العقدة الجديدة، ثبِّت yum-utils وyum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
  6. في العقدة الجديدة، تأكَّد من تفعيل مستودع EPEL المحلي.
  7. في العقدة الجديدة، تحقَّق من إصدار libdb4 كما هو موضَّح أعلاه.
  8. في العقدة البعيدة، نزِّل ملف Edge Bootstrap_4.19.01.sh على /tmp/bootstrap_4.19.01.sh:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

    يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذَين تم ضبطهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة الريبو.

  9. في العقدة البعيدة، ثبِّت الأداة apigee-service Edge والتبعيات:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    حيث يشير "uName:pWord" إلى اسم المستخدم وكلمة المرور الخاصَّين بالمستودع.

  10. في العقدة البعيدة، استخدِم apigee-service لتثبيت أداة apigee-setup :
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. يمكنك استخدام apigee-setup لتثبيت مكوّنات Edge وضبطها على العقدة البعيدة. راجع تثبيت مكونات Edge على عقدة لمزيد من المعلومات.

تعديل مستودع Apigee محلي

لتحديث المخزن، يجب تنزيل ملف Bootstrap_4.19.01.sh الأحدث ثم تنفيذ عملية مزامنة جديدة.

لتعديل الريبو:

  1. نزِّل ملف Edge Bootstrap_4.19.01.sh على /tmp/bootstrap_4.19.01.sh:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  2. شغِّل ملف Edge bootstrap_4.19.01.sh:
    sudo bash/tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذين تلقّيتهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخاله.

  3. تاريخ آخر تعديل: apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. نفِّذ المزامنة:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. إذا كنت تريد استخدام repo بالكامل:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

تنظيف مستودع Apigee محلي

يؤدي تنظيف المخزن المحلي إلى حذف /opt/apigee/data/apigee-Mirror و /var/tmp/yum-apigee-*.

لحذف المخزن المحلي، استخدِم:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

إضافة أو تحديث Edge 4.16.0x/4.17.0x في مستودع 4.19.01

إذا كان عليك الاحتفاظ بعمليات التثبيت الخاصة بالإصدار 4.16.0x أو 4.17.0x من Edge 4.16.01 في مستودع 4.19.01، يمكنك الاحتفاظ بمستودع إعلاني يحتوي على جميع الإصدارات. من هذا الريبو، يمكنك تثبيت أي إصدار من Edge.

لإضافة 4.16.0x/4.17.0x إلى مستودع 4.19.01:

  1. احرص على تثبيت الإصدار 4.19.01 من الأداة المساعدة apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    من المفترض أن تظهر لك النتيجة في النموذج أدناه، حيث يكون xyz هو رقم الإصدار:

    apigee-mirror-4.19.01-0.0.xyz
  2. استخدِم الأداة المساعدة apigee-mirror لتنزيل Edge 4.16.0x/4.17.0x إلى الريبو الخاص بك. لاحِظ كيف تبدأ الأمر بالنسخة المطلوبة:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    استخدِم هذا الأمر نفسه لتحديث الإصدارات 4.16.0x/4.17.0x في وقت لاحق من خلال تحديد أرقام الإصدارات المطلوبة.

  3. افحص دليل /opt/apigee/data/apigee-mirror/repos للاطّلاع على بنية الملف:
    ls /opt/apigee/data/apigee-mirror/repos

    من المفترض أن تظهر لك الملفات والأدلة التالية:

    apigee
    apigee-repo-1.0-6.x86_64.rpm
    bootstrap_4.16.01.sh
    bootstrap_4.16.05.sh
    bootstrap_4.17.01.sh
    bootstrap_4.17.05.sh
    bootstrap_4.17.09.sh
    bootstrap_4.18.01.sh
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.sh
    thirdparty

    لاحظ كيف أن لديك ملف تمهيد لجميع إصدارات Edge. يحتوي الدليل apigee أيضًا على أدلة منفصلة لكل إصدار من إصدارات Edge.

  4. لتجميع ملف repo في ملف .tar، استخدِم الأمر التالي:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    يقوم هذا الأمر بحزم جميع مستودعات 4.17.0x و4.16.0x في نفس ملف .tar. لا يمكنك إضافة حزمة واحدة فقط من الريبو.

لتثبيت Edge من ملف repo المحلي أو ملف .tar، ما عليك سوى التأكّد من تشغيل ملف Bootstrap الصحيح باستخدام أحد الأوامر التالية. في هذا المثال، يتم تثبيت Edge 4.17.01:

  • في حال التثبيت من ملف .tar، شغِّل ملف Bootstrap الصحيح من الريبو:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    لإكمال عملية التثبيت، اتّبِع الخطوات المتبقية من القسم "التثبيت من ملف .tar" أعلاه.

  • في حال التثبيت باستخدام خادم الويب Nginx، نزِّل ملف التمهيد الصحيح ثم شغِّله من الريبو:
    /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
    sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    لإكمال عملية التثبيت، اتّبِع الخطوات المتبقية من القسم "التثبيت من المخزن باستخدام خادم الويب Nginx" أعلاه.