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

גרסת טרום-השקה — Cloud Run worker pools

השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

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

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

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

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

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

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

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

כדי לקבל את ההרשאות שדרושות להגדרה ולפריסה של מאגרי עובדים ב-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 beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE

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

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

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

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

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

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

YAML

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

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

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

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

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

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

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

   gcloud beta run worker-pools replace workerpool.yaml

Terraform

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

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

  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: הערך של המפתח

הצגת רשימת השירותים לפי תווית

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

  gcloud beta 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 beta run worker-pools update WORKER_POOL --clear-labels

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

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

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

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