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

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

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

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

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

יצירת מאגר של וורקרים

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

הצגת רשימת מאגרי ה-Workers בפרויקט

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

console

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

   כניסה ל-Cloud Run

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

gcloud

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

gcloud run worker-pools list

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

ספריות לקוח

כדי להציג רשימה של מאגרי Worker מהקוד:

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

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

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

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

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

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

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

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

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

console

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

   כניסה ל-Cloud Run

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

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

gcloud

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

gcloud run worker-pools describe WORKER_POOL

מחליפים את WORKER_POOL בשם של מאגר ה-Workers.

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

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

מחליפים את:

• ‫WORKER_POOL בשם של מאגר ה-workers.
• ‫REGION באזור של מאגר ה-workers,‏ 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

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

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

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

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

console

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

   כניסה ל-Cloud Run

2. בתפריט, בוחרים באפשרות Worker pools, וברשימת מאגרי ה-workers לוחצים על מאגר ה-workers שרוצים להשבית.

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

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

gcloud

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

מחליפים את WORKER_POOL בשם של מאגר ה-Workers.

YAML

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

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

2. כדי להשבית את מאגר ה-workers, מגדירים את הערך של scale ל-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: השם של מאגר ה-workers ב-Cloud Run.

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

   gcloud run worker-pools replace worker-pool.yaml

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

ספריות לקוח

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

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

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

כדי להשבית מאגר של Worker, שולחים בקשת HTTP מסוג PATCH ל נקודת הקצה (endpoint) של 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 האזור של מאגר ה-Workers.
• ‫WORKER_POOL: השם של מאגר ה-Workers.

מחיקת מאגרי וורקרים קיימים

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

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

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

console

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

   כניסה ל-Cloud Run

2. בתפריט, בוחרים באפשרות Worker pools וברשימת מאגרי ה-workers בוחרים את המאגר שרוצים למחוק.

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

gcloud

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

gcloud run worker-pools delete WORKER_POOL --region REGION

מחליפים את:

• WORKER_POOL בשם של מאגר ה-workers.
• ‫REGION באזור של מאגר ה-workers,‏ Google Cloud .

ספריות לקוח

כדי למחוק מאגר של קוד:

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

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

כדי למחוק מאגר של Worker, שולחים בקשת HTTP מסוג DELETE ל נקודת הקצה (endpoint) של 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 למחיקת מאגר של Worker. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מכונה של קונטיינר ב-Cloud Run, אתם יכולים לאחזר אסימון גישה באמצעות שרת המטא-נתונים של המכונה של הקונטיינר.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫REGION: Google Cloud האזור של מאגר ה-Workers.
• ‫WORKER_POOL: השם של מאגר ה-Workers.