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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

Edge Microgateway v. 2.3.x

קהל

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

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

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

התקנת Node.js

במערכת צריכה להיות מותקנת מערכת Node.js מגרסה 4.5 ואילך. כדי לבדוק אפשר לבצע את הפעולות הבאות:

node -v

יש הרבה דרכים לקבל או לעדכן את Node.js. לדוגמה, אפשר להשתמש ב-HomeBrew או yum, או להוריד אותם ישירות מאתר Node.js: https://nodejs.org/download.

התקנת Edge Microgateway אם יש לך חיבור לאינטרנט

בקטע הזה מוסבר איך להתקין את Edge Microgateway ולאתחל הגדרת ברירת מחדל.

1. מתקינים את הגרסה העדכנית של Edge Microgateway עם npm באמצעות הפקודה הבאה. הפקודה הזו מתקינה את התוכנה ומוסיפה את קובץ ההפעלה edgemicro לנתיב שלכם. כדי לדעת בדיוק היכן הפקודה הבאה מתקינה את Edge Microgateway, עיינו בקטע Where is Edge Microgateway installed?

   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.

הפעלת Microgateway של Edge ב-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