تثبيت Edge Edgewayway

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

الإصدار 3.0.x من Edge Microgateway

يوضّح هذا الموضوع كيفية تثبيت Edge Microgateway أو إلغاء تثبيته.

الحدّ الأدنى من متطلبات الأجهزة

يتطلّب Edge Microgateway الحدّ الأدنى من إعدادات الأجهزة التالية:

• على جهاز افتراضي (VM)، يتطلّب Edge Microgateway توفّر وحدة معالجة مركزية واحدة على الأقل وذاكرة وصول عشوائي بسعة 256 ميغابايت على الأقل. تستهلك عملية Edge Microgateway نفسها أقل من 128 ميغابايت من ذاكرة الوصول العشوائي.
• في الحاوية، يمكن استخدام Microgateway بحجم صورة أقل من 100 ميغابايت.

المتطلبات الأساسية

• يجب أن يكون الإصدار 8.x LTS أو 12.x من Node.js مثبّتًا على نظامك. يمكنك التحقّق من الإصدار عن طريق تنفيذ الأمر التالي:

  node -v
  v12.5.0

• يتطلّب نظام التشغيل Windows تثبيت OpenSSL وإضافته إلى PATH.
• إذا كنت تستخدم Apigee Edge Private Cloud لإجراء عملية الإعداد باستخدام Edge Microgateway، يجب أن يكون لديك الإصدار 4.18.01 أو إصدار أحدث من Private Cloud.

تثبيت Edge Microgateway في حال توفّر اتصال بالإنترنت

يوضّح هذا القسم كيفية تثبيت Edge Microgateway وتهيئة الإعدادات التلقائية. إذا كنت تعمل بدون اتصال بالإنترنت، يُرجى الاطّلاع على هل يمكنني تثبيت Edge Microgateway بدون اتصال بالإنترنت؟.

1. ثبِّت أحدث إصدار من Edge Microgateway مع npm على النحو التالي. يؤدي هذا الأمر إلى تثبيت البرنامج ووضع الملف التنفيذي edgemicro في مسارك.

   npm install edgemicro -g

   لتثبيت إصدار معيّن من Edge Microgateway، عليك تحديد رقم الإصدار في أمر التثبيت. في حال عدم تحديد رقم الإصدار، سيتم تثبيت أحدث إصدار. على سبيل المثال، لتثبيت الإصدار 2.5.7، استخدِم الأمر التالي.

   npm install edgemicro@3.0.2 -g

2. تحقَّق من رقم الإصدار. على سبيل المثال، إذا ثبّت الإصدار 3.0.2:

   edgemicro --version
   current nodejs version is v12.5.0
   current edgemicro version is 3.0.2

3. اتّبِع خطوات الإعداد والضبط الواردة في إعداد Edge Microgateway وضبطها.

ترقية Edge Microgateway

لترقية إصدار Edge Microgateway مثبَّت سابقًا، يُرجى الاطّلاع على ترقية Edge Microgateway في حال توفّر اتصال بالإنترنت.

تنصح Apigee باختبار الإعداد الحالي باستخدام الإصدار الجديد قبل ترقية بيئة التشغيل الفعلي.

تشغيل Edge Microgateway على نظام التشغيل Windows كخدمة

يمكنك تشغيل Edge Microgateway على نظام التشغيل Windows كخدمة. لمزيد من التفاصيل، يُرجى الاطّلاع على أفضل الممارسات للإدارة التشغيلية لـ Microgateway (edgemicro) على نظام التشغيل Windows في منتدى Apigee.

هل يمكنني تثبيت Edge Microgateway بدون اتصال بالإنترنت؟

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

الخطوات الأولى

إذا كنت حديث العهد باستخدام Edge Microgateway، فإنّ إعداد Edge Microgateway وضبطه هو أفضل مكان للبدء بعد إكمال عملية التثبيت. يغطّي دليل الإعداد والضبط جميع الخطوات التي عليك اتّخاذها لتثبيت نسخة من Edge Microgateway وضبطها وبدء استخدامها.

أين يتم تثبيت Edge Microgateway؟

عند استخدام npm مع الخيار العام (npm install -g edgemicro)، يتم تثبيت البرنامج في [prefix]/lib/node_modules/edgemicro. يمكنك العثور على قيمة [prefix] باستخدام الأمر التالي:

npm config get prefix

يتم تلقائيًا ضبط بادئة الإعداد على الموقع الجغرافي الذي تم تثبيت العقدة فيه. في معظم الأنظمة، يكون هذا الحد /usr/local. على نظام التشغيل Windows، يكون %AppData%\npm. يمكن ضبط قيمة [prefix]. راجِع npm-folders لمزيد من المعلومات حول مكان تثبيت وحدات Node.js تلقائيًا وكيفية ضبط موقع التثبيت.

إلغاء تثبيت Edge Microgateway

إذا كنت بحاجة إلى إزالة Edge Microgateway، اتّبِع الخطوات التالية:

1. احذف دليل التثبيت أو أرشفه [prefix]/lib/node_modules/edgemicro، حيث [prefix] هو بادئة npm كما هو موضّح في أين يتم تثبيت Edge Microgateway؟
2. احذف ملفات السجلّ أو أرشفها. تكون ملفات edgemicro-*.log تلقائيًا في /var/tmp/، ولكن يمكن ضبط هذا الموقع. راجِع ملف إعداد Edge Microgateway إذا كنت غير متأكّد.
3. احذف ملفات إعداد وقت التشغيل وملفات إعداد ذاكرة التخزين المؤقت أو أرشفها:

   ~/.edgemicro/*.yaml

توافق Kubernetes

يمكنك استخدام Edge Microgateway لتوفير خدمة إدارة واجهات برمجة التطبيقات من Apigee للخدمات التي تعمل في مجموعة Kubernetes. راجِع نظرة عامة على دمج Edge Microgateway مع Kubernetes.

التوافق مع Docker

يمكنك الآن تنزيل أحدث إصدار من Edge Microgateway كـ صورة Docker:

docker pull gcr.io/apigee-microgateway/edgemicro:latest