הפניות CLI ל-Edge Microgateway

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

‫Edge Microgateway גרסה 2.3.x

סקירה כללית

ה-CLI של Edge Microgateway מאפשר לכם לשלוט בכל ההיבטים של מופע Edge Microgateway ולנהל אותו.

ניהול אישורים

הפקודות cert מאפשרות להתקין ולנהל את זוג המפתחות הציבורי/פרטי שמשמש לחתימה על אסימוני מוכ"ז שמשמשים לקוחות לביצוע קריאות מאובטחות דרך Edge Microgateway. המפתחות מאוחסנים בכספת מאובטחת ב-Apigee Edge. ‫Edge Microgateway משתמש במפתח הציבורי כדי לאמת טוקנים חתומים מסוג bearer. המפתחות האלה נוצרים כשמריצים את הפקודה edgemicro configure, כמו שמוסבר במאמר הגדרה של Edge Microgateway. במקרה הצורך, אפשר להשתמש בפקודות cert שמתוארות כאן כדי ליצור מחדש את המפתחות האלה ולנהל אותם. 

התקנת אישור

המערכת מתקינה את המפתחות בכספת באמצעות שירות המאגר המאובטח של Apigee Edge ומחזירה את המפתח הציבורי כפלט. היקף ההרשאה של זוגות מפתחות מוגבל לארגון שצוין.

שימוש

edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-u, --username שם המשתמש שלכם ב-Apigee. אתם צריכים להיות אדמינים בארגון שצוין.
-p, --password (אופציונלי) הסיסמה שלכם. אם לא תציינו את הפרמטר הזה בשורת הפקודה, תופיע הנחיה.
-f, --force (אופציונלי) אם מפתח כבר מאוחסן בכספת, אפשר לכפות את ההחלפה שלו.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro cert install -o docs -e test -u jdoe@example.com -f

פלט

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
password:
deleting vault
creating vault
adding private_key
adding public_key
installed cert

מחיקת אישור

מחיקת זוג המפתחות של הארגון.

שימוש

edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-u, --username שם המשתמש שלכם ב-Apigee. אתם צריכים להיות אדמינים בארגון שצוין.
-p, --password (אופציונלי) הסיסמה שלכם. אם לא תציינו את הפרמטר הזה בשורת הפקודה, תופיע הנחיה.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro cert delete -o docs -e test -u jdoe@example.com 

פלט

deleting vault
Vault deleted!

בדיקת אישור

בודק אם מותקן אישור בארגון.

שימוש

edgemicro cert check -o [organization] -e [environment] -u [username] -p [password]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-u, --username שם המשתמש שלכם ב-Apigee. אתם צריכים להיות אדמינים בארגון שצוין.
-p, --password (אופציונלי) הסיסמה שלכם. אם לא תציינו את הפרמטר הזה בשורת הפקודה, תופיע הנחיה.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro cert check -o docs -e test -u jdoe@example.com

פלט (הצלחה)

checked cert successfully

פלט (כשל)

אם האישור לא קיים, מוחזרת שגיאה.

קבלת המפתח הציבורי

הפונקציה מחזירה את המפתח הציבורי של הארגון שצוין. לא נדרש אימות.

שימוש

edgemicro cert public-key -o [organization] -e [environment]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro cert public-key -o docs -e test

פלט (דוגמה)

-----BEGIN CERTIFICATE----- 

MIICpDCCAYwCCQCKpXWGum9uTjANBgkq9w0BAQsFADAUMRIwEAYDVQQDEwls
b2NhbGhvc3cNMTYxMTAyMjAxNTA2WhcNMTYxMTAzMjAxNTA2WjAUMRIwEAYD
VQQDEwlsb2Nvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDD
ETr/ne/gP47+9LgjLvBJjpbFVdaeUabZZ3wbA7sSIVnnNXWt3yPklrWSfIh+
L2+dq4k+YunsQE2+dwPdXA2x8DPGvqGcCdWPxnpZ7ix5Akbs8i/J+Ue0pXT4
jkpWbaDDftGL2tcxwP45yI+slpDYvmWRps07TFXkAPjGEHYPvCT9/v/35GkL
0h4v0S+XfpcjS5c47o7CIWlkgEM5GBosQUb17kuVR48392vGFPsnCP34iNe7
zguhiCXYg2zkOcj/N3AE4xKIhCz0QcewULy08GltWMmyjJ/30zs8P41JqoA4
RwfeEZ8RenN3rJQim1ppAAEwDQYJKoZIhvcNAQELBQADggEBAHcORIfc+ySe
2FMmqicNe6Wt5V/5zOaBMLsGQdqGOHB5cQc79sMBrk680KVhrwHXZ2nBIkVe
UEL+2qLY1VLfswBNAvcNwV9U4TwHq4eIANiD751oJK1tHmM/ujThQkwNf96o
6I7Ws+wfpGO3ppJCttRbtnATIxrwsCHN4i5lbW/tJSL7t/Zf6T1B+YSJU9AF
xuvLq22cCqyYJQdmKq2vVS55WRZdllm+mRtJrv7MLM9gfDPRxVlwrBz/eQHy
Fv+dwzxcvQjkz03RNhZUodzuD34DPJoYeK++rItsddwQ26KTahH80yYTAFzY
x9gfPf1/+qo=? 

-----END CERTIFICATE-----

 

הגדרת Edge Microgateway ל-Apigee Edge Cloud

מאפשרת ל-Edge Microgateway לפעול עם מופע של Apigee Edge Cloud. הוא עוטף ומבצע רצף של פקודות כדי לפרוס שרת proxy נדרש לאימות ב-Edge, ליצור טוקנים של אימות ולעדכן קובצי הגדרה. דוגמה מלאה שעובדת מופיעה במאמר הגדרה וקביעת הגדרות של Edge Microgateway.

שימוש

edgemicro configure -o [organization] -e [environment] -u [username] -p [password]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-u, --username שם המשתמש שלכם ב-Apigee. אתם צריכים להיות אדמינים בארגון שצוין.
-p, --password (אופציונלי) הסיסמה שלכם. אם לא תציינו את הפרמטר הזה בשורת הפקודה, תופיע הנחיה.
-r, --url (אופציונלי) מציינים את הכינוי של המארח הווירטואלי עבור הארגון:סביבה. מידע נוסף על מארחים וירטואליים זמין במסמכי התיעוד של Edge. ברירת מחדל: org-env.apigee.net
-v, --virtualHosts (אופציונלי) מחליף את המארחים הווירטואליים שמוגדרים כברירת מחדל, שהם default,secure. משתמשים באפשרות הזו אם יש לכם מארחים וירטואליים שצוינו עבור סביבת הארגון של Edge, שאינם ברירות המחדל האלה. מידע נוסף על מארחים וירטואליים זמין במסמכי התיעוד של Edge.
-d, --debug (אופציונלי) מספק מידע על ניפוי באגים.
-h, --help מידע על השימוש בפלט.

הערות לגבי שימוש

הפקודה הזו שומרת את פרטי ההגדרה ב-‎~/.edgemicro/org-env-config.yaml.

דוגמה

edgemicro configure -o docs -e test -u jdoe@example.com

פלט

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

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

 

יצירת מפתחות

הפקודה genkeys יוצרת זוג של מפתח וסוד שמשמשים את Edge Microgateway לאימות עצמי כשהוא מפרסם באופן אסינכרוני נתוני ניתוח ל-Apigee Edge.

שימוש

edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-u, --username שם המשתמש שלכם ב-Apigee. אתם צריכים להיות אדמינים בארגון שצוין.
-p, --password (אופציונלי) הסיסמה שלכם. אם לא תציינו את הפרמטר הזה בשורת הפקודה, תופיע הנחיה.
-h, --help מידע על השימוש בפלט.

הערות לגבי שימוש

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

  • כתובת URL של bootstrap: כתובת ה-URL הזו מפנה לשירות Apigee Edge שמאפשר למופע של Edge Microgateway לשלוח נתוני ניתוח ל-Apigee Edge. צריך להעתיק את כתובת ה-URL הזו לקובץ ההגדרות של Edge Microgateway: ‏ ‎~/.edgemicro/org-env-config.yaml.
  • ‫key: המפתח. המפתח הזה והסוד נדרשים כקלט לפקודת ה-CLI שמשמשת להפעלת מופע של Edge Microgateway.
  • ‫secret: הסוד.

דוגמה

edgemicro genkeys -o docs -e test -u jdoe@example.com

פלט (דוגמה)

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

configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1
Please copy the following property to the edge micro agent config
  bootstrap: https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/jdoe/environment/test

The following credentials are required to start edge micro
  key: db39324077989c75eac34c13d285772ea8e3b982b957b3f52916f3048511443f
  secret: 5bf8da39de0056f88fdd5f25a8602d22f312c1c8c870580a5fef55ac6637b7ae

finished

 

הגדרת Edge Microgateway ל-Apigee Edge Private Cloud

הגדרת Edge Microgateway לעבודה עם התקנה של Apigee Edge Private Cloud.

שימוש

edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-u, --username שם המשתמש שלכם ב-Apigee. אתם צריכים להיות אדמינים בארגון שצוין.
-p, --password (אופציונלי) הסיסמה שלכם. אם לא תציינו את הפרמטר הזה בשורת הפקודה, תופיע הנחיה.
-r, --runtime-url מציינת את כתובת ה-URL של זמן הריצה עבור המופע של הענן הפרטי.
-m, --mgmt-url כתובת ה-URL של שרת הניהול של מופע הענן הפרטי.
-v, --virtualHosts רשימה של מארחים וירטואליים לארגון שלכם:סביבה, מופרדים בפסיקים. ברירת המחדל היא "default,secure".
-d, --debug (אופציונלי) מספק מידע על ניפוי באגים.
-h, --help מידע על השימוש בפלט.

הערות לגבי שימוש

הפקודה הזו שומרת את פרטי ההגדרה ב-‎~/.edgemicro/org-env-config.yaml.

דוגמה

edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.55.100:9002 -m http://192.162.55.100:8080

פלט

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

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

 

הפעלת Edge Microgateway

לפני שמפעילים את Edge Microgateway, צריך להריץ את הפקודה edgemicro configure (Public Cloud) או edgemicro private configure (Private Cloud). הפקודה configure מחזירה את ערכי המפתח והסוד שנדרשים להפעלת Edge Microgateway.

שימוש

edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-k, --key הערך המרכזי שמוחזר כשמריצים את הפקודה edgemicro configure.
-s, --secret הערך הסודי שמוחזר כשמריצים את הפקודה edgemicro configure.
-p, --processes (אופציונלי) מספר התהליכים להתחלה. ברירת מחדל: מספר ליבות המעבד במערכת.
-d, --pluginDir (אופציונלי) הנתיב המוחלט לספריית הפלאגין.
-r, --port (אופציונלי) מחליף את מספר היציאה שצוין בקובץ ‎~/.edgemicro/org-env-config.yaml. ברירת מחדל: 8000
-c, --cluster

(אופציונלי) מפעיל את Edge Microgateway במצב אשכול.

הערה: האפשרות הזו הוסרה החל מגרסה 2.3.1. בגרסה 2.3.1 ובגרסאות מאוחרות יותר, Edge Micro תמיד מופעל במצב אשכול.

-c --config (אופציונלי) מציינים את המיקום של קובץ default config.yaml. כברירת מחדל, הקובץ הזה נמצא בתיקייה ./config/config.yaml.
-d, --debug (אופציונלי) מספק מידע על ניפוי באגים.
-h, --help מידע על השימוש בפלט.

הגדרת היציאה

הפקודה start מאפשרת לציין מספר יציאה כדי לבטל את היציאה שצוינה בקובץ התצורה. אפשר גם לציין מספר יציאה באמצעות משתנה הסביבה PORT. לדוגמה:

edgemicro start -o docs -e test -k abc123 -s xyz456 -p 2 --port 8002

או

export PORT=8002 
edgemicro start -o org -e test -k key -s secret -p 2

אם היציאה נמצאת בשימוש, Edge Microgateway מחזיר שגיאה.

מידע על אשכולות

‫Edge Microgateway משתמש במודול האשכול של Node.js כדי להפעיל אשכולות. האפשרות Clustering מאפשרת ל-Edge Microgateway לנצל את היתרונות של מערכות מרובות ליבות. פרטים נוספים זמינים במסמכי Node.js. 

דוגמה

edgemicro start -o docs -e test -k abc123 -s xyz456

פלט לדוגמה:

...

PROCESS PID : 54709
installed plugin from analytics
installed plugin from analytics
installed plugin from oauth
installed plugin from oauth
installed plugin from analytics
installed plugin from oauth
5a86b570-a142-11e6-aa1f-6730e9065d6c edge micro listening on port 8000
5a86dc80-a142-11e6-962c-43d9cc723190 edge micro listening on port 8000
5a8751b0-a142-11e6-8241-cf1c517c91eb edge micro listening on port 8000
installed plugin from analytics
installed plugin from oauth
5a924e30-a142-11e6-8740-2944162ce275 edge micro listening on port 8000

 

ניהול טוקנים

הפקודות token מאפשרות לקבל, לפענח ולאמת אסימוני גישה חתומים מסוג OAuth2. אפשר גם לעיין במאמר בנושא אבטחת קריאות ל-API באמצעות אסימון גישה מסוג OAuth2. 

פענוח טוקן

מפענח אסימון bearer מקודד וחתום לייצוג שלו ב-JWT (Java Web Token) בפורמט JSON של טקסט פשוט. האסימון מעביר מידע על אפליקציית הפיתוח ב-Apigee Edge שסיפקה את המפתחות ששימשו ליצירת האסימון, כולל שם האפליקציה, client_id, רשימת מוצרים ועוד.

שימוש

edgemicro token decode -f [filename]

פרמטרים

פרמטרים תיאור
-f, --file השם של קובץ שמכיל את אסימון ה-JWT שרוצים לפענח.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro token decode -f token.jwt

פלט (דוגמה)

{ header: { typ: 'JWT', alg: 'RS256' },

  payload:
   { application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',
     client_id: 'O9ZQRZKnn1rdgcKQgsABSMdOsKS',
     scopes: [],
     api_product_list: [ 'MicroTest' ],
     iat: 1436280566,
     exp: 1436282365 },
  signature: '' }

יצירת טוקן

יוצרת אסימון Bearer חתום. הטוקן מאפשר לאפליקציות לקוח לבצע קריאות מאומתות ל-API אל Edge Microgateway. האסימון הוא אסימון JWT (‏JSON Web Token) שתואם ל-OAuth 2.0. הוא מקבל כקלט את הערכים של מפתח הצרכן (מזהה הלקוח) וסוד הצרכן (סוד הלקוח) מאפליקציית מפתחים רשומה ב-Apigee Edge. אפשר גם לעיין במאמר בנושא אבטחת קריאות ל-API באמצעות אסימון גישה מסוג OAuth2.

שימוש

edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-1, --key מספר הלקוח מאפליקציית המפתחים שמשויכת לשרת ה-proxy שלכם עם תמיכה ב-Microgateway.
-s, --secret סוד הלקוח מאפליקציית הפיתוח שמשויכת לשרת ה-proxy שמותאם ל-Microgateway.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro token get -o docs -e test -i 5UzOwAXGoOeo60aew94PPG5MAZE3aJp -s 6vahKFGS9a3qMLwz

פלט (דוגמה)

{ token: 'eyJ0eXAiOiJKV1JhbGciOiJSUzI1NiJ9Glvbl9uYW1lIjoiNWNiMGY0NTV6TV3
EtOWMzOC00YmJjLWIzNzEtZGMxZTQzOGMxIiwiY2xpZW50X2lkIjoiNVV6T3dBWEdvSU9lbz
YwYWV3OTRQN0c1TUFaRTNhSnAiLCJzY2MiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIkVkZ2
VNaWNyb1Rlc3RQcm9kdWN0Il0sImlhdCI3ODEyMzQ2MSwiZXhwIjoxNDc4MTI1MjYwfQ.Dx5
f5U7PXm8koNGmFX4N6VrxKMJnpndKgoJ5zWSJvBZ6Ccvhlpd85ipIIA5S2A5nx4obYWp_rpY
RJpIGYwyxP6Oq2j0rxnVjdCC4qyYMgthZjhKgEBVBe3s1ndP72GP2vV6PsSA9RQ2-yzsy9r0
TzhAZ3NJTxT1tS0XKqKngE-OhR3fJHVLAzdMDT0AmS9H0Z2NAJtQOuK6RTpCjG9B6Bc48AEM
sj7QSM-1LWiQ8LdY8k_BoC06qsTI7bCQGWwTuqL-ismbcx2bxovUxSemZIaoROfuF-dCZHG3
2aTP75WxBvvNgBBvPvQtPzbeSOtEaww' }

שליחת בקשת HTTP לקבלת טוקן

אפשר גם לשלוח בקשת HTTP גולמית כדי לקבל את הטוקן. הנה דוגמה ל-curl. פשוט מחליפים את שמות הארגון והסביבה בכתובת ה-URL, ומחליפים את הערכים של מזהה הצרכן וסוד הצרכן בפרמטרים client_id ו-client_secret:

curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"

אימות טוקן

מאמת את טוקן ה-Bearer החתום מול המפתח הציבורי שמאוחסן ב-Apigee Edge עבור הארגון והסביבה שצוינו.

שימוש

edgemicro token verify -o [org] -e [env] -f [filename]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-f, --file השם של קובץ שמכיל את ה-JWT לאימות.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro token get -o docs -e test -f token.jwt

פלט לדוגמה של אסימון תקין

{ application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',

  client_id: 'O9ZQRZKnn1rdgcKQsAZUBkQSMdOsKS',

  scopes: [],

  api_product_list: [ 'MicroTest' ],

  iat: 1436396155,

  exp: 1436397954 }

פלט לדוגמה לטוקן לא תקין

{ [JsonWebTokenError: invalid token] name: 'JsonWebTokenError', message: 'invalid token' }

פלט לדוגמה לטוקן שפג תוקפו

{ [TokenExpiredError: jwt expired]

  name: 'TokenExpiredError',

  message: 'jwt expired',

  expiredAt: Tue Jul 07 2015 09:19:25 GMT-0600 (MDT) }

קבלת אסימונים למוכ"ז ישירות

יכול להיות שתעדיפו לקבל אסימוני מוכ"ז ישירות, על ידי שליחת בקשת HTTP לנקודת הקצה של האסימון ב-Apigee Edge. נקודת הקצה של האסימון בפועל מיושמת בשרת ה-Proxy שנפרס באמצעות פקודת ה-CLI של deploy-edge-service.

הנה דוגמה ל-curl. פשוט מחליפים את השמות של הארגון והסביבה ב-URL, ואת הערכים של מזהה הצרכן והסוד של הצרכן שמתקבלים מאפליקציית פיתוח ב-Apigee Edge בפרמטרים client_id ו-client_secret:

curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"

פלט לדוגמה:

HTTP/1.1 200 OK

X-Powered-By: Express

Cache-Control: no-store

Pragma: no-cache

Content-Type: application/json; charset=utf-8

Content-Length: 640

ETag: W/"280-ze/g/k+c9taqp110vjYQ"

Date: Fri, 17 07 2015 15:49:24 GMT

Connection: keep-alive

"<long string of numbers and letters>"

הפעלת הגדרות חדשות של Edge Microgateway

מריצים את הפקודה הזו פעם אחת אחרי שמתקינים את Edge Microgateway בפעם הראשונה. יוצר קובץ תצורה חדש שמוגדר כברירת מחדל: ‎~/.edgemicro/default.yaml.

שימוש

edgemicro init 

פרמטרים

פרמטרים תיאור
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro init

פלט (הצלחה)

config initialized to /MyHome/.edgemicro/default.yaml

אימות ההגדרות של Edge Microgateway

בודק שההגדרה של Edge Microgateway תקינה.

שימוש

edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]

פרמטרים

פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-k, --key הערך המרכזי שמוחזר כשמריצים את הפקודה edgemicro configure.
-s, --secret הערך הסודי שמוחזר כשמריצים את הפקודה edgemicro configure.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro verify -o docs -e test -k abc123 -s xyz456

פלט (הצלחה)

logging to /var/tmp/edgemicro-My-Machine.local-a0c48610-a148-11e6-8466-93f081b05988
installed plugin from analytics
installed plugin from oauth
a0c48610-a148-11e6-8466-93f081b05988 edge micro listening on port 8000
verifying analytics negative case: OK
verifying bootstrap url availability:OK
verifying jwt_public_key availability: OK
verifying products availability: OK
verifying quota with configured products: OK
verifying analytics with payload: OK
verification complete

בדיקת הסטטוס של אשכול מיקרו-שערים

נוספה גרסה: v2.2.4-beta

כברירת מחדל, Edge Microgateway מופעל במצב אשכול. אפשר להשתמש בפקודה הזו כדי לבדוק את סטטוס האשכול.

שימוש

edgemicro status

פרמטרים

פרמטרים תיאור
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro status

פלט (הצלחה)

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
edgemicro is running with 4 workers

הפסקת אשכול המיקרו-שער

נוספה גרסה: v2.2.4-beta

עצירה של אשכול Edge Microgateway.

שימוש

edgemicro stop

פרמטרים

פרמטרים תיאור
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro stop

פלט (הצלחה)

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
Stop Completed Successfully

טעינה מחדש של אשכול המיקרו-שער

נוספה גרסה: v2.2.4-beta

ההגדרה הזו מאפשרת הפעלה מחדש ללא השבתה אחרי שינוי בהגדרות. טעינה מחדש של Edge Microgateway על ידי שליפת הגדרה חדשה.

שימוש

edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]

פרמטרים

>
פרמטרים תיאור
-o, --org הארגון ב-Apigee שעבורו הגדרתם את Edge Microgateway.
-e, --env סביבה שהגדרתם עבורה את Edge Microgateway.
-k, --key הערך המרכזי שמוחזר כשמריצים את הפקודה edgemicro configure.
-s, --secret הערך הסודי שמוחזר כשמריצים את הפקודה edgemicro configure.
-h, --help מידע על השימוש בפלט.

דוגמה

edgemicro reload -o docs -e test -k abc123 -s xyz456

פלט (הצלחה)

...

Reload Completed Successfully