ב-Application Design Center, אתם יכולים להגדיר נושא ומינוי ב-Pub/Sub כדי לספק העברת הודעות אסינכרונית וניתנת להתאמה, שמפרידה בין השירותים שמפיקים הודעות לבין השירותים שמעבדים אותן. אתם יכולים להתאים אישית את החיבורים של הרכיבים ואת הפרמטרים של ההגדרות של הנושא והמינוי, על סמך המודול של terraform-google-pubsub ב-Terraform ב-GitHub.
חיבורים של רכיבים
בטבלה הבאה מפורטים הרכיבים שאפשר לקשר לנושא או למינוי ב-Pub/Sub, והעדכונים שנוצרים כתוצאה מכך באפליקציה ובקוד Terraform שנוצר.
| רכיב מחובר | עדכונים לאפליקציות | מידע רקע |
|---|---|---|
|
תבניות של הגדרות מכונה | |
|
בקרת גישה באמצעות ניהול זהויות והרשאות גישה (IAM) | |
|
מינויים ל-BigQuery | |
|
מדריך לשימוש ב-Pub/Sub עם Cloud Run | |
|
מינויים ל-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 | סוגי סכימות |
| סכימה | הגדרה | הגדרה | סוגי סכימות |
| סכימה | קידוד | קידוד | הנחיות לשיוך סכימה לנושא |