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

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

Edge Microgateway v. 2.4.x

קהל

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

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

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

התקנת 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?

   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, כדאי להתחיל בהגדרה ובהגדרה של 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