ניתוב אירועים ביומן הביקורת אל Cloud Run

רגילה

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

‫Eventarc מעביר אירועים למקבל האירועים בפורמט CloudEvents באמצעות בקשת HTTP.

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

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

הערה: אם גם אירועים ישירים וגם אירועים ביומן הביקורת נתמכים אצל ספק Google, מומלץ ליצור טריגר שמסנן את האירוע הישיר. לאירועים ישירים יש כמה יתרונות בהשוואה לאירועים ביומן הביקורת. מידע נוסף זמין במאמר בנושא ניתוב אירועים.

הכנות ליצירת טריגר

לפני שיוצרים טריגר, צריך לבצע את הפעולות הבאות:

המסוף

1. בדף לבחירת הפרויקט במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.

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

   כניסה לדף לבחירת הפרויקט

2. מפעילים את Cloud Logging API,‏ Eventarc API ו-Eventarc Publishing API.

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

3. אם רלוונטי, מפעילים את ה-API שקשור לאירועים ביומני הביקורת של Cloud. לדוגמה, כדי להפעיל יומני ביקורת של פונקציות Cloud Run, צריך להפעיל את Cloud Functions API.

4. אם עדיין אין לכם חשבון שירות, אתם צריכים ליצור חשבון שירות שמנוהל על ידי משתמש, ואז להקצות לו את התפקידים וההרשאות הנדרשים כדי ש-Eventarc יוכל לנהל אירועים בשירות היעד.

   1. במסוף Google Cloud , נכנסים לדף יצירת חשבון שירות.

      כניסה לדף Create service account

   2. בוחרים את הפרויקט הרצוי.

   3. כותבים שם בשדה Service account name. השדה Service account ID ימולא במסוף Google Cloud בהתאם לשם הזה.

      כותבים תיאור בשדה Service account description. לדוגמה, Service account for event trigger.

   4. לוחצים על Create and continue.

   5. כדי לספק גישה מתאימה, ברשימה Select a role בוחרים את התפקידים הנדרשים בפלטפורמה לניהול זהויות והרשאות גישה (IAM) שרוצים להקצות לחשבון השירות עבור הפעלות מאומתות או לא מאומתות. מידע נוסף זמין במאמר תפקידים והרשאות ליעדים ב-Cloud Run.

      כדי להוסיף עוד תפקידים, לוחצים על Add another role ומוסיפים אותם אחד אחרי השני.

      חשוב: כדי לאשר הפעלות מאומתות של שירות Cloud Run, צריך לשייך את הטריגר לחשבון שירות עם תפקיד roles/run.invoker. כשיוצרים או מעדכנים את הטריגר, בוחרים את חשבון השירות הזה.

   6. לוחצים על Continue.

   7. כדי לסיים את יצירת החשבון, לוחצים על סיום.

gcloud

1. במסוף Google Cloud , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

2. מפעילים את Cloud Logging API,‏ Eventarc API ו-Eventarc Publishing API.

   gcloud services enable logging.googleapis.com \
     eventarc.googleapis.com \
     eventarcpublishing.googleapis.com

3. אם רלוונטי, מפעילים את ה-API שקשור לאירועים ביומני הביקורת של Cloud. לדוגמה, כדי להפעיל יומני ביקורת של פונקציות Cloud Run, צריך להפעיל את האפשרות cloudfunctions.googleapis.com.

4. אם עדיין אין לכם חשבון שירות, אתם צריכים ליצור חשבון שירות שמנוהל על ידי משתמש, ואז להקצות לו את התפקידים וההרשאות הנדרשים כדי ש-Eventarc יוכל לנהל אירועים בשירות היעד.

   1. יוצרים את חשבון השירות:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      מחליפים את SERVICE_ACCOUNT_NAME בשם של חשבון השירות. הוא צריך להכיל בין 6 ל-30 תווים, והוא יכול לכלול תווים אלפאנומריים קטנים ומקפים. אחרי שיוצרים חשבון שירות, אי אפשר לשנות את השם שלו.

   2. נותנים את התפקידים או ההרשאות הנדרשים בניהול הזהויות והרשאות הגישה (IAM) להפעלות מאומתות או לא מאומתות. מידע נוסף זמין במאמר תפקידים והרשאות ליעדים ב-Cloud Run.

   חשוב: כדי לאשר הפעלות מאומתות של שירות Cloud Run, צריך לשייך את הטריגר לחשבון שירות עם התפקיד roles/run.invoker. כשיוצרים או עורכים את הטריגר, משתמשים בדגל --service-account כדי לשייך את חשבון השירות הזה לטריגר.

יצירת טריגר

אפשר ליצור טריגר Eventarc באמצעות Google Cloud CLI או דרך מסוף Google Cloud .

הערה: הסינון מתבצע באמצעות התאמה מדויקת, ולא תומך בתווים כלליים או בביטויים רגולריים. עם זאת, אפשר להשתמש בדגל --event-filters-path-pattern בפקודה הבאה של gcloud CLI, או להגדיר תבנית נתיב דרך המסוף. מידע נוסף זמין במאמר הסבר על דפוסי נתיבים.

המסוף

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

   כניסה לדף Triggers

2. לוחצים על Create trigger (יצירת ביטוי להפעלה).
3. מקלידים Trigger name.

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

4. בשדה Trigger type, בוחרים באפשרות Google sources.
5. בוחרים ספק אירועים.

   זהו שירות Google שמשמש כמקור לאירועים דרך יומני הביקורת שלו. לדוגמה, בוחרים באפשרות BigQuery.

   שימו לב: יכול להיות שבשם ספק האירועים שמופיע בGoogle Cloud מסמכי התיעוד המשויכים לא מופיעה הקידומת Cloud או Google Cloud. לדוגמה, במסוף, Memorystore for Redis נקרא Google Cloud Memorystore for Redis.

6. ברשימה סוג האירוע, מתוך האירועים דרך יומני ביקורת בענן, בוחרים סוג אירוע.
7. בוחרים אחת מהאפשרויות הבאות:
   • כל משאב – זוהי ברירת המחדל, והיא כוללת משאבים שנוצרו באופן דינמי עם מזהים שנוצרו בזמן היצירה.
   • משאב ספציפי – צריך לציין את השם המלא של המשאב.
   • תבנית נתיב – אפשר לסנן משאבים באמצעות תבנית נתיב. לדוגמה, מקלידים projects/_/buckets/eventarc-bucket/objects/random.txt או מקלידים projects/_/buckets/**/r*.txt.
8. כדי לציין את הקידוד של מטען הייעודי (payload) של האירוע, ברשימה Event data content type (סוג התוכן של נתוני האירוע), בוחרים באפשרות application/json או באפשרות application/protobuf.

   חשוב לזכור שמטען ייעודי (payload) של אירוע בפורמט JSON גדול יותר ממטען ייעודי בפורמט Protobuf. זה עלול להשפיע על המהימנות, בהתאם ליעד של האירוע ולמגבלות שלו לגבי גודל האירוע. מידע נוסף זמין במאמר בנושא בעיות מוכרות.

9. ברשימה Region, בוחרים אזור.

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

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

   שימו לב שיש בעיה מוכרת בטריגרים של Cloud Audit Logs ב-Compute Engine שגורמת לאירועים שמקורם באזור יחיד: us-central1. המיקום הזה לא משתנה גם אם המיקום האמיתי של המכונה הווירטואלית שונה. כשיוצרים את הטריגר, מגדירים את מיקום הטריגר ל-us-central1 או ל-global.

10. בוחרים את חשבון השירות שיפעיל את השירות או את תהליך העבודה.

    אפשר גם ליצור חשבון שירות חדש.

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

11. ברשימה Event destination, בוחרים באפשרות Cloud Run.
12. בוחרים שירות.
    

    זהו שם השירות שמקבל את האירועים להפעלת הטריגר. השירות צריך להיות באותו פרויקט כמו הטריגר, והוא יקבל אירועים כבקשות HTTP POST שנשלחות לנתיב של כתובת ה-URL הבסיסית שלו (/), בכל פעם שהאירוע נוצר.

13. אפשר לציין נתיב לכתובת ה-URL של השירות כדי לשלוח את הבקשה הנכנסת.

    זהו הנתיב היחסי בשירות היעד שאליו יישלחו האירועים של הטריגר. לדוגמה: /, /route, route, route/subroute.

14. אפשר גם ללחוץ על הוספת תווית. תוויות הן צמדי מפתח/ערך שעוזרים לכם לארגן אתGoogle Cloud המשאבים. מידע נוסף זמין במאמר מהן תוויות?
15. לוחצים על יצירה.

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

gcloud

כדי ליצור טריגר, מריצים פקודה עם דגלים נדרשים ואופציונליים.gcloud eventarc triggers create

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-run-service=DESTINATION_RUN_SERVICE \
    --destination-run-region=DESTINATION_RUN_REGION \
    --event-filters="type=google.cloud.audit.log.v1.written" \
    --event-filters="serviceName=SERVICE_NAME" \
    --event-filters="methodName=METHOD_NAME" \
    --event-data-content-type="EVENT_DATA_CONTENT_TYPE" \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

מחליפים את מה שכתוב בשדות הבאים:

• ‫TRIGGER: המזהה של הטריגר או מזהה מלא.
• ‫LOCATION: המיקום של טריגר Eventarc. אפשר גם להגדיר את המאפיין eventarc/location. לדוגמה: gcloud config set eventarc/location us-central1.

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

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

  שימו לב שיש בעיה מוכרת בטריגרים של Cloud Audit Logs עבור Compute Engine שגורמת לאירועים שמקורם באזור יחיד: us-central1. המיקום הזה לא משתנה, לא משנה איפה נמצאת בפועל המכונה הווירטואלית. כשיוצרים את הטריגר, מגדירים את מיקום הטריגר ל-us-central1 או ל-global.

• ‫DESTINATION_RUN_SERVICE: השם של שירות Cloud Run שמקבל את האירועים של הטריגר. השירות יכול להיות בכל אחד מהמיקומים הנתמכים של Cloud Run, והוא לא צריך להיות באותו מיקום כמו הטריגר. עם זאת, השירות צריך להיות באותו פרויקט כמו הטריגר והוא יקבל אירועים כבקשות HTTP POST שנשלחות לנתיב כתובת ה-URL הבסיסית שלו (/), בכל פעם שהאירוע נוצר.
• ‫DESTINATION_RUN_REGION: (אופציונלי) האזור שבו נמצא שירות היעד של Cloud Run. אם לא מציינים זאת, המערכת מניחה שהשירות נמצא באותו אזור כמו הטריגר.

• ‫SERVICE_NAME: המזהה של Google Cloud השירות
• ‫METHOD_NAME: המזהה של הפעולה

• ‫EVENT_DATA_CONTENT_TYPE: (אופציונלי) הקידוד של מטען הייעודי של האירוע. הערך יכול להיות application/json או application/protobuf. קידוד ברירת המחדל הוא application/json.

  חשוב לזכור שמטען ייעודי (payload) של אירוע בפורמט JSON גדול יותר ממטען ייעודי בפורמט Protobuf. זה עשוי להשפיע על המהימנות בהתאם ליעד האירוע ולמגבלות שלו לגבי גודל האירוע. מידע נוסף זמין במאמר בנושא בעיות מוכרות.

• ‫SERVICE_ACCOUNT_NAME: השם של חשבון השירות שמנוהל על ידי המשתמש.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

הערות:

• חובה להשתמש בדגלים הבאים:

  • --event-filters="type=google.cloud.audit.log.v1.written"
  • --event-filters="serviceName=VALUE"
  • --event-filters="methodName=VALUE"

• אפשר גם לסנן אירועים של משאב ספציפי באמצעות הדגל --event-filters="resourceName=VALUE" וציון הנתיב המלא למשאב. לא מציינים את הדגל למשאבים שנוצרו באופן דינמי ושמזהים שלהם נוצרו בזמן היצירה. לחלופין, אפשר לסנן אירועים עבור קבוצה של משאבים באמצעות הדגל --event-filters-path-pattern="resourceName=VALUE" ולהגדיר את דפוס נתיב המשאב.

• לכל טריגר יכולים להיות כמה מסנני אירועים, מופרדים בפסיקים בדגל אחד --event-filters=[ATTRIBUTE=VALUE,...] או שאפשר לחזור על הדגל כדי להוסיף עוד מסננים. רק אירועים שתואמים לכל המסננים נשלחים ליעד. אין תמיכה בתווים כלליים לחיפוש ובביטויים רגולריים.
• אחרי שיוצרים טריגר, אי אפשר לשנות את סוג המסנן של האירועים. כדי להגדיר סוג אירוע אחר, צריך ליצור טריגר חדש.
• הדגל --service-account משמש לציון כתובת האימייל בחשבון השירות בניהול זהויות והרשאות גישה (IAM) שמשויך לטריגר.
• אפשר לציין נתיב יחסי בשירות היעד של Cloud Run שאליו הטריגר צריך לשלוח את האירועים באמצעות הדגל --destination-run-path.

דוגמה:

  gcloud eventarc triggers create helloworld-trigger \
      --location=us-central1 \
      --destination-run-service=helloworld-events \
      --destination-run-region=us-central1 \
      --event-filters="type=google.cloud.audit.log.v1.written" \
      --event-filters="serviceName=bigquery.googleapis.com" \
      --event-filters="methodName=google.cloud.bigquery.v2.JobService.InsertJob" \
      --service-account=${SERVICE_ACCOUNT_NAME}@${PROJECT_ID}.iam.gserviceaccount.com

הפעולה הזו יוצרת טריגר בשם helloworld-trigger ליומני ביקורת שנכתבים על ידי bigquery.googleapis.com ולפעולה שמזוהה כ-google.cloud.bigquery.v2.JobService.InsertJob.

Terraform

אפשר ליצור טריגר ליעד ב-Cloud Run באמצעות Terraform. פרטים נוספים זמינים במאמר יצירת טריגר באמצעות Terraform.

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

הצגת טריגר

אפשר לאשר את יצירת הטריגר באמצעות רשימת הטריגרים של Eventarc ב-Google Cloud CLI או במסוף Google Cloud .

המסוף

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

   כניסה לדף Triggers

   בדף הזה מפורטים הטריגרים בכל המיקומים, כולל פרטים כמו שמות, אזורים, ספקי אירועים, יעדים ועוד.

2. כדי לסנן את הטריגרים:

   1. לוחצים על Filter (מסנן) או על השדה Filter triggers (טריגרים של מסנן).
   2. ברשימה Properties, בוחרים אפשרות לסינון הטריגרים.

   אפשר לבחור נכס אחד או להשתמש באופרטור הלוגי OR כדי להוסיף עוד נכסים.

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

gcloud

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

gcloud eventarc triggers list --location=-

הפקודה הזו מציגה רשימה של הטריגרים בכל המיקומים, וכוללת פרטים כמו שמות, סוגים, יעדים וסטטוסים.

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

• מידע נוסף על Eventarc
• איך מנהלים טריגרים