סקירה כללית על יעדים מתארחים

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

באמצעות יעדים מתארחים אפשר להריץ אפליקציות של Node.js בסביבת זמן ריצה מקורית בסביבת Apigee. המטרה של יעדים מתארחים היא פשוטה: לאפשר לך לפרוס בסביבה מקורית, מאובטחת, ניתנת להתאמה ומבודדת, שבה שרתי proxy של Edge API יכולים לקרוא להם כשירותי יעד.

כפי שמוצג באיור הבא, שרת proxy של Edge API קורא לאפליקציה Node.js נפרס בסביבת היעדים המתארחים. חשוב לזכור שסביבת היעדים המתארחים היא בהיקף בתוך ארגון:סביבה ב-Apigee.

קבלת שרת proxy של Edge API כדי לדבר עם אפליקציית Hosted Targets שנוצרה ופרוסה בצורה תקינה נדרשת הגדרה פשוטה בנקודת הקצה (endpoint) של היעד של שרת ה-proxy. כדי להתחיל, עוברים למדריכים בנושא יעדים מתארחים.

באילו זמני ריצה של אפליקציות נתמכות היעדים המתארחים?

בשלב הזה, אפשר לפרוס אפליקציות של Node.js רק למטרות מתארחות.

התקנת מטרות עסקיות מתארחות

היעדים המתארחים זמינים בכל הארגונים הציבוריים בענן של Edge. אין צורך להתקין כל דבר כדי להשתמש ביעדים מתארחים.

איך מוודאים שהיעדים המתארחים מופעלים

אם ברצונך לאמת שהארגון שלך יעדים מתארחים מופעלים, קבלו את פרטי הארגון ומוודאים שהfeatures.isEdgeFunctionsEnabled מוגדר כ-true. הנכס הוא לקריאה בלבד.

לדוגמה:

https://api.enterprise.apigee.com/v1/organizations/myorg

  {
     "createdAt":1507572884047,
     "createdBy":"jdoe@apigee.com",
     "displayName":"myorg",
     "environments":[
        "prod",
        "dev",
        "test",
        "portal"
     ],
     "lastModifiedAt":1507578673194,
     "lastModifiedBy":"jdoe@apigee.com",
     "name":"jdoe",
     "properties":{
        "property":[
           {
              "name":"features.isSmbOrganization",
              "value":"false"
           },
           {
              "name":"self.service.virtual.host.enabled",
              "value":"true"
           },
           {
              "name":"features.isCpsEnabled",
              "value":"true"
           },
           {
              "name":"features.isEdgeFunctionsEnabled",
              "value":"true"
           }
        ]
     },
     "type":"paid"
  }
  

מה צריך לדעת על יעדים מתארחים

השירות 'יעדים מתארחים' מאפשר לאפליקציות של Node.js לפעול בסביבה מקורית שלא תלויה בטכנולוגיית זמן ריצה ספציפית ל-Apigee. אפשר לנפות באגים ולבדוק את של האפליקציה באופן מקומי לפני הפריסה שלה, ותוכלו להיות בטוחים שהגרסה שנפרסה תעבוד בדיוק בדיוק באופן מקומי. בזמן הפריסה אפשר לבחור כל גרסה של זמן ריצה של אפליקציה להפעלת האפליקציה ביעדים מתארחים. לדוגמה, ייתכן שתבחרו באופן ספציפי להריץ אפליקציית Node.js בסביבה v8.10.0.

מגבלות

להסבר על מגבלות השימוש ביעדים מתארחים, ראו מוצר Apigee המגבלות.

השלבים הבסיסיים שצריך לבצע

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

כדי להשתמש ביעדים מתארחים, צריך לבצע את המשימות הבאות. המדריכים אסביר בפירוט על כל אחת מהמשימות האלה.

• פיתוח ובדיקה של אפליקציית Node.js באופן מקומי.
• יצירת קובץ מניפסט בתיקיית השורש של פרויקט האפליקציה. המניפסט הוא קובץ YAML שמציין שנדרש ליצירה ולפריסה של האפליקציה.
• הוספת האפליקציה לשרת ה-proxy של Edge בתור משאב מתארח מהסוג הזה.
• בנקודת הקצה (endpoint) של יעד ה-Proxy, מוסיפים תג <HostedTarget/> ריק. התג הזה מורה ל-Edge לפרוס את האפליקציה Node.js בסביבת Hosted Targets. עבור דוגמה:

<?xml version="1.0" encoding="UTF-8"?>
<TargetEndpoint name="default">
   <PreFlow name="PreFlow">
      <Request />
      <Response />
   </PreFlow>
   <PostFlow name="PostFlow">
      <Request />
      <Response />
   </PostFlow>
   <Flows />
   <HostedTarget />
</TargetEndpoint>

היקף אפליקציות היעדים המתארחים

אפליקציות היעדים המתארחים בהיקף של סביבת הארגון של Edge. ההיקף הזה זהים לכל שרת proxy של Edge.

האם אפליקציות של יעדים מתארחים יכולות לגשת לנתונים של שרת proxy?

לא ניתן להשתמש באפליקציות עם יעדים מתארחים כרגע יש גישה לסביבת זמן הריצה של שרת ה-proxy. המשמעות היא שאין לכם גישה לתהליך. משתנים, מטמוני נתונים וישויות אחרות ישירות מאפליקציות Hosted Targets.

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

העברת קוד אפליקציה קיים ליעדים מתארחים

אין כרגע נתיב העברה אוטומטי אפליקציית Node.js מוטמעת מבוססת-Trireme ליעדים מתארחים. עם זאת, אפשר להמיר את קוד האפליקציה הקיים ליעדים מתארחים באופן ידני. לדוגמה, ראו מיגרציה שרת proxy קיים של Node.js לשרת proxy של יעדים מתארחים.