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

ב-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, עיינו במדריך להגדרת זהות השירות. מידע נוסף על הקצאת תפקידים זמין במאמרים הרשאות פריסה וניהול הגישה.

יצירת מאגר של Worker

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

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

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

console

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

   כניסה ל-Cloud Run

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

gcloud

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

gcloud run worker-pools list

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

ספריות לקוח

כדי להציג רשימה של מאגרי 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: Google Cloud האזור של מאגרי העובדים.

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

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

console

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

   כניסה ל-Cloud Run

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

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 ב Google Cloud אזור של מאגר ה-workers.

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

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

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

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 בשם של מאגר העובדים.

YAML

1. אם אתם יוצרים מאגר עובדים חדש, דלגו על השלב הזה. אם אתם מעדכנים מאגר קיים של Worker, הורידו את הגדרת ה-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. יוצרים או מעדכנים את מאגר העובדים באמצעות הפקודה הבאה:

   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

כדי להשבית מאגר עובדים, שולחים בקשת 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: השם של מאגר ה-workers.

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

כשמוחקים מאגר של 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 ב Google Cloud אזור של מאגר ה-workers.

ספריות לקוח

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

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