התאמה ידנית לעומס מאפשרת להגדיר מספר ספציפי של מכונות בלי צורך בפריסה מחדש. כדאי להשתמש בהתאמה ידנית לעומס כשהעומס שלכם דורש מספר קבוע של מכונות, או כשאתם רוצים לשלוט במספר המכונות מהמערכת שלכם.
כדי לשנות את קנה המידה של המכונות באופן אוטומטי על סמך ניצול המעבד (CPU) במקום להגדיר מספר קבוע של מכונות, קראו את המאמר הגדרת התאמה אוטומטית לעומס (autoscaling) של המעבד (CPU) במאגרי ה-worker.
שיקולי חיוב כשמשתמשים בהתאמה ידנית לעומס (scaling)
כשמשתמשים בהתאמה ידנית לעומס, כל המכונות שביקשתם מחויבות כמכונות פעילות, גם אם הן במצב של חוסר פעילות. פרטי החיוב המלאים מופיעים בדף התמחור.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות להגדרה ולפריסה של מאגרי Worker ב-Cloud Run, אתם צריכים לבקש מהאדמין לתת לכם את התפקידים הבאים ב-IAM:
- מפתח ב-Cloud Run (
roles/run.developer) במאגר ה-workers של Cloud Run - משתמש בחשבון שירות (
roles/iam.serviceAccountUser) בזהות השירות
רשימה של תפקידים והרשאות ב-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:
המסוף
נכנסים ל-Cloud Run במסוף Google Cloud :
אם אתם מגדירים מאגר וורקרים חדש, בוחרים באפשרות Worker pools בתפריט ולוחצים על Deploy container. אם אתם מגדירים מאגר קיים של עובדים, לוחצים על מאגר העובדים כדי להציג את חלונית הפרטים שלו, ואז לוחצים על סמל העט לצד Scaling בפינה הימנית העליונה של חלונית הפרטים.
מאתרים את הטופס Scaling (למאגר עובדים חדש) או את הטופס Edit scaling (למאגר עובדים קיים).
בשדה Number of instances, מציינים את מספר המכונות של מאגר ה-Workers.
מסיימים את המפרט.
לוחצים על 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
אם אתם יוצרים מאגר חדש של Worker, דלגו על השלב הזה. אם אתם מעדכנים מאגר קיים של Worker, הורידו את הגדרת ה-YAML שלו:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
מגדירים את
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.
יוצרים או מעדכנים את מאגר ה-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
נכנסים ל-Cloud Run במסוף Google Cloud :
לוחצים על Worker pools כדי להציג את רשימת מאגרי ה-Workers שנפרסו.
לוחצים על מאגר ה-Workers שרוצים לבדוק כדי להציג את חלונית הפרטים שלו.
הגדרת ההתאמה לעומס הנוכחית מוצגת מעל רשימת הגרסאות של מאגרי ה-Workers: Scaling: Manual (Instances: ).
השבתה של מאגר עובדים
כדי להשבית מאגר של מכונות עובדים, מריצים את הפקודה הבאה עם הדגל --scaling=0:
gcloud beta run worker-pools update WORKER_POOL --scaling=0
מחליפים את WORKER_POOL בשם של מאגר ה-Workers.