Edge for Private Cloud - الإصدار 4.16.05
لتثبيت Edge على عقدة، يجب أولاً تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge. إذا كنت في بيئة لا تحتوي العُقد فيها على اتصال خارجي بالإنترنت، يجب أيضًا تثبيت نسخة محلية من مستودع Apigee.
إنشاء رابط رمزي من /opt/apigee
يثبّت Edge جميع الملفات في الدليل /opt/apigee. ولا يمكنك تغيير هذا الدليل. ومع ذلك، يمكنك إنشاء رابط رمزي لربط /opt/apigee بموقع جغرافي آخر، إذا رغبت في ذلك.
قبل إنشاء الرابط الرمزي، يجب أولاً إنشاء مستخدم ومجموعة باسم "apigee". وهذه هي المجموعة والمستخدم نفسهما اللتان تم إنشاؤهما بواسطة أداة تثبيت Edge.
لإنشاء الرابط الرمزي، نفذ هذه الخطوات قبل تنزيل ملف Bootstrap_4.16.05.sh. يجب تنفيذ كل هذه الخطوات كجذر:
- أنشئ مستخدم ومجموعة "apigee":
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee Platform user" apigee - أنشِئ رابطًا رمزيًا من /opt/apigee إلى جذر التثبيت المطلوب:
> ln -Ts /srv/myInstallDir /opt/apigee
حيث يكون /srv/myInstallDir هو المكان المطلوب لملفات Edge. - غيِّر ملكية جذر التثبيت والرابط الرمزي لمستخدم "apigee":
> chown -h apigee:apigee /srv/myInstallDir /opt/apigee
المتطلبات الأساسية: إيقاف SELinux
يجب إيقاف SELinux أو ضبطه على الوضع المتساهِل قبل تثبيت الأداة المساعدة apigee-setup في Edge أو أيّ من مكونات Edge. وإذا لزم الأمر، بعد تثبيت Edge، يمكنك إعادة تمكين SELinux.
- لضبط SELinux على الوضع المتساهِل مؤقتًا، نفِّذ الأمر
التالي:
- على نظام التشغيل Linux 6.x:
echo 0 > /selinux/enforce
لإعادة تفعيل SELinux بعد تثبيت Edge:
echo 1 > /selinux/enforce - على نظام التشغيل Linux 7.x:
setenforce 0
لإعادة تفعيل SELinux بعد تثبيت Edge:
setenforce 1
- على نظام التشغيل Linux 6.x:
- لإيقاف SELinux بشكل دائم أو ضبطه على الوضع المتساهِل:
- افتح /etc/sysconfig/selinux في محرِّر.
- اضبط SELINUX=disabled أو SELINUX=permissive.
- احفظ التعديلات.
- أعِد تشغيل العُقدة.
- إذا لزم الأمر، أعِد تفعيل SELinux بعد تثبيت Edge من خلال تكرار هذا الإجراء لضبط SELINUX=enabled.
تثبيت أداة إعداد واجهة برمجة التطبيقات Edge على عقدة مزوّدة باتصال خارجي بالإنترنت
لتثبيت Edge على عقدة تتضمن اتصال إنترنت خارجي:
- احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك حاليًا اسم المستخدم:كلمة مرور لموقع Apigee ftp الإلكتروني، يمكنك استخدام بيانات الاعتماد هذه.
- تسجيل الدخول إلى العقدة كجذر لتثبيت Edge RPMs
ملاحظة: على الرغم من أنّ تثبيت RPM يتطلّب الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون الوصول إلى الجذر. - عطِّل SELinux كما هو موضح أعلاه.
- نزِّل ملف Edge bootstrap_4.16.05.sh من أجل /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - ثبِّت الأداة المساعدة apigee-service والتبعيات:
> 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. لعرض ملف التعريف، استخدِم الأمر:
> cat /etc/yum.repos.d/apigee.repo
لعرض محتوى المخزن، استخدِم الأمر:
> sudo yum -v repolist 'apigee*' - استخدِم apigee-service لتثبيت الأداة apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - استخدم إعداد apigee لتثبيت مكونات Edge وتهيئتها على العقدة. راجع تثبيت مكونات Edge على عقدة لمزيد من المعلومات.
تثبيت أداة إعداد واجهة برمجة التطبيقات Edge على عقدة بدون اتصال خارجي بالإنترنت
إذا كانت عُقد Edge خلف جدار حماية أو تم منعها بأي طريقة أخرى من الوصول إلى مستودع Apigee على الإنترنت، يجب إنشاء مستودع محلي، أو نسخة مطابقة له، من مستودع Apigee. ويجب أن تكون هذه النسخة المطابِقة مُتاحة لجميع العُقد. بعد إنشائها، يمكن للعُقد الوصول إلى النسخة المطابقة المحلية لتثبيت Edge.
ملاحظة: لا تستضيف Apigee جميع العناصر الاعتمادية التابعة لجهات خارجية في مستودعاتنا العامة. ويجب تنزيل هذه التبعيات وتثبيتها من مستودعات متاحة للجميع.
بعد إنشاء مستودع محلي في Edge، قد تحتاج لاحقًا إلى تحديثه باستخدام أحدث ملفات إصدار Edge. توضّح الأقسام التالية طريقة إنشاء مستودع محلي وكيفية تعديله.
إنشاء مستودع Apigee محلي
لإنشاء مستودع Apigee محلي:
- احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك حاليًا اسم المستخدم:كلمة مرور لموقع Apigee ftp الإلكتروني، يمكنك استخدام بيانات الاعتماد هذه.
- سجِّل الدخول إلى عقدة RedHat أو CentOS كجذر لتثبيت Edge RPM.
ملاحظة: على الرغم من أنّ تثبيت RPM يتطلب الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون الوصول إلى الجذر. - تأكَّد من أنّ لديك أحدث إصدار من أداة yum-utils:
> sudo yum update yum-utils. - عطِّل SELinux كما هو موضح أعلاه.
- نزِّل ملف Edge bootstrap_4.16.05.sh من أجل /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - ثبِّت الأداة المساعدة Edge apigee-service والتبعيات:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذَين حصلت عليهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخالها. - ثبِّت الأداة apigee-Mirror
على العقدة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror install - استخدِم الأداة 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
إذا أردت تنزيل المخزن بالكامل، بما في ذلك RPM الأقدم، احذف --only-new-rpms. تحتاج إلى مساحة على القرص تبلغ 6 غيغابايت تقريبًا للتنزيل الكامل:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror Sync
لديك الآن نسخة محلية من مستودع Apigee. يوضّح القسم التالي كيفية تثبيت أداة apigee-setup في Edge من المخزن المحلي. -
(اختياري) إذا أردت تثبيت Edge من المخزن المحلي على العقدة نفسها التي تستضيف الريبو المحلي، عليك أولاً تشغيل الأوامر التالية:
- شغِّل bootstrap_4.16.05.sh من repo المحلي لتثبيت الأداة apigee-service:
> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepodata/apigeerepo - استخدِم apigee-service لتثبيت
الأداة المساعدة apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - استخدم apigee-setup لتثبيت مكونات Edge وضبطها على العقدة. راجع تثبيت مكونات Edge على عقدة لمزيد من المعلومات.
- شغِّل bootstrap_4.16.05.sh من repo المحلي لتثبيت الأداة apigee-service:
تثبيت إعداد apigee على عقدة بعيدة من مستودع محلي
لديك خياران لتثبيت Edge من المخزن المحلي. يمكنك تنفيذ إجراء مما يلي:
- أنشِئ ملف .tar من ملف repo، وانسخ ملف .tar إلى عقدة، ثم ثبِّت Edge من ملف .tar.
- قم بتثبيت خادم ويب على العقدة باستخدام الريبو المحلي حتى تتمكن العُقد الأخرى من الوصول إليه. يوفر لك Apigee خادم ويب Nginx لتستخدمه، أو يمكنك استخدام خادم الويب الخاص بك.
التثبيت من ملف .tar:
- في العقدة التي تتضمن repo المحلي، استخدِم الأمر التالي لتجميع repo المحلي في
ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
> /opt/apigee/apigee-service/bin/apigee-service package apigee-service apigee - انسخ ملف tar إلى العقدة التي تريد تثبيت Edge فيها. على سبيل المثال، انسخه إلى الدليل /tmp على العقدة الجديدة.
- في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
- في العقدة الجديدة، أزِل الملف إلى دليل /tmp:
> tar -xzf apigee-4.16.05.tar.gz
ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف .tar. على سبيل المثال: /tmp/repos. - ثبِّت الأداة المساعدة Edge apigee-service والتبعيات من /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
- استخدِم apigee-service لتثبيت
الأداة المساعدة apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - استخدم apigee-setup لتثبيت مكونات Edge على العقدة وإعدادها. راجع تثبيت مكونات Edge على عقدة لمزيد من المعلومات.
التثبيت من المخزن باستخدام خادم الويب Nginx:
- ثبِّت خادم الويب Nginx على عقدة repo:
> opt/apigee/apigee-service/bin/apigee-service apigee-Mirror nginxconfig - يتم ضبط Nginx تلقائيًا لاستخدام المضيف المحلي كاسم الخادم والمنفذ 3939. لتغيير
هذه القيم:
- افتح /opt/apigee/customer/application/mirror.properties في محرِّر. أنشئ الملف إذا لم يكن موجودًا.
- اضبط القيم التالية حسب الضرورة:
conf_apigee_Mirror_listen_port=3939
conf_apigee_Mirror_server_name=localhost - أعِد تشغيل Nginx:
> /opt/nginx/scripts/apigee-nginx إعادة تشغيل
- بشكل تلقائي، يتطلب المخزن اسم مستخدم:كلمة مرور لـ admin:admin. لتغيير بيانات الاعتماد هذه،
اضبط متغيرات البيئة التالية:
MIRROR_USERNAME=uName
MIRROR_password=pWord - في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
- في العقدة البعيدة، نزِّل ملف Edge Bootstrap_4.16.05.sh إلى /tmp/bootstrap_4.16.05.sh:
> /usr/bin/curl http://uName:pWord@remoteRepoName@remoteRepoName:3939/bootstrap_4.
- في العقدة البعيدة، ثبِّت الأداة المساعدة Edge apigee-service والتبعيات:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeepassword=pWord - في العقدة البعيدة، استخدِم apigee-service لتثبيت الأداة apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - استخدم apigee-setup لتثبيت مكونات Edge وإعدادها على العقدة البعيدة. راجع تثبيت مكونات Edge على عقدة لمزيد من المعلومات.
تعديل مستودع Apigee محلي
لتحديث المخزن، يجب تنزيل ملف Bootstrap_4.16.05.sh الأحدث، ثم تنفيذ عملية مزامنة جديدة:
- نزِّل ملف Edge Bootstrap_4.16.05.sh إلى /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - نفِّذ المزامنة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror Sync --only-new-rpms - إذا أردت تنزيل الريبو بأكمله:
> /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.05 و4.16.01 من Edge، يمكنك الاحتفاظ بمستودع إعلاني يحتوي على كلا الإصدارين. من هذا المستودع، يمكنك بعد ذلك تثبيت Edge 4.16.05 و4.16.01.
لإضافة 4.16.01 إلى مستودع 4.15.05:
- يُرجى التأكّد من تثبيت الإصدار 4.16.05 من الأداة المساعدة apigee-المرآة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror version
من المفترَض أن تظهر لك نتيجة في النموذج أدناه، حيث يكون رقم xyz هو:
apigee-xyz.0.xyzxyz.. - استخدِم الأداة apigee-المرآة لتنزيل Edge 4.16.01 على الريبو الخاص بك. لاحِظ كيف تبدأ الأمر بـ
apigeereleasever=4.16.01:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror Sync --only-new-rpms
يمكنك استخدام هذا الأمر نفسه لتحديث 1.0 4.repo. - راجِع الدليل /opt/apigee/data/apigee-mirror/repos للاطّلاع على بنية الملف:
> ls /opt/apigee/data/apigee-Mirror/repos
من المفترض أن تظهر لك الملفات والأدلة التالية:
apigee apigee-repo-1.0-6.x86_boot0 .
filegee-repo-1.0-6.x86_boot0.3 {end.max.boostrap4.
. Edge_64. Edge.الفروع.
يحتوي دليل apigee أيضًا على أدلة منفصلة لكل إصدار من إصدارات Edge. - لتجميع repo في ملفّ .tar، استخدِم الأمر التالي:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror package
يضيف هذا الأمر كلاً من حزمتي 4.16.05 و4.16.01 نفسها إلى ملف repos. نفسه لا يمكنك إضافة حزمة واحدة فقط من الريبو.
لتثبيت متصفّح Edge من ملف repo المحلي أو ملف .tar، ما عليك سوى التأكّد من تشغيل ملف Bootstrap الصحيح باستخدام أحد الأوامر التالية:
- في حال التثبيت من ملف .tar، شغِّل ملف التمهيد الصحيح من الريبو:
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
لإكمال عملية التثبيت، اتّبِع الخطوات المتبقية من "تثبيت الملف." - في حال التثبيت باستخدام خادم الويب Nginx، نزِّل ملف Bootstrap الصحيح ثم شغِّله من repo:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_remote_protocol/bootstrap_remote/remoteed protocol.
repotstrap_remoteed protocol.
Repotstrap.