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

הדף הזה רלוונטי ל-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 התאריך והשעה (בפורמט epoch time) שבהם חבילת זרימת הנתונים המשותפת שונתה לאחרונה, וגם כתובת האימייל של המשתמש ששינה אותה.
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 מגדירה את הרצף שבו צריך להפעיל את רכיבי הזרימה. כל אחד מרכיבי הצאצא של אלמנט <SharedFlow> מציין חלק מהרצף, למשל קריאה למדיניות.<Step>

ההגדרה הבאה של 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 שם הפריט שאליו מתייחס השלב. הערך של האלמנט הזה צריך להיות זהה למזהה הייחודי של הפריט, למשל ערך מאפיין השם של מדיניות. לא רלוונטי כן