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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

‫Edge Microgateway גרסה 2.3.x

קהל

המדריך הזה מיועד למי שצריך להתקין או להסיר את Edge Microgateway.

דרישות מוקדמות

• במערכת שלכם צריכה להיות מותקנת גרסה 4.5 LTS ואילך של Node.js. הוראות נוספות ל-Node.js מפורטות בהמשך.
• ב-Windows צריך להתקין את OpenSSL ולהוסיף אותו לPATH.
• אם אתם משתמשים בענן הפרטי של Apigee Edge כדי להגדיר את Edge Microgateway, אתם צריכים להשתמש בענן הפרטי מגרסה 4.15.07 ואילך.

התקנת 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 באמצעות הפקודה הבאה, אפשר לעיין במאמר איפה מותקן 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, כדאי להתחיל עם המאמר Installing 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