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

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

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

إنشاء رابط رمزي من /opt/apigee

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

قبل إنشاء الرابط الرمزي، يجب أولاً إنشاء مستخدم ومجموعة باسم "apigee". هذا هو نفس المجموعة والمستخدم الذي تم إنشاؤه بواسطة أداة تثبيت Edge.

لإنشاء الرابط الرمزي، نفذ هذه الخطوات قبل تنزيل ملف Bootstrap_4.16.05.sh. يجب تنفيذ كل هذه الخطوات كجذر:

1. إنشاء "واجهة برمجة تطبيقات" المستخدم والمجموعة:
   > groupadd -r apigee
   > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "مستخدم نظام Apigee" apigee
2. أنشِئ رابطًا رمزيًا من /opt/apigee إلى التثبيت المطلوب. الجذر:
   > LG -Ts /srv/myInstallDir /opt/apigee
   حيث يكون /srv/myInstallDir هو الموقع المطلوب لشبكة Edge الملفات.
3. تغيير ملكية جذر التثبيت والرابط الرمزي إلى "apigee" المستخدم:
   > تشون -h apigee:apigee /srv/myInstallDir /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

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

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

1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك كلمة مرور username:password لموقع Apigee ftp، يمكنك استخدام تلك بيانات الاعتماد.
2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPMs.
   ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
3. عطِّل SELinux كما هو موضح أعلاه.
4. نزِّل ملف bootstrap_4.16.05.sh في Edge إلى /tmp/bootstrap_4.16.05.sh:
   . > ضفيرة https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
5. ثبِّت الأداة والتبعيات في خدمة Edge apigee:
   > sudo bash /tmp/bootstrap_4.16.05.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*"
6. استخدم apigee-service لتثبيت الأداة المساعدة apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. استخدم apigee-setup لتثبيت مكونات Edge وإعدادها على العقدة. راجع تثبيت مكونات Edge على عقدة لمعرفة المزيد.

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

إذا كانت عُقد Edge محمية بجدار حماية أو يُحظر الوصول إليها بطريقة أخرى مستودع Apigee على الإنترنت، يجب إنشاء مستودع محلي أو إنشاء نسخة مطابقة في مستودع Apigee. يجب أن تكون تلك المرآة متاحة في جميع العُقد. بعد إنشاء العُقد ثم الوصول إلى تلك المرآة المحلية لتثبيت 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. نزِّل ملف bootstrap_4.16.05.sh في Edge إلى /tmp/bootstrap_4.16.05.sh:
   . > ضفيرة https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
6. ثبِّت الأداة والتبعيات في خدمة Edge apigee:
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   
   حيث تمثّل uName:pWord اسم المستخدم وكلمة المرور اللذين تلقّيتهما من خلالهما Apigee. إذا لم تستخدم pWord، سيُطلب منك إدخاله.
7. تثبيت apigee-mirror أداة على العقدة:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror install
8. استخدام 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 من المستودع المحلي.
9. (اختياري) إذا كنت تريد تثبيت Edge من المستودع المحلي على العقدة التي تستضيف المستودع المحلي، فأنت بحاجة أولاً إلى تشغيل الأوامر التالية:
   1. شغِّل bootstrap_4.16.05.sh من الجهاز. Repo لتثبيت أداة apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.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.16.05.tar.gz:
   
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. انسخ ملف .tar إلى العقدة التي تريد تثبيت Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp على الإصدار الجديد العقدة.
3. في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
4. في العقدة الجديدة، عليك إلغاء تنزيل الملف في دليل /tmp:
   > tar -xzf apigee-4.16.05.tar.gz
   
   يؤدي هذا الأمر إلى إنشاء دليل جديد، يسمى repos، في الدليل الذي يحتوي على ملف .tar. على سبيل المثال: /tmp/repos.
5. ثبِّت أداة خدمة Edge apigee والتبعيات من /tmp/repos:
   > sudo bash /tmp/repos/bootstrap_4.16.05.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.16.05.sh على /tmp/bootstrap_4.16.05.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
   
   حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذين حددتهما أعلاه في والمستودع remoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات للمستودع. العقدة.
6. في العقدة البعيدة، عليك تثبيت أداة خدمة واجهة برمجة التطبيقات Edge والتبعيات:
   > sudo bash /tmp/bootstrap_4.16.05.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.16.05.sh، ثم إجراء عملية إنشاء المزامنة:

1. نزِّل ملف Bootstrap_4.16.05.sh على Edge إلى /tmp/bootstrap_4.16.05.sh:
   > ضفيرة https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. إجراء المزامنة:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync --only-new-rpms
3. إذا أردت تنزيل المستودع بأكمله:
   > /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

إضافة الإصدار 4.16.01 من Edge أو تحديثه في مستودع 4.16.05

إذا كان يجب عليك الحفاظ على عمليات التثبيت لكل من Edge 4.16.05 و4.16.01، فيمكنك الاحتفاظ مستودع يحتوي على كلا الإصدارين. ومن هذا المركز، يمكنك بعد ذلك تثبيت Edge 4.16.05 4.16.01.

لإضافة 4.16.01 إلى مستودع 4.15.05:

1. تأكد من تثبيت الإصدار 4.16.05 من الأداة المساعدة apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror Edition
   
   من المفترض أن تظهر لك نتيجة في النموذج أدناه، حيث يكون xyz هو الإصدار الرقم:
   apigee-mirror-4.16.05-0.0.xyz
2. استخدام apigee-mirror لتنزيل الإصدار 4.16.01 من Edge على مستودعك. لاحظ كيف تضع بادئة للأمر apigeereleasever=4.16.01:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service مزامنة apigee-Mirror--only-new-rpms
   
   استخدم هذا الأمر نفسه لتحديث مستودع 4.16.01 لاحقًا.
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 تابع لجهة خارجية
   
   لاحظ كيف أن لديك ملف تمهيد لكلا الإصدارين من Edge. يحتوي الدليل apigee أيضًا على علامات منفصلة لكل إصدار من Edge.
4. لوضع حزمة repo في ملف .tar، استخدِم الأمر التالي:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service حزمة apigee-mirror
   
   يجمع هذا الأمر كلاً من المستودعين 4.16.05 و4.16.01 في نفس ملف .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" أعلاه.