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

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

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

מבוא

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

יוצר את הדוגמה של Hello World! API מסוג proxy

בקטע הזה מוסבר איך ליצור שרת proxy של Edge API שמקיים אינטראקציה עם שרת ה-HTTP של Node.js. קוד שרת ה-HTTP של Node.js כבר נכתב עבורך, והוא נפרס באופן אוטומטי ב-Edge בעת ביצוע השלבים הפשוטים האלה.
  1. באשף בניית שרת Proxy, בוחרים באפשרות אפליקציית Node.js.
  2. לוחצים על הבא.
  3. פועלים לפי ההוראות באשף 'בניית שרת Proxy' ובוחרים את האפשרויות הבאות.
    שדה בחירה
    פרטים
    שם שרת proxy יש להזין Nodejs-Hello. השם שמוצג ל-API.
    נתיב בסיס של שרת Proxy צריך להזין את ה-Nonojs-hello
    מקור בוחרים באפשרות דוגמה של 'שלום עולם'. (אנחנו נדון באפשרויות האחרות בהמשך הנושא הזה).
    התיאור מזינים תיאור של ה-API.
    אבטחה
    העברה (ללא) בוחרים באפשרות הצלחה (ללא). יצירת מעבר פשוט דרך שרת proxy.
    מארחים וירטואליים
    ברירת מחדל, מאובטחת אין לשנות את ברירות המחדל. למידע נוסף על מארחים וירטואליים, עיינו במאמר מידע על מארחים וירטואליים (בטא).
    פיתוח
    פריסת סביבות בוחרים באפשרות בדיקה.
  4. לוחצים על יצירה ופריסה
    בתגובה, אתם אמורים לראות אישור על כך ששרת ה-API החדש של ה-API נוצר בהצלחה ונפרס בסביבת הבדיקה.
  5. לוחצים על הצגת שרת ה-proxy של <proxy> בעורך כדי להציג את דף הפרטים של שרת ה-API של שרת ה-API.

הפעלת שרת ה-proxy של שלום

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

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

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



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

לדוגמה, אפשר לשנות את התשובה מ-Hello, World! לתשובה אחרת, כמו Hello, Node!, ואז ללחוץ על Save (שמירה). שרת ה-proxy נשמר ונפרס מחדש.

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

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

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

כמו כל אפליקציות Node.js, אפליקציות Node.js שפועלות ב-Apigee Edge פועלות ב-thread אחד של בקרה. אין צורך (ולמעשה אין אפשרות) להתחיל שרשור נוסף, או לסנכרן משתנים בין שרשורים. מכיוון ש-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 משורת הפקודה.