הגדרת נושא ומינוי ב-Pub/Sub

ב-Application Design Center, אתם יכולים להגדיר נושא ומינוי ב-Pub/Sub כדי לספק העברת הודעות אסינכרונית וניתנת להתאמה, שמפרידה בין השירותים שמפיקים הודעות לבין השירותים שמעבדים אותן. אתם יכולים להתאים אישית את החיבורים של הרכיבים ואת הפרמטרים של ההגדרות של הנושא והמינוי, על סמך המודול של terraform-google-pubsub ב-Terraform ב-GitHub.

חיבורים של רכיבים

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

רכיב מחובר עדכונים לאפליקציות מידע רקע

תבנית של הגדרות מכונה ב-Compute Engine

  • המכונות של Compute Engine יכולות לפרסם הודעות בנושא ב-Pub/Sub ולקבל ממנו הודעות.
  • מזהה הנושא של Pub/Sub נוסף למטא-נתונים של תבנית של הגדרות מכונה של Compute Engine.
תבניות של הגדרות מכונה

חשבון שירות

  • חשבון השירות יכול לנהל נושאים ב-Pub/Sub ולמשוך הודעות ממינויים.
  • התפקיד roles/pubsub.editor מוקצה לחשבון השירות.
  • השם וכתובת האימייל של חשבון השירות נוספים למינוי השליפה של Pub/Sub.
בקרת גישה באמצעות ניהול זהויות והרשאות גישה (IAM)

BigQuery

  • המינוי ל-Pub/Sub יכול לכתוב הודעות בטבלה במערך הנתונים של BigQuery.
  • פרטי מערך הנתונים והטבלה ב-BigQuery נוספים לשדות של המינוי ל-Pub/Sub.
מינויים ל-BigQuery

Cloud Run

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

Cloud Storage

  • המינוי ל-Pub/Sub יכול לכתוב הודעות לקטגוריה של Cloud Storage.
  • פרטי הקטגוריה של Cloud Storage נוספים לשדות המינוי ב-Pub/Sub.
מינויים ל-Cloud Storage

פרמטרים נדרשים להגדרה

אם התבנית כוללת רכיב Pub/Sub, צריך להגדיר את הפרמטרים הבאים לפני הפריסה.

שם הפרמטר תיאור ומגבלות מידע רקע

מזהה פרויקט

הפרויקט שבו רוצים לפרוס את המשאב של Pub/Sub.

הגדרת רכיבים

נושא

name הנחיות למתן שמות לנושא, למינוי, לסכימה או לתמונת מצב

פרמטרים אופציונליים להגדרה

הפרמטרים הבאים הם אופציונליים. כדי להציג פרמטרים מתקדמים, באזור Configuration בוחרים באפשרות Show advanced fields.

תכונה שם הפרמטר תיאור ומידע על המגבלה מידע רקע
יצירת נושא כברירת מחדל, נוצר נושא. אם לא רוצים ליצור נושא, מבטלים את הסימון בתיבה. יצירת נושא
יצירת מינויים כברירת מחדל, נוצר מינוי. אם לא רוצים ליצור מינוי, מבטלים את הסימון בתיבה. סקירה כללית של המינוי
תוויות של נושאים מפתח תוויות דיווח על שימוש באמצעות תוויות
תוויות של נושאים ערך תוויות דיווח על שימוש באמצעות תוויות
מינויי דחיפה שם name הנחיות למתן שמות לנושא, למינוי, לסכימה או לתמונת מצב
מינויי דחיפה Ack Deadline Seconds ackDeadlineSeconds המועד האחרון לאישור
מינויי דחיפה נקודת קצה לדחיפת הודעות pushEndpoint נקודות קצה (endpoints)
מינויי דחיפה X-goog-version הפורמט של Pub/Sub API של ההודעה שנשלחה. לדוגמה, v1beta1. מאפיינים
מינויי דחיפה כתובת האימייל של חשבון השירות של OIDC serviceAccountEmail אימות
מינויי דחיפה קהל קהל אימות
מינויי דחיפה מדיניות התפוגה expirationPolicy תקופת התפוגה
מינויי דחיפה נושא להודעות ללא מוצא deadLetterTopic נושא להודעות ללא מוצא
מינויי דחיפה שמירת הודעות שאושרו retainAckedMessages thought שמירת הודעות שאושרו
מינויי דחיפה משך שמירת ההודעות messageRetentionDuration משך השמירה של הודעות
מינויי דחיפה מספר ניסיונות המסירה המקסימלי maxDeliveryAttempts נושא להודעות ללא מוצא
מינויי דחיפה Maximum Backoff maximumBackoff מדיניות ניסיונות חוזרים
מינויי דחיפה Minimum Backoff minimumBackoff מדיניות ניסיונות חוזרים
מינויי דחיפה סינון filter מסנן מינויים
מינויי דחיפה הפעלת סדר ההודעות enableMessageOrdering סדר ההודעות
מינויי שליפה שם name הנחיות למתן שמות לנושא, למינוי, לסכימה או לתמונת מצב
מינויי שליפה Ack Deadline Seconds ackDeadlineSeconds המועד האחרון לאישור
מינויי שליפה נושא להודעות ללא מוצא deadLetterTopic נושא להודעות ללא מוצא
מינויי שליפה מספר ניסיונות המסירה המקסימלי maxDeliveryAttempts נושא להודעות ללא מוצא
מינויי שליפה שמירת הודעות שאושרו retainAckedMessages thought שמירת הודעות שאושרו
מינויי שליפה משך שמירת ההודעות messageRetentionDuration משך השמירה של הודעות
מינויי שליפה Maximum Backoff maximumBackoff מדיניות ניסיונות חוזרים
מינויי שליפה Minimum Backoff minimumBackoff מדיניות ניסיונות חוזרים
מינויי שליפה סינון filter מסנן מינויים
מינויי שליפה הפעלת סדר ההודעות enableMessageOrdering סדר ההודעות
מינויי שליפה חשבון שירות חשבון השירות שקיבל את התפקיד roles/pubsub.subscriber במינוי. בקרת גישה באמצעות IAM
מינויי שליפה הפעלת מסירה פעם אחת בדיוק enableExactlyOnceDelivery מסירה פעם אחת בדיוק
מינויים ל-BigQuery שם name הנחיות למתן שמות לנושא, למינוי, לסכימה או לתמונת מצב
מינויים ל-BigQuery טבלה טבלה יצירת מינויים ל-BigQuery
מינויים ל-BigQuery שימוש בסכימת נושאים useTopicSchema שימוש בסכימת נושא
מינויים ל-BigQuery שימוש בסכימת טבלה useTableSchema שימוש בסכימת טבלה
מינויים ל-BigQuery כתיבת מטא-נתונים writeMetadata כתיבת מטא-נתונים
מינויים ל-BigQuery השמטת שדות לא ידועים dropUnknownFields השמטת שדות לא ידועים
מינויים ל-BigQuery Ack Deadline Seconds ackDeadlineSeconds המועד האחרון לאישור
מינויים ל-BigQuery שמירת הודעות שאושרו retainAckedMessages thought שמירת הודעות שאושרו
מינויים ל-BigQuery משך שמירת ההודעות messageRetentionDuration משך השמירה של הודעות
מינויים ל-BigQuery הפעלת סדר ההודעות enableMessageOrdering סדר ההודעות
מינויים ל-BigQuery מדיניות התפוגה expirationPolicy תקופת התפוגה
מינויים ל-BigQuery סינון filter מסנן מינויים
מינויים ל-BigQuery נושא להודעות ללא מוצא deadLetterTopic נושא להודעות ללא מוצא
מינויים ל-BigQuery Maximum Backoff maximumBackoff מדיניות ניסיונות חוזרים
מינויים ל-BigQuery Minimum Backoff minimumBackoff מדיניות ניסיונות חוזרים
מינויים לאחסון בענן שם name הנחיות למתן שמות לנושא, למינוי, לסכימה או לתמונת מצב
מינויים לאחסון בענן קטגוריה bucket שם הקטגוריה
מינויים לאחסון בענן קידומת שם הקובץ filenamePrefix קידומת, סיומת ותאריך ושעה של שם הקובץ
מינויים לאחסון בענן סיומת שם הקובץ filenameSuffix קידומת, סיומת ותאריך ושעה של שם הקובץ
מינויים לאחסון בענן פורמט התאריך והשעה של שם הקובץ filenameDatetimeFormat קידומת, סיומת ותאריך ושעה של שם הקובץ
מינויים לאחסון בענן משך זמן מקסימלי maxDuration העלאת קבצים באצווה
מינויים לאחסון בענן מספר הבייטים המקסימלי maxBytes העלאת קבצים באצווה
מינויים לאחסון בענן מקסימום הודעות maxMessages העלאת קבצים באצווה
מינויים לאחסון בענן פורמט הפלט textConfig או avroConfig פורמט הקובץ
מינויים לאחסון בענן כתיבת מטא-נתונים writeMetadata פורמט הקובץ
מינויים לאחסון בענן שימוש בסכימת נושאים useTopicSchema פורמט הקובץ
מינויים לאחסון בענן Ack Deadline Seconds ackDeadlineSeconds המועד האחרון לאישור
מינויים לאחסון בענן שמירת הודעות שאושרו retainAckedMessages thought שמירת הודעות שאושרו
מינויים לאחסון בענן משך שמירת ההודעות messageRetentionDuration משך השמירה של הודעות
מינויים לאחסון בענן הפעלת סדר ההודעות enableMessageOrdering סדר ההודעות
מינויים לאחסון בענן מדיניות התפוגה expirationPolicy תקופת התפוגה
מינויים לאחסון בענן סינון filter מסנן מינויים
מינויים לאחסון בענן נושא להודעות ללא מוצא deadLetterTopic נושא להודעות ללא מוצא
מינויים לאחסון בענן Maximum Backoff maximumBackoff מדיניות ניסיונות חוזרים
מינויים לאחסון בענן Minimum Backoff minimumBackoff מדיניות ניסיונות חוזרים
תוויות של מינויים מפתח תוויות דיווח על שימוש באמצעות תוויות
תוויות של מינויים ערך תוויות דיווח על שימוש באמצעות תוויות
משך שמירת ההודעות בנושא topicMessageRetentionDuration משך השמירה של הודעות
שם מפתח KMS של הנושא kmsKeyName שימוש במפתח הצפנה בניהול הלקוח (CMEK)
הקצאת תפקידים בפרויקט ב-BigQuery כברירת מחדל, התפקידים BigQuery Metadata Viewer‏ (roles/bigquery.metadataViewer) ו-BigQuery Data Editor‏ (roles/bigquery.dataEditor) מוקצים לחשבון השירות של Pub/Sub שמוגדר כברירת מחדל. אם אתם לא רוצים להקצות את התפקידים האלה, בטלו את הסימון בתיבה. הקצאת תפקידי IAM לחשבון השירות
הענקת התפקיד "יצירת אסימונים" כברירת מחדל, התפקיד יצירת אסימונים בחשבון שירות מוקצה לחשבון השירות שמוגדר כברירת מחדל ב-Pub/Sub. אם לא רוצים להקצות את התפקיד הזה, מבטלים את הסימון בתיבה. הגדרת אימות ל-Pub/Sub
סכימה שם name מידע חשוב על סכימות
סכימה סוג type סוגי סכימות
סכימה הגדרה הגדרה סוגי סכימות
סכימה קידוד קידוד הנחיות לשיוך סכימה לנושא