כל התפקידים וההרשאות

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

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

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

לדוגמה, כשמקצים תפקידים לאירועים ישירים של Cloud Storage שמנותבים לפונקציות Cloud Run, התפקידים בשורות All event sources ו-All event targets חלים גם הם.

מקור האירוע חשבון משתמש או סוכן שירות התפקיד הנדרש כשצריך יעד האירוע
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון משתמש שמפעיל את Eventarc (לדוגמה, יוצר הטריגר) אדמין ב-Eventarc
(roles/eventarc.admin)

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

כל יעדי האירועים target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון משתמש שמפעיל את Eventarc (לדוגמה, יוצר הטריגר) משתמש בחשבון שירות
(roles/iam.serviceAccountUser)

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

כל יעדי האירועים target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
כל מקורות האירועים source-all source-cloud-storage source-pubsub סוכן השירות של Eventarc
(service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com)
סוכן שירות של Eventarc
(roles/eventarc.serviceAgent)

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

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

כל יעדי האירועים target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
כל מקורות האירועים source-all source-cloud-storage חשבון שירות של טריגרים מקבל אירועים ב-Eventarc
(roles/eventarc.eventReceiver)

נדרש בפרויקט: מאפשר לטריגר לקבל אירועים מספקי אירועים. לא נדרש לאירועים ישירים מ-Cloud Pub/Sub.

כל יעדי האירועים target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
כל מקורות האירועים source-all source-cloud-storage source-pubsub סוכן השירות של Cloud Pub/Sub
(service-PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com)
יצירת אסימונים בחשבון שירות
(roles/iam.serviceAccountTokenCreator)

ניתן כברירת מחדל בפרויקט (מותנה): מאפשר לסוכן השירות ליצור אסימוני זהות לבקשות דחיפה מאומתות.

צריך להקצות את התפקיד הזה באופן ידני רק אם הפעלתם את סוכן השירות של Cloud Pub/Sub ב-8 באפריל 2021 או לפני כן.

כל יעדי האירועים target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
אירועים ישירים ב-Cloud Storage‏ source-cloud-storage סוכן השירות של Cloud Storage‏
(service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com)
Pub/Sub Publisher
(roles/pubsub.publisher)

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

כל יעדי האירועים target-vpc target-cloud-run-functions target-cloud-run-service target-gke target-workflows
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון שירות של טריגרים Cloud Run Invoker
(roles/run.invoker)

נדרש בשירות או בפרויקט של Cloud Run (מותנה): מאפשר לטריגר להפעיל שירות יעד מאומת של Cloud Run.

Cloud Run target-cloud-run-service
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון המשתמש שפורס את הפונקציה

אחת מהאפשרויות הבאות, בהתאם לשיטת הפריסה:

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

  • ‫gcloud run deploy או Cloud Run Admin API: מקצים את התפקידים roles/run.sourceDeveloper ו-roles/serviceusage.serviceUsageConsumer.
  • ‫gcloud functions deploy או Cloud Functions v2 API: מקצים את התפקיד roles/cloudfunctions.developer או roles/cloudfunctions.admin.
פונקציות Cloud Run target-cloud-run-functions
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון שירות של טריגרים Cloud Run Invoker
(roles/run.invoker)

נדרש בשירות או בפרויקט הבסיסי של Cloud Run (מותנה): מאפשר לטריגר להפעיל פונקציית Cloud Run מאומתת.

פונקציות Cloud Run target-cloud-run-functions
כל מקורות האירועים source-all source-cloud-storage source-pubsub סוכן השירות של Cloud Functions‏
(service-PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com)
סוכן שירות של Cloud Functions
(roles/cloudfunctions.serviceAgent)

ניתן כברירת מחדל בפרויקט (מותנה): נדרש כשפורסים פונקציות באמצעות gcloud functions deploy או Cloud Functions v2 API, כדי שסוכן השירות יוכל ליצור ולנהל טריגרים של Eventarc ושירותי Cloud Run בסיסיים. מוענק באופן אוטומטי כשמפעילים את Cloud Functions API.

הערה: התפקיד הזה הוצא משימוש והוא חל רק על פונקציות שנוצרו באמצעות Cloud Functions API. לפונקציות שנוצרו באמצעות Cloud Run, ראו את הדף תפקידים והרשאות ב-Cloud Run.

פונקציות Cloud Run target-cloud-run-functions
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון שירות של טריגרים Pub/Sub Subscriber
(roles/pubsub.subscriber)

נדרש בפרויקט: מאפשר לטריגר לצרוך הודעות מ-Pub/Sub ולצרף מינויים לנושא.

GKE target-gke
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון שירות של טריגרים כתיבת מדדי מעקב
(roles/monitoring.metricWriter)

נדרש בפרויקט: מאפשר למעביר האירועים של Eventarc לכתוב מדדים באמצעות Cloud Monitoring ומערכות אחרות שמספקות מדדים.

GKE target-gke
כל מקורות האירועים source-all source-cloud-storage source-pubsub סוכן השירות של Eventarc
(service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com)

כל התנאים הבאים:

נדרש בפרויקט: מאפשר לסוכן השירות ליצור את רכיב העברת האירועים ולנהל משאבים באשכול GKE. הגבולות נקבעים כשמפעילים את gcloud eventarc gke-destinations init.

GKE target-gke
כל מקורות האירועים source-all source-cloud-storage source-pubsub סוכן השירות של Eventarc
(service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com)
DNS Peer
(roles/dns.peer)

נדרש בפרויקט המארח של ה-VPC (מותנה): מאפשר לסוכן השירות של פרויקט הטריגר לגשת לרשתות יעד עם אזורי קישור בין רשתות שכנות (peering) ב-DNS, כשכתובת ה-URI של נקודת הקצה הפנימית של ה-HTTP משתמשת בשם DNS פנימי שניתן לפתור באמצעות Cloud DNS.

נקודת קצה פנימית של HTTP ברשת VPC target-vpc
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון שירות של טריגרים מפעיל Workflows
(roles/workflows.invoker)

נדרש בפרויקט: מאפשר לטריגר להפעיל את תהליך העבודה של היעד.

תהליכי עבודה target-workflows
כל מקורות האירועים source-all source-cloud-storage source-pubsub חשבון שירות של Workflow כתיבת יומנים
(roles/logging.logWriter)

נדרש בפרויקט (מותנה): נדרש אם תהליך העבודה שולח יומנים ל-Cloud Logging.

תהליכי עבודה target-workflows

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