הגדרת תוויות למשרות

תוויות 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 או Google Cloud CLI, ‏ Cloud Run מוסיף את התוויות גם למאפיינים metadata.labels וגם למאפיינים spec.template.metadata.labels.

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

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

• ‫Cloud Run Developer (roles/run.developer) במשימה ב-Cloud Run
• משתמש בחשבון שירות (roles/iam.serviceAccountUser) בזהות השירות

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

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

אפשר להשתמש במסוף Google Cloud , ב-Google Cloud CLI, ב-YAML או ב-Terraform כדי להגדיר תווית לעבודת Cloud Run.

המסוף

1. נכנסים לדף Jobs ב-Cloud Run במסוף Google Cloud :

   כניסה ל-Cloud Run

2. מסמנים את תיבת הסימון שמימין למשרה שרוצים להוסיף לה תווית.

3. מוודאים שהאפשרות Info Panel (חלונית המידע) מופעלת בצד שמאל (Show Info Panel).

4. לוחצים על תוויות כדי להציג את חלונית התוויות.

   

5. כדי לערוך ערך קיים של מפתח תווית, מאתרים את התווית ומשנים את הערך.

6. כדי להגדיר תווית חדשה בשירות, לוחצים על Add Label (הוספת תווית) ומזינים את המפתח ואת הערך.

7. לוחצים על שמירה

gcloud

1. כדי להגדיר תווית למשימה חדשה:

   gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

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

   • ‫JOB_NAME בשם של המשימה.
   • ‫KEY מחליפים בשם של מפתח התווית.
   • ‫VALUE עם הערך של המפתח.
   • ‫IMAGE_URL: הפניה לקובץ אימג' בקונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.

2. כדי להגדיר תווית למשרה קיימת:

   gcloud run jobs update JOB_NAME --labels KEY=VALUE

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

   gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2 

YAML

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

   gcloud run jobs describe JOB_NAME --format export > job.yaml

2. מעדכנים את המאפיינים labels בשני מקומות:

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     labels:
       LABEL: VALUE
   spec:
     template:
       metadata:
         labels:
           LABEL: VALUE

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

   • LABEL בשם התווית.
   • ‫VALUE עם הערך שנבחר.

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

   ‫Cloud Run מעביר רק את התוויות שהוגדרו במאפיין spec.template.metadata.labels אל חיוב ב-Cloud ו-Cloud Logging.

3. מעדכנים את ההגדרה הקיימת של העבודה:

   gcloud run jobs replace job.yaml

Terraform

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

מוסיפים את השורות הבאות למשאב google_cloud_run_v2_job בתצורת Terraform:

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
      }
    }
    labels = {
    "LABEL":"VALUE"
    }
  }
  labels = {
    "LABEL":"VALUE"
  }
}

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

• ‫JOB_NAME: השם של המשימה ב-Cloud Run.
• ‫REGION: Google Cloud האזור. לדוגמה: europe-west1.
• ‫LABEL: שם התווית.
• ‫VALUE: הערך שנבחר.

‫Cloud Run מעביר רק תוויות שהוגדרו בקטע template אל חיוב ב-Cloud ו-Cloud Logging.

רשימת משרות לפי תווית

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

  gcloud run jobs list --filter metadata.labels.LABEL=VALUE
  

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

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

מחיקת תווית ממשרה

כדי לנקות את כל התוויות ממשרה:

gcloud run jobs update JOB --clear-labels

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

gcloud run jobs update JOB --remove-labels LABEL

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

• ‫JOB: השם של המשימה ב-Cloud Run
• ‫LABEL: השם של התווית