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

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

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

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

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

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

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

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

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

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

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

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

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

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 עם הערך שנבחר.

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

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: הערך שנבחר.

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

אפשר לרשום משימות לפי תוויות באמצעות מסנן 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: השם של התווית