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

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

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

בטבלה הבאה מפורטים הרכיבים שאפשר לקשר לנושא או למינוי ב-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 נוסף לשדות המינוי ל-BigQuery.
מינויים ל-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 המועד האחרון לאישור
נקודת קצה (endpoint) של Push pushEndpoint נקודות קצה (endpoints)
X-goog-version הפורמט של Pub/Sub API של ההודעה שנשלחה. לדוגמה, v1beta1. מאפיינים
כתובת האימייל של חשבון השירות של OIDC serviceAccountEmail אימות
קהל קהל אימות
מדיניות התפוגה expirationPolicy תקופת התפוגה
נושא להודעות ללא מוצא deadLetterTopic נושא להודעות ללא מוצא
שמירת הודעות שאושרו retainAckedMessages שמירת הודעות שאושרו
משך שמירת ההודעות messageRetentionDuration משך השמירה של הודעות
מספר ניסיונות המסירה המקסימלי maxDeliveryAttempts נושא להודעות ללא מוצא
Maximum Backoff maximumBackoff מדיניות ניסיונות חוזרים
Minimum Backoff minimumBackoff מדיניות ניסיונות חוזרים
סינון filter מסנן מינויים
הפעלת סדר ההודעות enableMessageOrdering סדר ההודעות

מינויי שליפה

שם name הנחיות למתן שמות לנושא, למינוי, לסכימה או לתמונת מצב
Ack Deadline Seconds ackDeadlineSeconds המועד האחרון לאישור
נושא להודעות ללא מוצא deadLetterTopic נושא להודעות ללא מוצא
מספר ניסיונות המסירה המקסימלי maxDeliveryAttempts נושא להודעות ללא מוצא
שמירת הודעות שאושרו retainAckedMessages שמירת הודעות שאושרו
משך שמירת ההודעות messageRetentionDuration משך השמירה של הודעות
Maximum Backoff maximumBackoff מדיניות ניסיונות חוזרים
Minimum Backoff minimumBackoff מדיניות ניסיונות חוזרים
סינון filter מסנן מינויים
הפעלת סדר ההודעות enableMessageOrdering סדר ההודעות
חשבון שירות
הפעלת מסירה פעם אחת בדיוק enableExactlyOnceDelivery מסירה פעם אחת בדיוק

מינויים ל-BigQuery

שם name הנחיות למתן שמות לנושא, למינוי, לסכימה או לתמונת מצב
טבלה טבלה יצירת מינויים ל-BigQuery
שימוש בסכימת נושאים useTopicSchema שימוש במינוי לנושא
שימוש בסכימת טבלה useTableSchema שימוש בסכימת טבלה
כתיבת מטא-נתונים writeMetadata כתיבת מטא-נתונים
השמטת שדות לא ידועים dropUnknownFields השמטת שדות לא ידועים
Ack Deadline Seconds ackDeadlineSeconds המועד האחרון לאישור
שמירת הודעות שאושרו retainAckedMessages שמירת הודעות שאושרו
משך שמירת ההודעות messageRetentionDuration משך השמירה של הודעות
הפעלת סדר ההודעות enableMessageOrdering סדר ההודעות
מדיניות התפוגה expirationPolicy תקופת התפוגה
סינון filter מסנן מינויים
נושא להודעות ללא מוצא deadLetterTopic נושא להודעות ללא מוצא
Maximum Backoff maximumBackoff מדיניות ניסיונות חוזרים
Minimum Backoff minimumBackoff מדיניות ניסיונות חוזרים

מינויים לאחסון בענן

שם name הנחיות למתן שמות לנושא, למינוי, לסכימה או לתמונת מצב
קטגוריה bucket שם הקטגוריה
קידומת שם הקובץ filenamePrefix קידומת, סיומת ותאריך ושעה של שם הקובץ
סיומת שם הקובץ filenameSuffix קידומת, סיומת ותאריך ושעה של שם הקובץ
פורמט התאריך והשעה של שם הקובץ filenameDatetimeFormat קידומת, סיומת ותאריך ושעה של שם הקובץ
משך זמן מקסימלי maxDuration העלאת קבצים באצווה
מספר הבייטים המקסימלי maxBytes העלאת קבצים באצווה
מקסימום הודעות maxMessages העלאת קבצים באצווה
פורמט הפלט textConfig או avroConfig פורמט הקובץ
כתיבת מטא-נתונים writeMetadata כתיבת מטא-נתונים
שימוש בסכימת נושאים useTopicSchema שימוש בסכימת נושאים
Ack Deadline Seconds ackDeadlineSeconds המועד האחרון לאישור
שמירת הודעות שאושרו thought שמירת הודעות שאושרו
משך שמירת ההודעות messageRetentionDuration משך השמירה של הודעות
הפעלת סדר ההודעות enableMessageOrdering סדר ההודעות
מדיניות התפוגה expirationPolicy תקופת התפוגה
סינון filter מסנן מינויים
נושא להודעות ללא מוצא deadLetterTopic נושא להודעות ללא מוצא
Maximum Backoff maximumBackoff מדיניות ניסיונות חוזרים
Minimum Backoff minimumBackoff מדיניות ניסיונות חוזרים

תוויות של מינויים

מפתח תוויות דיווח על שימוש באמצעות תוויות
ערך תוויות דיווח על שימוש באמצעות תוויות
משך שמירת ההודעות בנושא topicMessageRetentionDuration משך השמירה של הודעות
שם מפתח KMS של הנושא kmsKeyName שימוש במפתח הצפנה בניהול הלקוח (CMEK)
הקצאת תפקידים בפרויקט ב-BigQuery כברירת מחדל, התפקידים BigQuery Metadata Viewer ו-BigQuery Data Editor מוקצים לחשבון השירות של Pub/Sub שמוגדר כברירת מחדל. אם אתם לא רוצים להקצות את התפקידים האלה, בטלו את הסימון בתיבה. הקצאת תפקידים ב-BigQuery לחשבון השירות של Pub/Sub
הענקת הרשאה ליצירת אסימונים כברירת מחדל, התפקיד יצירת אסימונים בחשבון שירות מוקצה לחשבון השירות של Pub/Sub שמוגדר כברירת מחדל. אם אתם לא רוצים להקצות את התפקיד הזה, בטלו את הסימון בתיבה. הגדרת אימות ל-Pub/Sub

סכימה

שם name מידע חשוב על סכימות
סוג type סוגי סכימות
הגדרה הגדרה סוגי סכימות
קידוד קידוד הנחיות לשיוך סכימה לנושא