התקנת מיקרו-שער של Edge

אתם צופים במסמכי התיעוד של 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 כשירות. מידע נוסף מופיע במאמר Best practices for operational management of Microgateway (edgemicro) on 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