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

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

Edge Microgateway v. 3.1.x

כאן מוסבר איך להתקין או להסיר את Edge Microgateway.

דרישות חומרה מינימליות

Edge Microgateway דורש את תצורת החומרה המינימלית הבאה:

• במכונה וירטואלית (VM), Edge Microgateway דורש לפחות ליבה אחת ולפחות 256MB של RAM. התהליך של Edge Microgateway עצמו דורש פחות מ-128MB של זיכרון RAM.
• בקונטיינר, ניתן להשתמש ב-Microgateway עם גודל תמונה של פחות מ-100MB.

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

• ב-Apigee יש תמיכה בגרסאות LTS או תחזוקה של LTS ב-Windows, ב-macOS וב-Linux. למידע נוסף, אפשר לקרוא את המאמר בנושא תוכנות נתמכות של Apigee Edge Microgateway.
• כדי להשתמש ב-Windows צריך להתקין את OpenSSL ולהוסיף אותו ל-PATH.
• אם משתמשים בענן הפרטי של Apigee Edge להגדרה באמצעות Edge Microgateway, צריך להשתמש בגרסה 4.18.01 ואילך של הענן הפרטי.

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

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

1. מתקינים את הגרסה האחרונה של Edge Microgateway עם npm באופן הבא. הפקודה מתקינה את התוכנה ומוסיפה את קובץ ההפעלה edgemicro לנתיב שלכם.

   npm install edgemicro -g
   

   כדי להתקין גרסה ספציפית של Edge Microgateway, צריך לציין את מספר הגרסה בפקודת ההתקנה. אם לא מציינים את מספר הגרסה, הגרסה האחרונה תותקן. לדוגמה, כדי להתקין את גרסה 3.1.0, משתמשים בפקודה הבאה.

   npm install edgemicro@3.1.0 -g
   

2. בודקים את מספר הגרסה. לדוגמה, אם התקנתם את גרסה 3.1.0:

   edgemicro --version
   current nodejs version is v12.5.0
   current edgemicro version is 3.1.0
   

3. פועלים לפי שלבי ההגדרה והתצורה במאמר הגדרה והגדרה של Edge Microgateway.

שדרוג מיקרו-שער של Edge

כדי לשדרג גרסה של Edge Microgateway שהותקנה בעבר, קראו את המאמר שדרוג מיקרו-שער של Edge אם יש לך חיבור לאינטרנט.

ב-Apigee מומלץ לבדוק את ההגדרה הקיימת באמצעות הגרסה החדשה לפני השדרוג של סביבת הייצור.

הפעלת 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

ברירת המחדל של הגדרת התחילית היא המיקום שבו הצומת מותקן. ברוב המערכות, המצב הוא /usr/local. ב-Windows, היא %AppData%\npm. אפשר להגדיר את הערך של [prefix]. בקטע npm-folders אפשר לקרוא מידע נוסף על המיקום שבו המודולים של Node.js מותקנים כברירת מחדל, ואיך להגדיר את מיקום ההתקנה.

הסרת Edge Microgateway

אם צריך להסיר את Edge Microgateway:

1. מוחקים או מעבירים לארכיון את ספריית ההתקנה [prefix]/lib/node_modules/edgemicro, כאשר [prefix] היא קידומת ה-npm כפי שמוסבר במאמר איפה מותקן Edge Microgateway?
2. מוחקים את קובצי היומן או מעבירים אותם לארכיון. כברירת מחדל, הקבצים של edgemicro-*.log נמצאים ב-/var/tmp/, אבל ניתן להגדיר את המיקום הזה. אם יש ספק, בדקו את קובץ התצורה של Edge Microgateway.
3. מוחקים או מעבירים לארכיון את קובצי התצורה של זמן הריצה ואת קובצי התצורה של המטמון:

   ~/.edgemicro/*.yaml
   

תמיכה ב-Kubernetes

אפשר להשתמש ב-Edge Microgateway כדי לספק ניהול של Apigee API לשירותים שפועלים באשכול Kubernetes. אפשר לקרוא את המאמר שילוב Edge Microgateway עם סקירה כללית של Kubernetes.

תמיכה ב-Docker

עכשיו ניתן להוריד את הגרסה האחרונה של Edge Microgateway כתמונת Docker:

docker pull gcr.io/apigee-microgateway/edgemicro:latest