תחילת העבודה עם Node.js ב-Apigee Edge

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

במאמר הזה מוסבר על הדרך הפשוטה ביותר לעטוף אפליקציית Node.js בפרוקסי של API באמצעות ממשק המשתמש לניהול.

מבוא

סביר להניח שהאפליקציה הראשונה ב-Node.js שיצרתם הייתה שרת HTTP שמגיב לבקשות עם "Hello World!‎". הדרך הכי פשוטה לנסות את Node.js ב-Apigee Edge היא לעשות משהו דומה מאוד. בכמה לחיצות עכבר בלבד, תוכלו להפעיל ב-Edge שרת HTTP של Node.js שפועל באמצעות proxy. אחרי זה, אפשר להשתמש בכלי לעריכת קוד בממשק המשתמש כדי לשנות את אפליקציית Node.js, להוסיף קובצי Node.js נוספים, להוסיף מדיניות וכו'.

יצירת הדוגמה Hello World!‎ proxy ל-API

בקטע הזה מוסבר איך ליצור שרת proxy ל-API של Edge שמקיים אינטראקציה עם שרת HTTP של Node.js. קוד שרת ה-HTTP של Node.js כבר כתוב בשבילכם, והוא נפרס אוטומטית ל-Edge כשפועלים לפי השלבים הפשוטים האלה.
  1. באשף Build a Proxy, בוחרים באפשרות Node.js App.
  2. לוחצים על הבא.
  3. פועלים לפי ההוראות באשף Build a Proxy (יצירת שרת proxy) ובוחרים באפשרויות הבאות.
    שדה בחירה
    פרטים
    שם ה-Proxy צריך להזין Nodejs-Hello. השם שמוצג עבור ה-API.
    נתיב בסיס של שרת proxy מזינים nodejs-hello
    מקור בוחרים באפשרות דוגמה של Hello World. (בהמשך הנושא הזה נדון באפשרויות האחרות).
    תיאור מזינים תיאור של ה-API.
    אבטחה
    העברה (ללא) בוחרים באפשרות העברה (ללא). יוצר שרת proxy פשוט למעבר נתונים.
    מארחים וירטואליים
    ברירת מחדל, מאובטח אל תשנו את ברירות המחדל. מידע נוסף על מארחים וירטואליים זמין במאמר מידע על מארחים וירטואליים (בטא).
    Build
    פריסת סביבות בוחרים באפשרות בדיקה.
  4. לוחצים על Build and Deploy (יצירה ופריסה)
    בתגובה, אמור להופיע אישור לכך שנוצר proxy ל-API חדש ושהוא נפרס בסביבת הבדיקה.
  5. לוחצים על View the <proxy name> proxy in the editor כדי להציג את דף הפרטים של ה-proxy ל-API.

הפעלת שרת ה-proxy של hello

כשמתקשרים לשרת ה-proxy‏ hello אפליקציית Node.js מופעלת באופן אוטומטי ומשיבה "Hello, World!". שימו לב: אם לא ציינתם אחרת, אפליקציית Node.js נפרסת בסביבה שנקראת test. זוהי שיחה בסיסית באמצעות Curl (צריך להחליף את myorg בשם הארגון). 
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

צפייה בקוד Node.js ועריכה שלו

בואו נסתכל על קוד Node.js שנוסף ל-proxy ל-API. עוברים לדף הסיכום של ה-proxy של Hello World ולוחצים על Develop (פיתוח).



תצוגת הפיתוח תיפתח, והיא כוללת עורך קוד. אתם יכולים לערוך את הקוד ישירות.

לדוגמה, משנים את התשובה מ-Hello, World! למשהו אחר, כמו Hello, Node!, ואז לוחצים על שמירה. הפרוקסי נשמר ונפרס מחדש.

לבסוף, מפעילים מחדש את ה-proxy כדי לאמת את השינוי:

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

מידע נוסף על הפעלת אפליקציות Node.js ב-Apigee Edge

כמו כל אפליקציות Node.js, אפליקציות Node.js שפועלות ב-Apigee Edge פועלות בשרשור בקרה יחיד. אין צורך (ואין אפשרות) להתחיל שרשור נוסף, או לסנכרן משתנים בין שרשורים. מכיוון ש-Node.js אוכף תכנות לא חוסם, סקריפט יחיד יכול לתמוך באלפי בקשות בו-זמניות כי הסקריפט מוותר על ה-CPU בכל פעם שהוא צריך לחכות למשהו, והוא מקבל הודעה מאוחר יותר כשהמשהו הזה קורה.

כדי להשתמש ב-Node.js ב-Apigee Edge, צריך לציין קובץ סקריפט ראשי של Node.js. צריך להגדיר את הסקריפט הזה כך שיטפל בבקשות נכנסות. בדרך כלל עושים את זה באמצעות המודולים http או https, יצירת לקוח וכו'. (אם הסקריפט הראשי לא מוגדר בצורה הזו, הוא פשוט יופעל ויסיים את הפעולה אחרי הפריסה). ב-Apigee Edge, כל סקריפט של אפליקציית Node.js מתחיל מההתחלה כשמפעילים את ה-proxy, ומפסיק כשמבטלים את הפעלת ה-proxy. בזמן הזה הוא ימתין לבקשות חדשות ויעבד אותן. מידע נוסף מופיע בקטע 'הפעלת קובץ Node.js מיובא' במאמר בנושא פריסת אפליקציית Node.js עצמאית.

השלבים הבאים

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