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

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

‫Edge Microgateway גרסה 3.3.x

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

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

כדי להשתמש ב-Edge Microgateway, צריך לעמוד בדרישות המינימליות הבאות מבחינת החומרה:

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

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

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

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

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

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

   npm install edgemicro -g

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

   npm install edgemicro@3.1.5 -g

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

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

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

שדרוג Edge Microgateway

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

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

הפעלת Edge Microgateway ב-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] ניתן להגדרה. מידע נוסף על המיקום שבו מודולים של Node.js מותקנים כברירת מחדל ועל אופן ההגדרה של מיקום ההתקנה מופיע במאמר npm-folders.

הסרת ההתקנה של 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