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

Edge for Private Cloud، الإصدار 4.17.01

لتثبيت 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:
      صدى 0 > /selinux/enforce

      لإعادة تفعيل SELinux بعد تثبيت Edge:
      صدى الصوت 1 > /selinux/enforce
    2. على نظام التشغيل Linux 7.x:
      setenforce 0

      لإعادة تفعيل SELinux بعد تثبيت Edge:
      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 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 6.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

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

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

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

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

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

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

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

    لعرض محتوى Repo، استخدِم الأمر:
    > sudo yum -v Repolist "apigee*"
  7. (CentOS-6.x وRedHat-6.x فقط) في جميع عُقد Qpid، شغِّل ما يلي: للتأكد من تنزيل إصدار Qpid الصحيح:
    > yum install apigee-qpidd --disablerepo=epel
  8. استخدم apigee-service لتثبيت الأداة المساعدة apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  9. استخدم apigee-setup لتثبيت مكونات Edge وإعدادها على العقدة. راجع تثبيت مكونات Edge على عقدة لمعرفة المزيد.

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

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

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

ملاحظة: لا تستضيف Apigee جميع الموارد التابعة لجهات خارجية في المتاحة للجميع المستودعات. يجب تنزيل هذه التبعيات وتثبيتها من قائمة يمكن للجميع الوصول إليها المستودعات.

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

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

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

  1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك كلمة مرور username:password لموقع Apigee ftp، يمكنك استخدام تلك بيانات الاعتماد.
  2. سجِّل الدخول إلى عقدة RedHat أو CentOS كجذر لتثبيت Edge RPM.
    ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
  3. تأكَّد من تثبيت أحدث إصدار من تطبيق yum-utils:
    > تحديث sudo yum yum-utils
  4. عطِّل SELinux كما هو موضح أعلاه.
  5. تفعيل مستودع EPEL كما هو موضح أعلاه.
  6. نزِّل ملف bootstrap_4.17.01.sh في Edge إلى /tmp/bootstrap_4.17.01.sh:
    . > ضفيرة https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  7. (CentOS-6.x وRedHat-6.x فقط) شغِّل الأمر التالي للتأكد تنزيل إصدار Qpid الصحيح:
    > yum install apigee-qpidd --disablerepo=epel
  8. ثبِّت الأداة والتبعيات في خدمة Edge apigee:
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    حيث تمثّل uName:pWord اسم المستخدم وكلمة المرور اللذين تلقّيتهما من خلالهما Apigee. إذا لم تستخدم pWord، سيُطلب منك إدخاله.
  9. تثبيت apigee-mirror أداة على العقدة:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror install

    ملاحظة: في حال تحديث مستودع حالي إلى 4.17.01، ما عليك سوى تحديثه. apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
  10. استخدام 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 من المستودع المحلي.
  11. (اختياري) إذا كنت تريد تثبيت Edge من المستودع المحلي على العقدة التي تستضيف المستودع المحلي، فأنت بحاجة أولاً إلى تشغيل الأوامر التالية:
    1. شغِّل bootstrap_4.17.01.sh من الجهاز. Repo لتثبيت أداة apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.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:

  1. في العقدة التي تضم الموارد المحلية، استخدم الأمر التالي لوضع حزمة repo المحلية في ملف tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz:

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. انسخ ملف .tar إلى العقدة التي تريد تثبيت Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp على الإصدار الجديد العقدة.
  3. في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
  4. في العقدة الجديدة، عليك إلغاء تنزيل الملف في دليل /tmp:
    > tar -xzf apigee-4.17.01.tar.gz

    يؤدي هذا الأمر إلى إنشاء دليل جديد، يسمى repos، في الدليل الذي يحتوي على ملف .tar. على سبيل المثال: /tmp/repos.
  5. ثبِّت أداة خدمة Edge apigee والتبعيات من /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    لاحظ أنك قمت بتضمين المسار إلى دليل repos في هذا الأمر.
  6. استخدِم apigee-service من أجل: تثبيت apigee-setup شركة الطاقة:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. استخدام apigee-setup للتثبيت وإعداد مكونات Edge على العقدة. راجع تثبيت مكونات Edge على عقدة لمعرفة المزيد.

التثبيت من المستودع باستخدام خادم ويب 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 إعادة تشغيل
  3. بشكل تلقائي، يتطلب المستودع (repo) اسم المستخدِم:كلمة المرور لـ admin:admin. لتغيير بيانات الاعتماد هذه، إعداد متغيّرات البيئة التالية:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
  5. في العقدة البعيدة، نزِّل ملف Edge Bootstrap_4.17.01.sh على /tmp/bootstrap_4.17.01.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

    حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذين حددتهما أعلاه في والمستودع remoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات للمستودع. العقدة.
  6. في العقدة البعيدة، عليك تثبيت أداة خدمة واجهة برمجة التطبيقات Edge والتبعيات:
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    حيث يكون uName:pWord هو اسم المستخدم للمستودع وكلمة المرور.
  7. في العقدة البعيدة، استخدِم apigee-service لتثبيت الأداة apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. استخدام apigee-setup للتثبيت وإعداد مكونات Edge على العقدة البعيدة. راجع تثبيت مكونات Edge على عقدة لمعرفة المزيد.

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

لتحديث المستودع، يجب تنزيل أحدث ملف Bootstrap_4.17.01.sh، ثم إجراء عملية إنشاء المزامنة:

  1. نزِّل ملف Bootstrap_4.17.01.sh على Edge إلى /tmp/bootstrap_4.17.01.sh:
    > ضفيرة https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  2. شغِّل ملف bootstrap_4.17.01.sh على Edge:
    . > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذين المستلَمة من Apigee. إذا لم تستخدم pWord، سيُطلب منك وإدخاله.
  3. تعديل apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
  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.01/4.16.05/4.16.09 في مستودع 4.17.01

إذا كان يجب عليك الاحتفاظ بعمليات تثبيت Edge 4.16.0x في مستودع 4.17.01، يمكنك الاحتفاظ مستودع يتضمّن جميع الإصدارات. ومن خلال هذا المستودع، يمكنك تثبيت أي إصدار من Edge.

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

  1. تأكد من تثبيت الإصدار 4.17.01 من الأداة المساعدة apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror Edition

    من المفترض أن تظهر لك نتيجة في النموذج أدناه، حيث يكون xyz هو الإصدار الرقم:
    apigee-mirror-4.17.01-0.0.xyz
  2. استخدام apigee-mirror لتنزيل Edge 4.16.01/4.16.05/4.16.09 إلى المستودع. لاحظ كيف تضع بادئة الأمر apigeereleasever=4.16.01 أو apigeereleasever=4.16.05:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service مزامنة apigee-Mirror--only-new-rpms

    استخدم هذا الأمر نفسه لتحديث مستودعات 4.16.05/4.16.09 لاحقًا من خلال تحديد أرقام الإصدارات.
  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 جهة خارجية

    لاحظ كيف لديك ملف تمهيد لجميع إصدارات Edge. يحتوي الدليل apigee أيضًا على علامات منفصلة لكل إصدار من Edge.
  4. لوضع حزمة repo في ملف .tar، استخدِم الأمر التالي:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service حزمة apigee-mirror

    يجمع هذا الأمر كلاً من المستودعين 4.17.01 و4.16.0x في نفس ملف .tar. لا يمكنك حزمة جزء فقط من المستودع.

لتثبيت Edge من ملف repo المحلي أو ملف .tar، تأكَّد من تشغيل برنامج التشغيل الصحيح. ملف باستخدام أحد الأوامر التالية:

  • في حال التثبيت من ملف .tar، عليك تشغيل ملف التمهيد الصحيح من المستودع:
    > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    لإكمال عملية التثبيت، يُرجى اتّباع الخطوات المتبقية من القسم "التثبيت من ملف .tar". أعلاه.
  • في حال التثبيت باستخدام خادم ويب Nginx، يجب تنزيل ملف التمهيد الصحيح وتشغيله من المستودع:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o. /tmp/bootstrap_4.16.0X.sh
    > sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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