ב-Pub/Sub, נושא הוא משאב עם שם שמייצג פיד של הודעות. כדי לפרסם נושא או להירשם אליו, צריך קודם ליצור אותו. ב-Pub/Sub יש תמיכה בשני סוגים של נושאים: נושא רגיל ונושא ייבוא.
במאמר הזה מוסבר איך ליצור נושא רגיל ב-Pub/Sub. אם אתם רוצים לקבל מידע נוסף על נושאים לייבוא ועל אופן היצירה שלהם, אתם יכולים לעיין במאמר מידע על נושאים לייבוא.
כדי ליצור נושא, אפשר להשתמש במסוף Google Cloud , ב-Google Cloud CLI, בספריית הלקוח או ב-Pub/Sub API.
לפני שמתחילים
תפקידים והרשאות נדרשים
כדי לקבל את ההרשאות שנדרשות ליצירת נושא, צריך לבקש מהאדמין להקצות לכם את התפקיד 'עורך Pub/Sub' (roles/pubsub.editor) ב-IAM בפרויקט.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
זהו תפקיד שמוגדר מראש וכולל את ההרשאות שנדרשות ליצירת נושא. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי ליצור נושא, צריך את ההרשאות הבאות:
-
כדי ליצור נושא בפרויקט, צריך לתת את ההרשאה הזו:
pubsub.topics.create
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
אפשר להגדיר בקרת גישה ברמת הפרויקט וברמת המשאב הספציפי. אפשר ליצור מינוי בפרויקט אחד ולצרף אותו לנושא שנמצא בפרויקט אחר. מוודאים שיש לכם את ההרשאות הנדרשות לכל פרויקט.
מאפיינים של נושא
כשיוצרים או מעדכנים נושא, צריך לציין את המאפיינים שלו.
הוספת מינוי ברירת מחדל
הוספת מינוי שמוגדר כברירת מחדל לנושא ב-Pub/Sub. אחרי שיוצרים את הנושא, אפשר ליצור מינוי נוסף לנושא. למינוי שמוגדר כברירת מחדל יש את המאפיינים הבאים:
- מזהה המינוי של
-sub - סוג משלוח Pull
- משך השמירה של ההודעות הוא שבעה ימים
- תוקף המבצע יפוג אחרי 31 ימים ללא פעילות
- מועד האישור הוא 10 שניות
- מדיניות ניסיון חוזר מיידי
שימוש בסכימה
סכימה היא פורמט ששדה נתוני ההודעה צריך להיות בהתאם אליו. סכימה היא חוזה בין בעל התוכן הדיגיטלי לבין המנוי, ש-Pub/Sub אוכף. סכימות של נושאים עוזרות לתקנן את סוגי ההודעות וההרשאות כדי לאפשר לצוותים שונים בארגון להשתמש בהן. ב-Pub/Sub נוצרת רשות מרכזית לסוגי הודעות ולהרשאות. כדי ליצור נושא עם סכימה, אפשר לעיין במאמר סקירה כללית על סכימות.
הפעלת ההטמעה
הפעלת המאפיין הזה מאפשרת לכם להטמיע נתונים בזמן אמת ממקורות חיצוניים בנושא, כדי שתוכלו להשתמש בתכונות של Google Cloud. כדי ליצור נושא לייבוא לצורך הטמעה, אפשר לעיין במאמרים הבאים:
הפעלת שמירת הודעות בנושא
כברירת מחדל, נושא Pub/Sub משליך הודעות ברגע שכל המינויים שמצורפים לנושא מאשרים את קבלתן. אפשר גם להגדיר נושא לשמירת הודעות לתקופה של עד 31 ימים, עם תקופת שמירה מינימלית של 10 דקות.
השמירה של הודעות מאפשרת למנויים להפעיל מחדש הודעות שאושרו בעבר או להפעיל מחדש הודעות שפורסמו לפני שיצרתם את המינוי. מידע נוסף זמין במאמר הפעלה מחדש ומחיקה של הודעות באמצעות חיפוש.
עלויות האחסון של ההודעות שנשמרות בנושא מחויבות בפרויקט של הנושא. אחרי שחלפה תקופת השמירה של ההודעה, יכול להיות ש-Pub/Sub ימחק את ההודעה בלי קשר למצב האישור שלה.
כדי לראות מדדים לגבי הודעות שנשמרו, משתמשים במדדים הבאים של Cloud Monitoring:
-
topic/num_retained_messages: מספר ההודעות שנשמרו -