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

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

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

אם אתם לומדים איך ליצור תהליך משותף, כדאי להתחיל עם הנושא תהליכים משותפים לשימוש חוזר.

מבנה של חבילת תהליך משותף

חבילה של תהליך משותף מורכבת מההגדרות הבאות:

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

הרכיבים בטבלה שלמעלה מוגדרים על ידי קובצי תצורה במבנה התיקיות הבא:

קבצי תצורה ומבנה ספריות של חבילת תהליך משותף

בקטע הזה מוסבר על קובצי התצורה ועל מבנה התיקיות של חבילת תהליך משותף.

הגדרה בסיסית

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

/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 Edge עוקב באופן אוטומטי אחרי הגרסה הנוכחית של הרכיב המשותף. לא רלוונטי לא

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

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

הערה: בשלב הזה, הרכיב הזה תומך רק ברכיב צאצא אחד מסוג <SharedFlow>. אפשר להוסיף רק תהליך משותף אחד לחבילת תהליכים משותפים.

לא רלוונטי כן

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

/sharedflowbundle/sharedflows/default.xml

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

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

<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 Edge עוקב באופן אוטומטי אחרי הגרסה הנוכחית של הרכיב המשותף. לא רלוונטי לא

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

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

מדיניות

/sharedflowbundle/policies

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

משאבים

/sharedflowbundle/resources

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

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

פרסום שאלות בפורום המפתחים של Apigee.