הפניה להגדרת חבילת תהליכי עבודה משותפים

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

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

מבנה הספריות של חבילת תהליכי עבודה משותפים

המבנה של ספריית חבילת ה-flow המשותף, שמוצג בהמשך, דומה למבנה של ספריית הגדרות ה-proxy ל-API.

מבנה הספריות של חבילת תהליכי עבודה משותפים

חבילת הגדרות של זרימת נתונים משותפת כוללת את התוכן הבא:

הגדרת הבסיס הגדרות התצורה העיקריות.
מדיניות קובצי הגדרה בפורמט XML שתואמים לסכימות המדיניות של Apigee.
Resources סקריפטים, קובצי JAR וקובצי XSLT שהמדיניות מפנה אליהם כדי להריץ לוגיקה בהתאמה אישית.
תהליכי עבודה משותפים החבילה הזו כוללת תהליכים משותפים.

הגדרה בסיסית

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

/sharedflowbundle/traffic-management-shared.xml

ההגדרה הבסיסית מגדירה את התוכן של חבילת התהליך המשותף, וכוללת מידע למעקב אחרי היסטוריית גרסאות החבילה.

<SharedFlowBundle revision="2" name="traffic-management-shared">
    <ConfigurationVersion majorVersion="4" minorVersion="0"/>
    <CreatedAt>1478637529218</CreatedAt>
    <CreatedBy>gladys@example.com</CreatedBy>
    <Description>Shared flow to moderate API traffic</Description>
    <DisplayName>traffic-management-shared</DisplayName>
    <LastModifiedAt>1481573374023</LastModifiedAt>
    <LastModifiedBy>gladys@example.com</LastModifiedBy>
    <Policies>
        <Policy>Auth-Flow-Callout</Policy>
        <Policy>Extract-Token</Policy>
        <Policy>Spike-Arrest</Policy>
    </Policies>
    <Resources>
        <Resource>jsc://extract-token.js</Resource>
    </Resources>
    <SharedFlows>
        <SharedFlow>default</SharedFlow>
    </SharedFlows>
</SharedFlowBundle>

מאפייני הגדרות בסיסיים

שם תיאור ברירת מחדל חובה?
SharedFlowBundle
name השם של חבילת הזרימה המשותפת, שחייב להיות ייחודי בארגון. התווים התקינים כוללים: A-Za-z0-9_- לא רלוונטי כן
revision מספר הגרסה של חבילת ההגדרות של התהליך המשותף. אין צורך להגדיר במפורש את מספר הגרסה, כי Apigee עוקב באופן אוטומטי אחרי הגרסה הנוכחית של הרכיב המשותף. לא רלוונטי לא

רכיבי הגדרה בסיסיים

שם תיאור ברירת מחדל חובה?
SharedFlowBundle
ConfigurationVersion הגרסה של סכימת ההגדרה של חבילת תהליכי העבודה המשותפים שהתהליך המשותף הזה תואם לה. הערכים הנתמכים היחידים כרגע הם majorVersion 4 ו-minorVersion 0. יכול להיות שנשתמש בהגדרה הזו בעתיד כדי לאפשר שינויים בפורמט של חבילת התכונות המשותפת. 4.0 לא
CreatedAt וגם CreatedBy התאריך והשעה (בזמן עידן) שבהם נוצרה חבילת הזרימה המשותפת, וכתובת האימייל של המשתמש שיצר אותה.
Description תיאור טקסטואלי של התהליך המשותף. אם תספקו תיאור, הוא יוצג בממשק המשתמש של Apigee. לא רלוונטי לא
DisplayName שם ידידותי למשתמש שעשוי להיות שונה מהמאפיין name של הגדרת התהליך המשותף. לא רלוונטי לא
LastModifiedAt וגם LastModifiedBy התאריך והשעה (בזמן אפוק) שבהם חבילת זרימת הנתונים המשותפת שונתה לאחרונה, וגם כתובת האימייל של המשתמש ששינה אותה.
Policies רשימת כללי המדיניות בספרייה /policies של התהליך המשותף הזה. בדרך כלל רואים את הרכיב הזה רק כשיוצרים את התהליך המשותף באמצעות ממשק ניהול Edge. זו פשוט הגדרה של 'מניפסט', שנועדה לספק שקיפות לגבי התוכן של התהליך המשותף. לא רלוונטי לא
Resources רשימת משאבים (JavaScript, ‏ Python, ‏ Java, ‏ XSLT) בספרייה /resources של הזרימה המשותפת הזו. בדרך כלל רואים את הרכיב הזה רק אם הזרימה המשותפת נוצרה באמצעות ממשק המשתמש של Apigee. זו פשוט הגדרה של קובץ מניפסט, שנועדה לספק תצוגה של התוכן של התהליך המשותף. לא רלוונטי לא
SharedFlows הזרימה המשותפת שהחבילה הזו מכילה. לא רלוונטי כן

מדיניות

/sharedflowbundle/policies

בדומה ל-proxy ל-API, בחבילת זרימה משותפת, הספרייה /policies מכילה XML של הגדרות לכל המדיניות שאפשר לצרף לזרימה המשותפת בחבילה. יש קבוצת משנה של אלמנטים שמשותפת לכללי המדיניות, אבל קבוצת המשנה הזו מורחבת עם אלמנטים שספציפיים למדיניות. מידע נוסף על הגדרת מדיניות זמין במאמר סקירה כללית של הפניות למדיניות.

משאבים

/sharedflowbundle/resources

משאבים הם סקריפטים, קוד וטרנספורמציות XSL שאפשר לצרף לתהליכים משותפים באמצעות כללי מדיניות. הם מופיעים בקטע Scripts (סקריפטים) בכלי העריכה של הזרימה המשותפת בממשק המשתמש של הניהול.

במאמר ניהול משאבים מפורטים סוגי המשאבים הנתמכים.

תהליכי עבודה משותפים

/sharedflowbundle/sharedflows/default.xml

ההגדרה של SharedFlow מגדירה את הרצף שבו רכיבי הזרימה צריכים לפעול. כל אחד מרכיבי הצאצא <Step> של האלמנט <SharedFlow> מציין חלק מהרצף, כמו קריאה למדיניות.

ההגדרה הבאה של SharedFlow מציינת שלושה כללי מדיניות שיבוצעו ברצף מלמעלה למטה (מימין לשמאל במסוף הניהול), כאשר SpikeArrest policy מופיע ראשון ו-FlowCallout policy מופיע אחרון.

<SharedFlow name="default">
    <Step>
        <Name>Spike-Arrest</Name>
    </Step>
    <Step>
        <Name>Extract-Token</Name>
    </Step>
    <Step>
        <Name>Auth-Flow-Callout</Name>
    </Step>
</SharedFlow>

מאפייני הגדרה של תהליכי עבודה משותפים

שם תיאור ברירת מחדל חובה?
SharedFlow
name השם של התהליך המשותף, שחייב להיות ייחודי בארגון. התווים התקפים כוללים: A-Za-z0-9_- לא רלוונטי כן
revision מספר הגרסה של הגדרת התהליך המשותף. אין צורך להגדיר במפורש את מספר הגרסה, כי Apigee עוקב באופן אוטומטי אחרי הגרסה הנוכחית של התהליך המשותף. לא רלוונטי לא

רכיבי הגדרה של תהליכי עבודה משותפים

שם תיאור ברירת מחדל חובה?
SharedFlow רצף המדיניות בתהליך המשותף. לא רלוונטי כן
Step השלב ברצף של התהליך. לא רלוונטי כן
Name שם הפריט שאליו מתייחס השלב. הערך של האלמנט הזה צריך להיות זהה למזהה הייחודי של הפריט, כמו ערך המאפיין של שם המדיניות. לא רלוונטי כן