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

בדף הזה מוסבר איך לצפות במידע על מאגר עובדים ולמחוק מאגרי עובדים.

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

כדי לקבל את ההרשאות שנדרשות לניהול מאגרי עובדים של Cloud Run ועדכונים של מאגרי עובדים, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Cloud Run Developer (roles/run.developer) במאגר העובדים של Cloud Run.

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

יצירת מאגר עובדים

בפעם הראשונה שפורסים קובץ אימג' של קונטיינר, Cloud Run יוצר מאגר חדש של עובדים. הוראות נוספות זמינות במאמר בנושא פריסת מאגר חדש של עובדים.

הצגת רשימת מאגרי העובדים בפרויקט

כדי לראות רשימה של מאגרי העובדים שזמינים בפרויקט, משתמשים במסוף או ב-Google Cloud CLI: Google Cloud

console

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

   כניסה ל-Cloud Run

2. בתפריט, בוחרים באפשרות Worker pools (מאגרי עובדים). מאגרי העובדים הזמינים מפורטים בדף.

gcloud

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

gcloud run worker-pools list

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

ספריות לקוח

כדי להציג רשימה של מאגרי עובדים מקוד:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

‫API בארכיטקטורת REST

כדי לראות את רשימת מאגרי העובדים בפרויקט, שולחים בקשת HTTP לנקודת הקצה workerPool של Cloud Run Admin API.GET

לדוגמה, באמצעות curl:

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X GET \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools

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

• ‫ACCESS_TOKEN: אסימון גישה תקין לחשבון שיש לו הרשאות IAM לצפייה במאגרי עובדים. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫REGION: Google Cloud האזור של מאגרי העובדים.

הצגת פרטים נוספים על מאגר עובדים

כדי לראות פרטים נוספים על מאגר עובדים, אפשר להשתמש במסוף Google Cloud , ב-Google Cloud CLI או ב-YAML:

console

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

   כניסה ל-Cloud Run

2. בתפריט, בוחרים באפשרות Worker pools (מאגרי עובדים) כדי להציג את מאגרי העובדים הזמינים.

3. לוחצים על מאגר העובדים כדי להציג את חלונית הפרטים שלו.

gcloud

כדי לראות פרטים על מאגר עובדים:

‫

gcloud run worker-pools describe WORKER_POOL

מחליפים את WORKER_POOL בשם של מאגר העובדים.

אפשר להשתמש ב--format flag כדי לעצב את הפלט. לדוגמה, כדי לעצב את הפלט כ-YAML:

gcloud run worker-pools describe WORKER_POOL
    --region REGION
    --format yaml

מחליפים את:

• WORKER_POOL בשם של מאגר העובדים.
• ‫REGION עם Google Cloud האזור של מאגר העובדים.

YAML

כדי לראות את הפרטים של מאגר עובדים, מורידים את הגדרות ה-YAML שלו:

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

ספריות לקוח

כדי לראות פרטים על מאגר עובדים מקוד:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

‫API בארכיטקטורת REST

כדי לראות פרטים על מאגר עובדים, שולחים בקשת HTTP‏ GET לנקודת הקצה workerPool של Cloud Run Admin API.

לדוגמה, באמצעות curl:

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X GET \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL

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

• ‫ACCESS_TOKEN: אסימון גישה תקין לחשבון שיש לו הרשאות IAM לצפייה בפרטים של מאגר העובדים. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫REGION: Google Cloud האזור של מאגר העובדים.
• ‫WORKER_POOL: השם של מאגר העובדים.

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

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

console

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

   כניסה ל-Cloud Run

2. בתפריט, בוחרים באפשרות Worker pools (מאגרי עובדים), ואז ברשימת מאגרי העובדים לוחצים על מאגר העובדים שרוצים להשבית.

3. לוחצים על סמל העט משמאל לScaling: Manual (Instances: ) ומשנים את הערך ל-0.

4. לוחצים על Save כדי לעדכן ולהשבית את מאגר העובדים.

gcloud

gcloud run worker-pools update WORKER_POOL --instances=0

מחליפים את WORKER_POOL בשם של מאגר העובדים.

YAML

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

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

2. כדי להשבית את מאגר העובדים, מגדירים את קנה המידה לערך 0. בדוגמה הבאה מופיעה הגדרת ה-YAML:

   apiVersion: run.googleapis.com/v1
   kind: WorkerPool
   metadata:
     name: WORKER_POOL
     annotations:
       run.googleapis.com/scalingMode: manual
       run.googleapis.com/manualInstanceCount: `0`

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

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

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

   gcloud run worker-pools replace worker-pool.yaml

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

ספריות לקוח

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

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

‫API בארכיטקטורת REST

כדי להשבית מאגר עובדים, שולחים בקשת HTTP‏ PATCH לנקודת הקצה workerPool של Cloud Run Admin API.

לדוגמה, באמצעות curl:

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -H "Content-Type: application/json" \
   -X PATCH \
   -d '{"scaling":{"manualInstanceCount":0}}' \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.manualInstanceCount

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

• ‫ACCESS_TOKEN: אסימון גישה תקין לחשבון שיש לו הרשאות IAM להשבתת מאגר עובדים. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫REGION: Google Cloud האזור של מאגר העובדים.
• ‫WORKER_POOL: השם של מאגר העובדים.

מחיקה של מאגרי עובדים קיימים

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

• כשמוחקים מאגר עובדים, כל המשאבים שקשורים למאגר העובדים הזה נמחקים, כולל כל הגרסאות של מאגר העובדים הזה, בין אם הן מעבדות עומסי עבודה ובין אם לא.
• מחיקה של מאגר עובדים לא מסירה אוטומטית תמונות של קונטיינרים מ-Artifact Registry. כדי למחוק מ-Artifact Registry תמונות של קונטיינרים שבהן נעשה שימוש בגרסאות שנמחקו, אפשר לעיין במאמר בנושא מחיקת תמונות.
• אחרי שמוחקים מאגר עובדים, הוא ממשיך להופיע ב-Google Cloud CLI עד שהמחיקה מסתיימת. עם זאת, אי אפשר לעדכן את מאגר העובדים.

• מחיקה של מאגר עובדים היא פעולה בלתי הפיכה. אי אפשר לבטל את הפעולה או לשחזר את החשבון.

console

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

   כניסה ל-Cloud Run

2. בתפריט, בוחרים באפשרות Worker pools (מאגרי עובדים), ואז בוחרים את מאגר העובדים שרוצים למחוק מתוך רשימת מאגרי העובדים.

3. לוחצים על Delete.

gcloud

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

gcloud run worker-pools delete WORKER_POOL --region REGION

מחליפים את:

• WORKER_POOL בשם של מאגר העובדים.
• ‫REGION עם Google Cloud האזור של מאגר העובדים.

ספריות לקוח

כדי למחוק מאגר עובדים מקוד:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

‫API בארכיטקטורת REST

כדי למחוק מאגר עובדים, שולחים בקשת HTTP‏ DELETE לנקודת הקצה של Cloud Run Admin API‏ workerPool.

לדוגמה, באמצעות curl:

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X DELETE \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL

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

• ‫ACCESS_TOKEN: אסימון גישה תקין לחשבון שיש לו הרשאות IAM למחיקת מאגר עובדים. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫REGION: Google Cloud האזור של מאגר העובדים.
• ‫WORKER_POOL: השם של מאגר העובדים.