הסבר על מחברים

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

אפשר להשתמש בחיבורים כדי להתחבר לממשקי API אחרים של Google Cloud בתוך תהליך עבודה, ולשלב את תהליכי העבודה עם המוצרים האלה של Google Cloud. לדוגמה, אפשר להשתמש במחברים כדי לפרסם הודעות Pub/Sub, לקרוא או לכתוב נתונים במסד נתונים של Firestore או לאחזר מפתחות אימות מ-Secret Manager. איך משתמשים במחבר

מחברים מפשטים את הקריאה לשירותים כי הם מטפלים בפורמט של הבקשות בשבילכם, ומספקים שיטות וארגומנטים כך שלא צריך לדעת את הפרטים של Google Cloud API.

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

אימות

המחברים משתמשים באימות מובנה של ניהול זהויות והרשאות גישה כדי ליצור אינטראקציה עם מוצרים אחרים שלGoogle Cloud . שימו לב שגם אם משתמשים במחבר, עדיין צריך להקצות הרשאות מתאימות לחשבון השירות של זרימת העבודה כדי לבצע אימות תקין ל-API מסוים. לדוגמה, כדי לפרסם הודעה ב-Pub/Sub, צריך להקצות לחשבון השירות שמשויך לתהליך העבודה את התפקיד roles/pubsub.publisher. מידע נוסף על אימות למוצרים אחרים Google Cloud Google Cloud

ניסיונות חוזרים

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

  • ב-Workflows נעשה שימוש במדיניות ניסיון חוזר אידמפוטנטית לבקשות GET.

  • ב-Workflows נעשה שימוש במדיניות ניסיון חוזר לא אידמפוטנטית לכל שאר שיטות ה-HTTP.

  • כברירת מחדל, הזמן הקצוב לתפוגה של בקשות הוא 30 דקות. שימו לב שבפעולות ממושכות, המגבלה הזו חלה על בקשות נפרדות (לדוגמה, התחלת הפעולה או בדיקת הסטטוס שלה) במסגרת הפעולה הממושכת. אפשר להגדיר את הזמן הקצוב לתפוגה של הפעולה כולה באמצעות השדה connector_params. אפשר לעיין במפרט המחברים.

פעולות ממושכות

לשיחות שמבצעות פעולה ממושכת (LRO), חלים ההתנהגויות הבאות:

  • ‫Workflows חוסם את הביצוע של תהליך העבודה עד שהפעולה מסתיימת בהצלחה או נכשלת.

  • כברירת מחדל, הזמן הקצוב לתפוגה של שיחות הוא 30 דקות. אפשר לשנות את זמן הקצוב לתפוגה של השיחה באמצעות השדה connector_params (עד שנה אחת). לפרטים נוספים עיינו במאמר בנושא מחברים.

  • מחברים מבצעים סקר של משאבי LRO מעת לעת. כברירת מחדל, כשהמערכת מבצעת סקרים, היא משתמשת בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff) של 1.25, שמתחילה בשנייה אחת ומתארכת ל-60 שניות בין הסקרים. כל ניסיון שליפה נחשב כשלב שחייבים עליו. אפשר לשנות את פרמטרי הסקר באמצעות השדה connector_params. רשימה של סוגי משאבים נתמכים של LRO זמינה במאמר חומר עזר בנושא מחברים.

  • מנגנון הניסיון החוזר שצוין למעלה חל על ניסיון כושל של שליחת שאילתה.

  • התשובות לסקר נבדקות, ואם מטען התשובה לא תקין, מוחזרת שגיאת ResponseTypeError.

  • אם מתרחשת שגיאה במהלך פעולה ארוכת טווח, Workflows מעלה שגיאת OperationError. השגיאה כוללת מאפיין נוסף, error, שמכיל פרטים ספציפיים לפעולה.

אם פעולה ארוכת טווח נכשלת, קריאת המחבר מעלה חריגה עם המאפיינים הבאים:

  • message: הודעת שגיאה שקריאה לאנשים.
  • ‫tags: רשימה של תגים. במקרה של קריאה למחבר של פעולה ממושכת, הרשימה כוללת את OperationError.
  • ‫operation: האובייקט של הפעולה הממושכת שנכשלה.

המאמרים הבאים