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

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

لتثبيت Edge على عقدة، عليك أولاً تثبيت الأداة المساعدة Edge apigee-setup. إذا كنت في لا يتوفر فيها اتصال إنترنت خارجي، يجب أيضًا تثبيت والنسخة المحلية من مستودع 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 العائد لكل ألف ظهور قبل تثبيته. الحافة تتطلب الإصدار 4.8 وبعض إصدارات RedHat 7.4 وCentOS 7.4 مع الإصدار الأحدث. إذا كان لديك إصدار أحدث، فألغِ تثبيته وستتولى أداة تثبيت Edge ثم تثبيت الإصدار 4.8.

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

rpm -qa | grep libdb4

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

تثبيت أداة Edge apigee-setup على عقدة ذات اتصال إنترنت خارجي اتصال

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

  1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك username:password حالي لموقع بروتوكول نقل الملفات (ftp) في Apigee، يمكنك استخدام هذَين العنوانَين بيانات الاعتماد.
  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. تنزيل ملف 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
  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 (تلقائي)
    • C: المتابعة بدون تثبيت Java
    • س: إنهاء. لتنفيذ هذا الخيار، يجب تثبيت Java بنفسك.

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

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

    لعرض محتوى Repo، استخدِم الأمر:

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

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

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

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

  • مستودع Apigee Edge: كما هو موضّح في يجب إنشاء مستودع Apigee محلي.
  • Yum repo (للمرافق مثل yum-utils و yum-plugin-priorities): من المفترض أن يكون فريق العمليات قادرًا على إعداد هذا الإجراء نيابةً عنك.
  • حزم إضافية لـ Enterprise Linux (أو EPEL): يجب أن يكون فريق العمليات قادرًا على إعداد هذا من أجل يناسبك ذلك.

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

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

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

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

  1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك كلمة مرور username:password لموقع Apigee ftp، يمكنك استخدام تلك بيانات الاعتماد.
  2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
  3. عطِّل SELinux كما هو موضح أعلاه.
  4. تنزيل ملف 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
  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 لتنزيل لأحدث عائد لكل ألف ظهور. تحتاج إلى مساحة قرص قدرها 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. يصف القسم التالي كيفية تثبيت أداة Edge apigee-setup من المستودع المحلي.

  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-setup على عقدة بعيدة من المستودع المحلي

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

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

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

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

  1. في العقدة التي تضم الموارد المحلية، استخدم الأمر التالي لوضع حزمة 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 المحلي وأداة 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. بشكل تلقائي، يتطلّب المستودع الإعلاني (repo) اسم المستخدم:كلمة المرور 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 أو اسم نظام أسماء النطاقات لعقدة Repo.

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

    حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور في Repo.

  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. تنزيل ملف 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
  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. إذا كنت تريد إنشاء المستودع بأكمله، اتّبِع الخطوات التالية: 
    /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

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

لإضافة 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، تأكَّد من تشغيل برنامج التشغيل الصحيح. ملف باستخدام أحد الأوامر التالية. في ما يلي مثال على تثبيت Edge 4.17.01:

  • في حال التثبيت من ملف .tar، عليك تشغيل ملف التمهيد الصحيح من المستودع:
    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" أعلاه.