הגדרת תוויות למאגרי עובדים

תוויות 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 הבאים:

• ‫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 או Terraform:

המסוף

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

   כניסה ל-Cloud Run

2. מאתרים את מאגר העובדים ומסמנים את התיבה שמשמאל לשם שלו.

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

   

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

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

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

gcloud

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

gcloud run worker-pools update WORKER_POOL --update-labels KEY=VALUE

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

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

• ‫WORKER_POOL: השם של מאגר העובדים ב-Cloud Run
• ‫KEY: השם של מפתח התווית
• ‫VALUE: הערך של המפתח

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

gcloud run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE

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

YAML

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

   gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml

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

   apiVersion: run.googleapis.com/v1
   kind: WorkerPool
   metadata:
     name: WORKER_POOL
     labels:
       KEY: VALUE
       KEY2: VALUE2
       KEY3: VALUE3

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

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

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

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

   gcloud run worker-pools replace worker-pool.yaml

   אם קיים קובץ worker-pool.yaml, הפקודה gcloud run worker-pools replace משתמשת בו כברירת מחדל.

Terraform

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

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
    }
    labels = {
      KEY : "VALUE"
    }
  }
}

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

• ‫WORKER_POOL: שם מאגר העובדים
• ‫REGION: Google Cloud האזור. לדוגמה: europe-west1
• ‫IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר שמכיל את מאגר העובדים, למשל us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• ‫KEY: השם של מפתח התווית
• ‫VALUE: הערך של המפתח

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

רשימת מאגרי עובדים לפי תווית

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

  gcloud run worker-pools list --filter metadata.labels.LABEL=VALUE
  

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

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

מחיקת תווית במאגר עובדים

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

המסוף

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

   כניסה ל-Cloud Run

2. מאתרים את מאגר העובדים ומסמנים את התיבה שמשמאל לשם שלו.

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

   

4. מאתרים את התווית שרוצים למחוק.

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

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

gcloud

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

gcloud run worker-pools update WORKER_POOL --clear-labels

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

gcloud run worker-pools update WORKER_POOL --remove-labels LABEL

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

• ‫WORKER_POOL: השם של מאגר העובדים ב-Cloud Run
• ‫LABEL: השם של התווית