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

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

כדי לשנות את קנה המידה של המכונות באופן אוטומטי על סמך ניצול המעבד (CPU) במקום להגדיר מספר קבוע של מכונות, קראו את המאמר הגדרת התאמה אוטומטית לעומס (autoscaling) של המעבד (CPU) במאגרי ה-worker.

שיקולי חיוב כשמשתמשים בהתאמה ידנית לעומס (scaling)

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

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

כדי לקבל את ההרשאות שדרושות להגדרה ולפריסה של מאגרי Worker ב-Cloud Run, אתם צריכים לבקש מהאדמין לתת לכם את התפקידים הבאים ב-IAM:

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

הגדרת קנה מידה

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

כדי להגדיר את מצב ההתאמה לעומס, משתמשים במסוף Google Cloud , ב-Google Cloud CLI, ב-YAML, ב-Terraform או ב-API בארכיטקטורת REST:

המסוף

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

    כניסה ל-Cloud Run

  2. אם אתם מגדירים מאגר וורקרים חדש, בוחרים באפשרות Worker pools בתפריט ולוחצים על Deploy container. אם אתם מגדירים מאגר קיים של עובדים, לוחצים על מאגר העובדים כדי להציג את חלונית הפרטים שלו, ואז לוחצים על סמל העט לצד Scaling בפינה הימנית העליונה של חלונית הפרטים.

  3. מאתרים את הטופס Scaling (למאגר עובדים חדש) או את הטופס Edit scaling (למאגר עובדים קיים).

    תמונה

  4. בשדה Number of instances, מציינים את מספר המכונות של מאגר ה-Workers.

  5. מסיימים את המפרט.

  6. לוחצים על Create כדי ליצור מאגר חדש של Worker, או על Save כדי לשמור מאגר קיים.

gcloud

  • כדי להגדיר התאמה ידנית של קבוצת עובדים חדשה, מריצים את הפקודה הבאה עם הדגל --scaling:
gcloud beta run worker-pools deploy WORKER_POOL \
    --scaling=INSTANCE_COUNT \
    --image IMAGE_URL

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

  • ‫WORKER_POOL: השם של מאגר ה-workers.
  • ‫INSTANCE_COUNT: מספר המכונות של מאגר ה-workers. כך מגדירים את מאגר העובדים להתאמה ידנית לעומס. כדי להשבית את מאגר ה-workers, מציינים את הערך 0.
  • ‫IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר שמכיל את מאגר ה-Workers, למשל us-docker.pkg.dev/cloudrun/container/worker-pool:latest.

  • כדי להגדיר התאמה ידנית לעומס במאגר קיים של מכונות, מריצים את הפקודה הבאה עם הדגל --scaling:

gcloud beta run worker-pools update WORKER_POOL \
    --scaling=INSTANCE_COUNT

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

  • ‫WORKER_POOL: השם של מאגר ה-workers.
  • ‫INSTANCE_COUNT: מספר המכונות של מאגר ה-workers.

YAML

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

    gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
  2. מגדירים את scalingMode בתור manual ומציינים את manualInstanceCount:

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

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

    • ‫WORKER_POOL: השם של מאגר ה-workers ב-Cloud Run.
    • ‫INSTANCE_COUNT: מספר המכונות שאתם משנים את קנה המידה שלהן באופן ידני במאגר ה-workers. כדי להשבית את מאגר ה-workers, מציינים את הערך 0.
  3. יוצרים או מעדכנים את מאגר ה-workers באמצעות הפקודה הבאה:

    gcloud run worker-pools replace worker-pool.yaml

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

Terraform

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

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

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  scaling {
    scaling_mode = "MANUAL"
    manual_instance_count = "INSTANCE_COUNT"
  }
}

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

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

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

כדי לעדכן את מספר המכונות של מאגר Worker מסוים, שולחים בקשת HTTP מסוג PATCH לנקודת הקצה workerPools.patch ב-Cloud Run Admin API:

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

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

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

הצגת הגדרות ההתאמה לעומס של מאגר ה-workers

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

    כניסה ל-Cloud Run

  2. לוחצים על Worker pools כדי להציג את רשימת מאגרי ה-Workers שנפרסו.

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

  4. הגדרת ההתאמה לעומס הנוכחית מוצגת מעל רשימת הגרסאות של מאגרי ה-Workers: Scaling: Manual (Instances: )‎.

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

כדי להשבית מאגר של מכונות עובדים, מריצים את הפקודה הבאה עם הדגל --scaling=0:

gcloud beta run worker-pools update WORKER_POOL --scaling=0

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

המאמרים הבאים