תוויות ב-Pub/Sub עוזרות לכם לנהל את העלויות ולארגן את המשאבים. לדוגמה, נניח שיש לכם כמה מינויים לעדכוני חדשות מסוגים שונים. אפשר להוסיף לכל מינוי תווית עם קטגוריה רלוונטית, כמו news_category=sports או news_category=entertainment.
מהן תוויות?
תווית היא צמד מפתח/ערך שאפשר להקצות ל Google Cloud משאבים. הם עוזרים לכם לארגן את המשאבים האלה ולנהל את העלויות בקנה מידה נרחב, ברמת הפירוט שאתם צריכים. אפשר לצרף תוויות לכל משאב כדי לסנן את המשאבים לפי תוויות. המידע על התוויות מועבר למערכת החיוב, כך שתוכלו לפרט את החיובים לפי תוויות. בעזרת דוחות החיוב המובנים, אפשר לסנן ולקבץ את העלויות לפי תוויות משאבים. אפשר גם להשתמש בתוויות כדי להריץ שאילתות על ייצוא נתוני חיוב.
הדרישות לגבי תוויות
התוויות שמוחלות על משאב צריכות לעמוד בדרישות הבאות:
- אפשר להוסיף עד 64 תוויות לכל משאב.
- כל תווית צריכה להיות צמד מפתח/ערך.
- האורך המינימלי של המפתחות הוא תו אחד, והאורך המקסימלי הוא 63 תווים. המפתחות לא יכולים להיות ריקים. הערכים יכולים להיות ריקים, והאורך המקסימלי שלהם הוא 63 תווים.
- המפתחות והערכים יכולים להכיל רק אותיות קטנות, ספרות, קווים תחתונים ומקפים. כל התווים צריכים להיות בקידוד UTF-8, ומותר להשתמש בתווים בינלאומיים. המפתחות צריכים להתחיל באות קטנה או בתו בינלאומי.
- החלק של המפתח בתווית חייב להיות ייחודי בתוך משאב יחיד. עם זאת, אפשר להשתמש באותו מפתח עם כמה משאבים.
המגבלות האלה חלות על המפתח והערך של כל תווית, ועל המשאבים Google Cloud הבודדים שיש להם תוויות. אין הגבלה על מספר התוויות שאפשר להחיל על כל המשאבים בפרויקט.
שימושים נפוצים בתוויות
ריכזנו כאן כמה תרחישי שימוש נפוצים בתוויות:
תוויות של צוות או מרכז עלויות: אפשר להוסיף תוויות שמבוססות על צוות או על מרכז עלויות כדי להבחין בין משאבים שנמצאים בבעלות של צוותים שונים (לדוגמה,
team:researchו-team:analytics). אפשר להשתמש בסוג הזה של תוויות לצורך הנהלת חשבונות או תקצוב.תוויות רכיבים: לדוגמה,
component:redis,component:frontend,component:ingestו-component:dashboard.תוויות של סביבה או שלב: לדוגמה,
environment:productionו-environment:test.תוויות של מדינות: לדוגמה,
state:active,state:readytodeleteו-state:archive.תוויות בעלות: משמשות לזיהוי הצוותים שאחראים על הפעולות, לדוגמה:
team:shopping-cart.
אנחנו לא ממליצים ליצור מספר גדול של תוויות ייחודיות, למשל לסימון חותמות זמן או ערכים נפרדים לכל קריאה ל-API. הבעיה בגישה הזו היא שאם הערכים משתנים לעיתים קרובות או אם יש מפתחות שמבלגנים את הקטלוג, קשה לסנן את המשאבים ולדווח עליהם בצורה יעילה.
תוויות ותגים
אפשר להשתמש בתוויות כאנוטציות שאפשר להריץ עליהן שאילתות לגבי משאבים, אבל אי אפשר להשתמש בהן כדי להגדיר תנאים במדיניות. תגים מאפשרים להגדיר תנאי לאישור או לדחייה של כללי מדיניות אם תג ספציפי מצורף או לא מצורף למשאב, וכך מספקים שליטה פרטנית בכללי המדיניות. מידע נוסף מופיע במאמר סקירה כללית על תגים.
ניהול תוויות ב-Pub/Sub
ב-Pub/Sub, משתמשים בתוויות לעיתים קרובות כדי לארגן עמלות של חשבון חיוב מסוים. העמלות משויכות לחשבון לחיוב של הפרויקט שמכיל את המשאב המבוקש, אבל יכול להיות שתרצו ליצור שיוכים נוספים. לדוגמה, אפשר ליצור מינוי ששייך לפרויקט אחד לנושא ששייך לפרויקט אחר. אתם יכולים להשתמש בתוויות כדי לשייך את הנושא ואת המינוי למרכז עלויות משותף.
משאבי Pub/Sub לא מקבלים בירושה תוויות אחד מהשני. בדוגמה שלמעלה, צריך להגדיר את אותה תווית גם לנושא וגם למינוי כדי לשייך את החיובים האלה.
אפשר להשתמש בתכונות הבאות כדי להחיל תוויות על משאבי Pub/Sub:
- בGoogle Cloud מסוף: בוחרים משאב ועוברים לכרטיסייה תוויות.
- ספריות לקוח של Pub/Sub (במיוחד Java ו-Python).
- Google Cloud CLI ל-Pub/Sub. לדוגמה, אפשר לעיין בפקודה create topic.