تثبيت Edge Edgewayway

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

Edge Microgateway، الإصدار 2.4.x

الجمهور

استعن بهذا الدليل إذا كنت بحاجة إلى تركيب أو إلغاء تثبيت Edge Microgateway.

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

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

تثبيت Node.js

يجب أن يكون لديك الإصدار 4.5 أو إصدار أحدث من Node.js على نظامك. يمكنك التحقق من ذلك من خلال تنفيذ ما يلي:

node -v

وهناك العديد من الطرق للحصول على Node.js أو تحديثها. على سبيل المثال، يمكنك استخدام HomeBrew أو yum أو تنزيله مباشرةً من موقع Node.js الإلكتروني: https://nodejs.org/download.

تثبيت Edge Microgateway إذا كان لديك اتصال بالإنترنت

يوضّح هذا القسم طريقة تثبيت Edge Microgateway وضبط الإعدادات التلقائية.

  1. ثبِّت أحدث إصدار من Edge Microgateway باستخدام npm باستخدام الأمر التالي. يثبّت هذا الأمر البرنامج ويضع ملف edgemicro التنفيذي في مسارك. يمكنك الاطّلاع أيضًا على القسم أين يتم تثبيت Edge Microgateway؟. 
    npm install edgemicro -g

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

    npm install edgemicro@2.3.1 -g
  2. تحقَّق من رقم الإصدار. على سبيل المثال، في حال تثبيت الإصدار 2.3.5: 
    edgemicro --version
current nodejs version is v6.1.0
current edgemicro version is 2.3.5
  3. نفِّذ هذا الأمر لإنشاء ملف إعداد تلقائي في الدليل الرئيسي. 
    edgemicro init
  4. (اختياري) تم وضع ملف إعداد يُسمى default.yaml في الدليل الرئيسي في دليل فرعي باسم .edgemicro. تحقَّق الآن للتأكد من وجود هذا الملف: 
    ls ~/.edgemicro
default.yaml

    ملاحظة: في مستندات Edge Microgateway، نشير إلى الدليل الرئيسي بعلامة التلدة (~)، وهو اختصار UNIX. إذا كنت تستخدم نظام التشغيل Windows، وإذا كنت تشغّل واجهة أوامر لا تتيح رمز التلدة، ستحتاج إلى استبدال متغيّر البيئة المناسب بعلامة التلدة في الأوامر التي تشير إلى الدليل الرئيسي. على سبيل المثال: %USERPROFILE%/.edgemicro.

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

تشغيل 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

قيمة [prefix] قابلة للضبط. راجع npm-folders للحصول على مزيد من المعلومات.

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

إذا كنت بحاجة إلى إزالة Edge Microgateway:

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