הגדרת טריגר Eventarc

בדף הזה מוסבר איך להגדיר טריגר Eventarc ב-Application Integration.

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

במסוף Google Cloud , אפשר ליצור ולהגדיר טריגר Eventarc באחת מהדרכים הבאות:

לפני שמתחילים

לפני שמגדירים את טריגר Eventarc, צריך להפעיל את Eventarc API ואת Pub/Sub API:

תפקידים שנדרשים להפעלת ממשקי API

כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק 'שימוש בשירות'' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

הפעלת ממשקי ה-API

לתשומת ליבכם

כשמגדירים טריגר Eventarc, כדאי להתייחס לנקודות הבאות:

  • אם יצירת הטריגר של Eventarc נכשלת במהלך פרסום השילוב בגלל שגיאות בהגדרה, השילוב עדיין יפורסם, אבל הטריגר לא יהיה פעיל.

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

  • פרסום גרסה חדשה של השילוב עם הגדרת טריגר Eventarc ששונתה מחליף אוטומטית את הטריגר הישן בטריגר חדש. כך תמיד תהיה לכם גישה להגדרות ולאפשרויות השחזור.
  • אם מפרסמים גרסה חדשה של השילוב ומשתמשים באותו טריגר Eventarc ובהגדרה שלו, לא נוצר טריגר חדש. במקום זאת, נעשה שימוש חוזר בטריגר Eventarc הקיים לגרסה החדשה של השילוב.

יצירת טריגר Eventarc מ-Application Integration

כדי ליצור Eventarc trigger מ-Application Integration, מבצעים את השלבים הבאים:

  1. הוספת טריגר Eventarc ב-Application Integration
  2. הגדרת טריגר Eventarc בכלי לעריכת שילובים

הוספת טריגר Eventarc

כדי להוסיף טריגר Eventarc לשילוב, מבצעים את השלבים הבאים:

  1. נכנסים לדף Application Integration במסוף Google Cloud .

    מעבר אל Application Integration

  2. בתפריט הניווט, לוחצים על Integrations (שילובים).

    מוצגת רשימה של כל השילובים שזמינים בפרויקט Google Cloud בדף Integrations List.

  3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

    אם יוצרים שילוב חדש:

    1. מזינים שם ותיאור בחלונית יצירת שילוב.
    2. בוחרים אזור לשילוב.
    3. בוחרים חשבון שירות לאינטגרציה. אפשר לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב מחלונית סיכום השילוב בסרגל הכלים של השילוב.
    4. לוחצים על יצירה.

    השילוב החדש שנוצר ייפתח בכלי השילובים.

  4. בסרגל הניווט של כלי העריכה של השילוב, לוחצים על טריגרים כדי לראות את רשימת הטריגרים הזמינים.
  5. גוררים ושחררים את הרכיב Eventarc בעורך השילובים.

הגדרת הטריגר של Eventarc

כדי להגדיר טריגר Eventarc, לוחצים על הרכיב Eventarc Trigger בכלי לעריכת שילובים. מופיעה חלונית ההגדרה Eventarc Trigger עם השדות הבאים:

  • ‫Label: (תווית) (אופציונלי) השם הגלוי של טריגר Eventarc בהטמעה. אתם יכולים לשנות את התווית לשם שתבחרו.
  • הערות: (אופציונלי) אפשר להוסיף הערות כדי לספק מידע נוסף על הטריגר.
  • לוחצים על Configure Eventarc trigger (הגדרת טריגר Eventarc) ומזינים את הקלט הבא בעורך טריגר Eventarc:
    • שם הטריגר: מזינים שם לטריגר.
    • סוג הטריגר: בוחרים אחד מסוגי הטריגר הבאים:
      • מקור Google: בוחרים באפשרות הזו כדי ליצור טריגר ל-Pub/Sub, ל-Cloud Storage, ל-Firestore ולספקי אירועים אחרים של Google.
      • Custom (מותאם אישית): בוחרים באפשרות הזו כדי ליצור טריגר למקור אירועים מותאם אישית.
      • צד שלישי: בוחרים באפשרות הזו כדי ליצור טריגר לספקים שאינם של Google שמציעים מקור Eventarc. מידע נוסף זמין במאמר בנושא אירועים של צד שלישי ב-Eventarc.
    • ספק האירועים: בוחרים את ספק האירועים של הטריגר. רשימת ספקי האירועים תלויה בסוג הטריגר. מידע נוסף זמין במאמר בנושא ספקי אירועים ויעדים.
    • סוג האירוע: בוחרים את סוג האירוע של הטריגר. הגדרת הטריגר משתנה בהתאם לספק האירועים שבחרתם. מידע נוסף זמין במאמר בנושא סוגי אירועים.
    • אזור: בוחרים את האזור להפעלת הטריגר.
    • מסננים: (אופציונלי) מוסיפים מסננים כדי לבחור את ממשקי ה-API שתואמים לקריטריונים שלכם. לדוגמה, אם מסננים את ממשקי ה-API לפי שם ספציפי, האירוע מופעל רק אם מתבצע עדכון בממשקי ה-API שתואמים לקריטריוני הסינון.
    • חשבון שירות: בוחרים את חשבון השירות שבו רוצים להשתמש להפעלת הטריגר. אם לא בוחרים חשבון שירות, הטריגר משתמש בחשבון השירות שמוגדר כברירת מחדל של Compute Engine כזהות שלו כשמפעילים את השירות. לחשבון השירות שמשויך לטריגר צריכות להיות ההרשאות הנדרשות להפעלת השירות.

    • ניסיון חוזר במקרה של כשל: בוחרים באפשרות הזו כדי להפעיל ניסיונות חוזרים של הטריגר אם היעד לא מצליח לעבד את האירוע.
    • Network attachment (צירוף לרשת): בוחרים את הצירוף לרשת שרוצים להשתמש בו להפעלת הטריגר. הרשימה הזו נוצרת על סמך הקבצים המצורפים לרשת שנוצרו בפרויקט.

      צירופי רשת מאפשרים תקשורת בין רשתות של ענן וירטואלי פרטי (VPC) של בעלים של שירות מנוהל לבין רשתות VPC של צרכן. ‫Eventarc משתמש בחיבור הרשת שהוגדר כדי ליצור חיבור לנקודת קצה פנימית של HTTP שמארחת ברשת ה-VPC של הלקוח, וכך מאפשר העברה של נתוני אירועים. מידע נוסף על יצירה וניהול של קבצים מצורפים לרשת זמין במאמר יצירה וניהול של קבצים מצורפים לרשת.

  • כדי לשמור את הגדרת הטריגר, לוחצים על שמירת הטריגר.

יצירת טריגר Eventarc באמצעות מסוף Eventarc

כדי ליצור טריגר Eventarc מדף המסוף של Eventarc, מבצעים את השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף Eventarc > Triggers.

    כניסה לדף Triggers

    בדף Triggers (טריגרים) מפורטים כל הטריגרים בפרויקט.

  2. לוחצים על Create trigger (יצירת ביטוי להפעלה).
  3. בדף Create trigger, מזינים את הפרטים הבאים:
    1. שם הטריגר: מזינים שם לטריגר.
    2. סוג הטריגר: בוחרים אחד מסוגי הטריגר הבאים:
      • מקורות Google: בוחרים באפשרות הזו כדי ליצור טריגר ל-Pub/Sub, ל-Cloud Storage, ל-Firestore ולספקי אירועים אחרים של Google.
      • Custom (מותאם אישית): בוחרים באפשרות הזו כדי ליצור טריגר למקור אירועים מותאם אישית.
      • צד שלישי: בוחרים באפשרות הזו כדי ליצור טריגר לספקים שאינם של Google שמציעים מקור Eventarc. מידע נוסף זמין במאמר בנושא אירועים של צד שלישי ב-Eventarc.
    3. ספק האירועים: בוחרים את ספק האירועים של הטריגר. רשימת ספקי האירועים משתנה בהתאם לסוג הטריגר. מידע נוסף זמין במאמר בנושא ספקי אירועים ויעדים.
    4. סוג האירוע: בוחרים את סוג האירוע של הטריגר. הגדרת הטריגר משתנה בהתאם לספק האירועים שבוחרים. מידע נוסף זמין במאמר בנושא סוגי אירועים.
    5. סוג התוכן של נתוני האירועים: בוחרים את סוג הנתונים של תוכן האירועים. בוחרים באפשרות application/json או באפשרות application/protobuf.
    6. אזור: בוחרים את האזור להפעלת הטריגר.
    7. חשבון שירות: בוחרים את חשבון השירות שבו רוצים להשתמש להפעלת הטריגר. אם לא בוחרים חשבון שירות, הטריגר משתמש בחשבון השירות שמוגדר כברירת מחדל של Compute Engine כזהות שלו כשמפעילים את השירות. לחשבון השירות שמשויך לטריגר צריכות להיות ההרשאות הנדרשות להפעלת השירות.
    8. יעד האירוע: בוחרים באפשרות Application Integration.
    9. בחירת שילוב: בוחרים את השילוב שעבורו רוצים ליצור את הטריגר. אם השילוב פורסם, Application Integration יוצר גרסת טיוטה חדשה של השילוב כדי להוסיף לה את טריגר Eventarc.
    10. Network attachment (צירוף לרשת): בוחרים את הצירוף לרשת שרוצים להשתמש בו להפעלת הטריגר. הרשימה הזו נוצרת על סמך הקבצים המצורפים לרשת שנוצרו בפרויקט.

      צירופי רשת מאפשרים תקשורת בין רשתות של ענן וירטואלי פרטי (VPC) של בעלים של שירות מנוהל לבין רשתות VPC של צרכן. ‫Eventarc משתמש בצירוף הרשת שהוגדר כדי ליצור חיבור לנקודת קצה פנימית של HTTP שמארחת ברשת ה-VPC של הלקוח, וכך מאפשר את העברת נתוני האירועים. מידע נוסף על קבצים מצורפים לרשת זמין במאמר מידע על קבצים מצורפים לרשת.

  4. לוחצים על Open integration (פתיחת השילוב).

    נפתח הדף של כלי העריכה Application Integration עם השילוב שנבחר, והרכיב החדש Eventarc trigger נוסף לשילוב.

  5. לוחצים על הרכיב Eventarc trigger (טריגר Eventarc) ופותחים את חלונית הגדרת הטריגר.
  6. בודקים ומאמתים את הגדרת הטריגר בדף Eventarc trigger editor (כלי העריכה של טריגר Eventarc).
  7. מחברים את הטריגר החדש של Eventarc לזרימת ההטמעה ומפרסמים את ההטמעה.