הגדרת תוויות למופעים

תוויות Cloud Run הן צמדי מפתח/ערך שמוחלים על מכונות Cloud Run. בדף הזה מוסבר איך להגדיר, לשנות ולמחוק תוויות במופעים של Cloud Run. שימו לב: כשמגדירים תווית במופע של Cloud Run, נוצרת למופע הזה גרסה חדשה עם התווית הזו. התווית לא מוחלת על גרסאות קודמות.

שימושים אפשריים:

  • הקצאת עלויות ופירוט החיובים.
  • זיהוי משאבים שבהם נעשה שימוש על ידי צוותים או מרכזי עלות ספציפיים.
  • להבחין בין סביבות פריסה (ייצור, Staging, בקרת איכות או בדיקה).
  • זיהוי בעלים ותוויות מצב.
  • סינון יומנים ב-Logging.

כללי שימוש בתוויות

הכלל הבא חל על השימוש בתוויות שהוגדרו במופע של Cloud Run:

אפשר להשתמש ב-Cloud Run רק בתוויות תקינות Google Cloud .

תוויות לנתוני חיוב ולרישום ביומן

החיוב ב-Cloud ו-Cloud Logging מקבלים רק תוויות שמצוינות במאפיין spec.template.metadata.labels ב-YAML, או בקטע template ב-Terraform. אם מגדירים תוויות באמצעות Google Cloud CLI, ‏ Cloud Run מוסיף את התוויות גם למאפיינים metadata.labels וגם למאפיינים spec.template.metadata.labels.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות להגדרה ולפריסה של מופעי Cloud Run, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

רשימת ההרשאות והתפקידים ב-IAM שמשויכים ל-Cloud Run מופיעה במאמרים תפקידי IAM ב-Cloud Run והרשאות IAM ב-Cloud Run. אם מופע Cloud Run שלכם מתקשר עםGoogle Cloud ממשקי API, כמו ספריות לקוח של Cloud, כדאי לעיין במדריך להגדרת זהות שירות. מידע נוסף על מתן תפקידים זמין במאמרים הרשאות פריסה וניהול גישה.

הגדרה או שינוי של תוויות

אפשר להגדיר או לשנות תוויות באמצעות Google Cloud CLI:

gcloud

כדי לעדכן תוויות של מכונה, משתמשים בפקודה:

gcloud beta run instances update INSTANCE --update-labels KEY=VALUE

כדי לעדכן יותר מתווית אחת, צריך לספק רשימה של זוגות של מפתח וערך, מופרדים בפסיקים. שימו לב שהפקודה update-labels מגדירה ערך חדש למפתח התווית אם התווית כבר קיימת, אחרת היא יוצרת תווית חדשה.

מחליפים את מה שכתוב בשדות הבאים:

  • ‫INSTANCE: השם של מופע Cloud Run.
  • ‫KEY: השם של מפתח התווית.
  • ‫VALUE: הערך של המפתח.

אפשר גם להגדיר תוויות במהלך הפריסה:

gcloud beta run instances deploy INSTANCE --image IMAGE --labels KEY=VALUE

כדי ליצור יותר מתווית אחת במהלך הפריסה, צריך לספק רשימה של צמדי מפתח/ערך שמופרדים באמצעות פסיקים.

YAML

  1. אם אתם יוצרים מכונה חדשה, דלגו על השלב הזה. אם אתם מעדכנים מופע קיים, אתם צריכים להוריד את הגדרות ה-YAML שלו:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. בדוגמה הבאה מופיעה הגדרת ה-YAML:

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫INSTANCE: השם של מופע Cloud Run.
    • ‫KEY ו-VALUE: צמדי מפתח/ערך של תוויות.

    ‫metadata.labels מגדיר תוויות באובייקט של המכונה, ואילו spec.template.metadata.labels מגדיר תוויות בגרסה שנוצרה. ‫Cloud Run מעביר רק את התוויות שמוגדרות בגרסה לחיוב ב-Cloud ול-Cloud Logging.

  3. יוצרים או מעדכנים את המכונה באמצעות הפקודה הבאה:

    gcloud beta run instances replace instance.yaml

הצגת רשימה של מכונות לפי תווית

אפשר לרשום את המופעים לפי תוויות באמצעות מסנן Google Cloud CLI:

  gcloud beta run instances list --filter metadata.labels.LABEL=VALUE

מחליפים את מה שכתוב בשדות הבאים:

  • ‫LABEL: שם התווית.
  • ‫VALUE: הערך שרוצים לכלול ברשימה המסוננת.

מחיקת תווית במופע

אפשר להשתמש ב-Google Cloud CLI כדי למחוק תוויות במופע.

gcloud

כדי לנקות את כל התוויות ממופע:

gcloud beta run instances update INSTANCE --clear-labels

כדי למחוק תוויות ספציפיות ממופע, צריך לספק רשימה של מפתחות מופרדים בפסיקים:

gcloud beta run instances update INSTANCE --remove-labels LABEL

מחליפים את מה שכתוב בשדות הבאים:

  • ‫INSTANCE: השם של מופע Cloud Run.
  • ‫LABEL: שם התווית.