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

‫Pub/Sub הוא שירות העברת הודעות אסינכרוני וניתן להרחבה, שמפריד בין שירותים שמפיקים הודעות לבין שירותים שמעבדים את ההודעות האלה. מידע נוסף זמין במאמר מה זה Pub/Sub?

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

חיבורי רכיבים

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

רכיב מחובר	עדכונים לאפליקציות	נתוני רקע
תבנית של הגדרות מכונה ב-Compute Engine	המכונות של Compute Engine יכולות לפרסם הודעות בנושא ב-Pub/Sub ולקבל ממנו הודעות. מזהה הנושא ב-Pub/Sub מתווסף למטא-נתונים של תבנית של הגדרות מכונה ב-Compute Engine.	תבניות של מכונות
חשבון שירות	חשבון השירות יכול לנהל נושאים ב-Pub/Sub ולשלוף הודעות ממינויים. התפקיד roles/pubsub.editor נוסף לחשבון השירות. השם של חשבון השירות ופרטי האימייל שלו מתווספים למינוי Pub/Sub pull.	בקרת גישה באמצעות 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	הנחיות למתן שם לנושא, למינוי, לסכימה או לתמונת מצב

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

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

תכונה	שם הפרמטר	תיאור ומידע על אילוצים	נתוני רקע
	יצירת נושא	כברירת מחדל, נוצר נושא. אם לא רוצים ליצור נושא, מבטלים את הסימון בתיבת הסימון.	יצירת נושא
	יצירת מינויים	כברירת מחדל, נוצר מינוי. כדי לא ליצור מינוי, מבטלים את הסימון בתיבת הסימון.	סקירה כללית של המינויים
תוויות נושאים	Key	labels	דיווח על השימוש באמצעות תוויות
	ערך	labels	דיווח על השימוש באמצעות תוויות
הרשמות ל-Push	שם	name	הנחיות למתן שם לנושא, למינוי, לסכימה או לתמונת מצב
	Ack Deadline Seconds	ackDeadlineSeconds	הדדליין למתן אישור
	Push Endpoint	pushEndpoint	נקודות קצה
	X-goog-version	הפורמט של הודעת הפוש ב-Pub/Sub API. לדוגמה, v1beta1.	מאפיינים
	OIDC Service Account email	serviceAccountEmail	אימות
	קהל	קהל	אימות
	מדיניות התפוגה	expirationPolicy	תקופת התפוגה
	נושא להודעות ללא מוצא	deadLetterTopic	נושא להודעות ללא מוצא
	שמירת הודעות שאושרה קבלתן	retainAckedMessages	שמירת הודעות שאושרה קבלתן
	משך שמירת ההודעות	messageRetentionDuration	משך השמירה של ההודעות
	מספר ניסיונות המסירה המקסימלי	maxDeliveryAttempts	נושא להודעות ללא מוצא
	Maximum Backoff	maximumBackoff	מדיניות ניסיון חוזר
	Minimum Backoff	minimumBackoff	מדיניות ניסיון חוזר
	מסנן	מסנן	מסנן מינויים
	הפעלת האפשרות 'סדר ההודעות'	enableMessageOrdering	סדר ההודעות
מינויי שליפה	שם	name	הנחיות למתן שם לנושא, למינוי, לסכימה או לתמונת מצב
	Ack Deadline Seconds	ackDeadlineSeconds	הדדליין למתן אישור
	נושא להודעות ללא מוצא	deadLetterTopic	נושא להודעות ללא מוצא
	מספר ניסיונות המסירה המקסימלי	maxDeliveryAttempts	נושא להודעות ללא מוצא
	שמירת הודעות שאושרה קבלתן	retainAckedMessages	שמירת הודעות שאושרה קבלתן
	משך שמירת ההודעות	messageRetentionDuration	משך השמירה של ההודעות
	Maximum Backoff	maximumBackoff	מדיניות ניסיון חוזר
	Minimum Backoff	minimumBackoff	מדיניות ניסיון חוזר
	מסנן	מסנן	מסנן מינויים
	הפעלת האפשרות 'סדר ההודעות'	enableMessageOrdering	סדר ההודעות
	חשבון שירות
	הפעלת אספקה של כל הודעה בדיוק פעם אחת	enableExactlyOnceDelivery	מסירה בדיוק פעם אחת
מינויים ל-BigQuery	שם	name	הנחיות למתן שם לנושא, למינוי, לסכימה או לתמונת מצב
	טבלה	table	יצירת מינויים ל-BigQuery
	שימוש בסכימת נושאים	useTopicSchema	שימוש במינוי לנושא
	שימוש בסכימת טבלה	useTableSchema	שימוש בסכימת הטבלה
	כתיבת מטא-נתונים	writeMetadata	כתיבת מטא-נתונים
	הסרת שדות לא מוכרים	dropUnknownFields	הסרת שדות לא מוכרים
	Ack Deadline Seconds	ackDeadlineSeconds	הדדליין למתן אישור
	שמירת הודעות שאושרה קבלתן	retainAckedMessages	שמירת הודעות שאושרה קבלתן
	משך שמירת ההודעות	messageRetentionDuration	משך השמירה של ההודעות
	הפעלת האפשרות 'סדר ההודעות'	enableMessageOrdering	סדר ההודעות
	מדיניות התפוגה	expirationPolicy	תקופת התפוגה
	מסנן	מסנן	מסנן מינויים
	נושא להודעות ללא מוצא	deadLetterTopic	נושא להודעות ללא מוצא
	Maximum Backoff	maximumBackoff	מדיניות ניסיון חוזר
	Minimum Backoff	minimumBackoff	מדיניות ניסיון חוזר
מינויים ל-Cloud Storage	שם	name	הנחיות למתן שם לנושא, למינוי, לסכימה או לתמונת מצב
	Bucket	bucket	שם הקטגוריה
	קידומת של שם הקובץ	filenamePrefix	תחילית, סיומת ותאריך ושעה של שם הקובץ
	סיומת שם הקובץ	filenameSuffix	תחילית, סיומת ותאריך ושעה של שם הקובץ
	פורמט התאריך והשעה בשם הקובץ	filenameDatetimeFormat	תחילית, סיומת ותאריך ושעה של שם הקובץ
	משך הזמן המקסימלי	maxDuration	קיבוץ קבצים
	מספר בייטים מקסימלי	maxBytes	קיבוץ קבצים
	מספר הודעות מקסימלי	maxMessages	קיבוץ קבצים
	פורמט הפלט	‫textConfig או avroConfig	פורמט הקובץ
	כתיבת מטא-נתונים	writeMetadata	כתיבת מטא-נתונים
	שימוש בסכימת נושאים	useTopicSchema	שימוש בסכימת נושאים
	Ack Deadline Seconds	ackDeadlineSeconds	הדדליין למתן אישור
	שמירת הודעות שאושרה קבלתן		שמירת הודעות שאושרה קבלתן
	משך שמירת ההודעות	messageRetentionDuration	משך השמירה של ההודעות
	הפעלת האפשרות 'סדר ההודעות'	enableMessageOrdering	סדר ההודעות
	מדיניות התפוגה	expirationPolicy	תקופת התפוגה
	מסנן	מסנן	מסנן מינויים
	נושא להודעות ללא מוצא	deadLetterTopic	נושא להודעות ללא מוצא
	Maximum Backoff	maximumBackoff	מדיניות ניסיון חוזר
	Minimum Backoff	minimumBackoff	מדיניות ניסיון חוזר
תוויות מינוי	Key	labels	דיווח על השימוש באמצעות תוויות
	ערך	labels	דיווח על השימוש באמצעות תוויות
	משך השמירה של הודעות בנושא	topicMessageRetentionDuration	משך השמירה של ההודעות
	שם מפתח KMS של הנושא	kmsKeyName	שימוש במפתח הצפנה בניהול הלקוח (CMEK)
	הענקת תפקידים בפרויקט BigQuery	כברירת מחדל, התפקידים BigQuery Metadata Viewer (צפייה במטא-נתונים של BigQuery) ו-BigQuery Data Editor (עריכת נתונים ב-BigQuery) מוענקים לחשבון השירות שמוגדר כברירת מחדל ב-Pub/Sub. אם לא רוצים להעניק את התפקידים האלה, מבטלים את הסימון בתיבת הסימון.	הקצאת תפקידים ב-BigQuery לחשבון השירות של Pub/Sub
	Grant Token Creator	כברירת מחדל, התפקיד Service Account Token Creator מוקצה לחשבון השירות שמוגדר כברירת מחדל ב-Pub/Sub. אם לא רוצים להעניק את התפקיד הזה, מבטלים את הסימון בתיבת הסימון.	הגדרת אימות ל-Pub/Sub
סכימה	שם	name	מידע חשוב על סכימות
	סוג	type	סוגים של סכימות
	הגדרה	הגדרה	סוגים של סכימות
	קידוד	קידוד	הנחיות לשיוך סכימה לנושא