בדף הזה מוסבר איך להגדיר את המספר המקסימלי של מכונות שאפשר להשתמש בהן בשירות Cloud Run, באמצעות התנהגות ברירת המחדל של התאמה אוטומטית לעומס (automatic scaling) ב-Cloud Run. כדי לשנות את קנה המידה של השירות באופן ידני, קראו את המאמר שינוי קנה מידה ידני.
כשמציינים את מספר המכונות המקסימלי ב-Cloud Run, אפשר להגביל את ההתאמה לעומס של השירות בתגובה לבקשות נכנסות, אבל יכול להיות שההגדרה המקסימלית הזו תחרוג לזמן קצר בגלל נסיבות כמו עליות חדות בתנועה.
אתם יכולים להשתמש בהגדרה הזו כדי לשלוט בעלויות או להגביל את מספר החיבורים לשירות תומך, כמו מסד נתונים.
למידע על המספר המקסימלי של מכונות שאפשר להגדיר לשירות, קראו את המאמר מגבלות על המספר המקסימלי של מכונות.
למידע נוסף על האופן שבו Cloud Run מבצע התאמה אוטומטית לעומס של מכונות קונטיינרים, קראו את המאמר התאמה אוטומטית לעומס של מכונות.
החלת מספר המופעים המקסימלי ברמת השירות לעומת רמת הגרסה
אפשר להגדיר את מספר המכונות המקסימלי ברמת השירות או ברמת הגרסה. Google ממליצה להשתמש במספר המקסימלי של מכונות ברמת השירות כדי להגביל את מספר המכונות של שירות, אלא אם יש לכם צורך ספציפי להגביל את המכונות ברמת הגרסה. כברירת מחדל, Cloud Run מגדיר 100 מכונות לכל גרסה. כדי לאפשר לשירות להתרחב ליותר מכונות, צריך לשנות את הערך הזה.
כשמחילים את המספר המקסימלי של מכונות, ההגדרות נכנסות לתוקף באופן הבא:
- רמת השירות: מיידית
- ברמת הגרסה: כשפורסים את הגרסה
גרסאות מתויגות ומספר המופעים המקסימלי ברמת השירות
גרסאות מתויגות מופעלות, אבל נספרות במספר המכונות המקסימלי ברמת השירות רק אם הן חלק מחלוקת התנועה.
שימוש במספר מינימלי או מקסימלי של מכונות ברמת השירות וברמת הגרסה
בטבלה הבאה מוצגת ההתנהגות אם משלבים מספר מקסימלי של מכונות ברמת השירות עם מספר מינימלי או מקסימלי של מכונות ברמת הגרסה:
| הגדרה ברמת השירות | הגדרה ברמת הגרסה | התנהגות |
|---|---|---|
| הגדרת מספר המכונות המקסימלי ברמת השירות | הגדרת מספר המופעים המקסימלי ברמת הגרסה | מגבלת המכונות המקסימלית בפועל היא הערך הנמוך יותר בין המכונות המקסימליות ברמת הגרסה לבין המכונות המקסימליות ברמת השירות. |
| הגדרת מספר המכונות המקסימלי ברמת השירות | הגדרת מספר מינימלי של מכונות ברמת הגרסה | אם המספר המקסימלי של המכונות ברמת השירות נמוך מהמספר המינימלי של המכונות ברמת הגרסה, הגרסה תפעיל מכונות עד למספר המקסימלי של המכונות ברמת השירות, ולא תגיע למספר המינימלי של המכונות ברמת הגרסה שהוגדר. |
שימוש במספר המקסימלי של מכונות ברמת השירות עם חלוקת תנועה
אם משתמשים בחלוקת התנועה, המספר המקסימלי של המכונות ברמת השירות מתחלק בין הגרסאות בהתאם ליחס של חלוקת התנועה. לדוגמה, אם המספר המקסימלי של מכונות ברמת השירות הוא 100, חלוקת תנועה של 50/50 מקצה 50 מכונות מקסימליות ברמת השירות לכל גרסה. בטבלה הבאה מוצג תרחיש הגדרה לדוגמה:
| הגדרה לדוגמה | ההתנהגות שמתקבלת |
|---|---|
הגדרת מספר המופעים המקסימלי ברמת השירות (תרחיש שבו אין הגדרות ברמת הגרסה): 100
|
חלק מהמספר המקסימלי של המכונות ברמת השירות מוקצה לכל גרסה. המספר המקסימלי של המופעים בפועל לכל גרסה קבוע על סמך חלוקת התנועה. מספר המכונות המקסימלי לגרסה א' הוא 10, לגרסה ב' הוא 10 ולגרסה ג' הוא 80. |
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות להגדרה ולפריסה של שירותי Cloud Run, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:
- מפתח ב-Cloud Run (
roles/run.developer) בשירות Cloud Run - משתמש בחשבון שירות (
roles/iam.serviceAccountUser) בזהות השירות
אם אתם פורסים שירות או פונקציה מקוד מקור, אתם צריכים גם תפקידים נוספים בפרויקט ובחשבון השירות של Cloud Build.
רשימה של תפקידים והרשאות ב-IAM שמשויכים ל-Cloud Run מופיעה במאמרים תפקידי IAM ב-Cloud Run והרשאות IAM ב-Cloud Run. אם שירות Cloud Run מתממשק עם ממשקי API שלCloud de Confiance , כמו ספריות הלקוח ב-Cloud, עיינו במדריך להגדרת זהות השירות. מידע נוסף על הקצאת תפקידים זמין במאמרים הרשאות פריסה וניהול הגישה.
הגדרת המספר המקסימלי של מכונות ברמת השירות
אפשר לשנות את ההגדרה של מספר המכונות המקסימלי באמצעות מסוף Cloud de Confiance , Google Cloud CLI, YAML או Terraform כשיוצרים שירות חדש או פורסים גרסה חדשה.
המסוף
נכנסים ל-Cloud Run במסוף Cloud de Confiance by S3NS :
בתפריט הניווט של Cloud Run, לוחצים על Services:
אם אתם מגדירים שירות חדש, לוחצים על Deploy container וממלאים את דף הגדרות השירות הראשוני.
אם אתם מגדירים שירות קיים, לוחצים על השירות ואז על הכרטיסייה Scaling.
בקטע Service scaling, מאתרים את השדה Maximum number of instances ומציינים את המספר המקסימלי הנדרש של מכונות קונטיינרים, באמצעות ערך של מספר שלם מ-
1ועד המגבלה המקסימלית האפשרית לשירות. כדי להסיר את המגבלה ברמת השירות, מוחקים את הערך שהגדרתם. הפעולה הזו מחזירה את ההגדרה לברירת המחדל שלה.כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.
gcloud
כדי לעדכן את המספר המקסימלי של המכונות בשירות מסוים, משתמשים בפקודה הבאה:
gcloud run services update SERVICE --max MAX-VALUE
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: שם השירות.
- MAX-VALUE: המספר המקסימלי הנדרש של מכונות קונטיינר, באמצעות כל ערך של מספר שלם מ-
1ועד המגבלה המקסימלית האפשרית לשירות. כדי להסיר את המגבלה ברמת השירות, מוחקים את הערך שהוגדר. הפעולה הזו מחזירה את ההגדרה לברירת המחדל שלה.
אפשר גם להגדיר את המספר המקסימלי של המכונות במהלך הפריסה באמצעות הפקודה הבאה:
gcloud run deploy --image IMAGE_URL --max MAX-VALUE
מחליפים את מה שכתוב בשדות הבאים:
-
IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. - MAX-VALUE: המספר המקסימלי הנדרש של מכונות קונטיינר, באמצעות כל ערך של מספר שלם מ-
1ועד המגבלה המקסימלית.
YAML
כל שינוי בהגדרות יוצר גרסה חדשה. גם גרסאות עתידיות יקבלו את הגדרת התצורה הזו באופן אוטומטי, אלא אם תבצעו עדכונים מפורשים כדי לשנות אותה.
אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:
gcloud run services describe SERVICE --format export > service.yaml
מעדכנים את המאפיין
run.googleapis.com/maxScale::apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE annotations: run.googleapis.com/maxScale: 'MAX-INSTANCE'
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של שירות Cloud Run
- MAX-INSTANCE: המספר המקסימלי הנדרש של מכונות קונטיינר, באמצעות כל ערך של מספר שלם מ-
1ועד המגבלה המקסימלית האפשרית לשירות. כדי להסיר את המגבלה ברמת השירות, מוחקים את הערך שהגדרתם. הפעולה הזו מחזירה את ההגדרה לברירת המחדל שלה.
יוצרים או מעדכנים את השירות באמצעות הפקודה הבאה:
gcloud run services replace service.yaml
כברירת מחדל, הפקודה
gcloud run services replaceמשתמשת בקובץservice.yamlאם הוא קיים.
Terraform
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
מוסיפים את הקוד הבא למשאבgoogle_cloud_run_v2_service בתצורה של Terraform:resource "google_cloud_run_v2_service" "default" {
name = "SERVICE"
location = "REGION"
scaling {
max_instance_count = MAX_INSTANCE
}
template {
containers {
image = "IMAGE_URL"
}
}
}
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של השירות ב-Cloud Run.
- REGION: האזור של Cloud de Confiance , לדוגמה
europe-west1. - MAX_INSTANCE: המספר המקסימלי הנדרש של מכונות קונטיינר, באמצעות כל ערך של מספר שלם מ-
1ועד המגבלה המקסימלית. -
IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL היא בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
הצגת המספר המקסימלי של מכונות ברמת השירות
כדי לראות את ההגדרות הנוכחיות של מספר המכונות המקסימלי ברמת השירות ב-Cloud Run:
המסוף
נכנסים לדף Services של Cloud Run במסוף Cloud de Confiance by S3NS :
לוחצים על השירות כדי לפתוח את החלונית Service details.
לוחצים על הכרטיסייה Scaling כדי לראות את ההגדרה הנוכחית.
gcloud
משתמשים בפקודה הבאה:
gcloud run services describe SERVICE
מאתרים את הערך של Scaling: Auto (Min: MIN_VALUE, Max: MAX_VALUE) בהגדרות שמוחזרות.
הגדרת המספר המקסימלי של מכונות ברמת הגרסה
כל שינוי בהגדרות יוצר גרסה חדשה. גם גרסאות עתידיות יקבלו את הגדרת התצורה הזו באופן אוטומטי, אלא אם תבצעו עדכונים מפורשים כדי לשנות אותה.
כברירת מחדל, הגרסאות של Cloud Run מוגדרות להתאמה לעומס (scaling) עד למקסימום של 100 מכונות.
אפשר לשנות את קנה המידה ברמת הגרסה רק בשירותים שבהם התכונה הוגדרה בעבר.
המסוף
נכנסים ל-Cloud Run במסוף Cloud de Confiance by S3NS :
בתפריט הניווט של Cloud Run, לוחצים על Services:
אם אתם מגדירים שירות חדש, לוחצים על Deploy container וממלאים את דף הגדרות השירות הראשוני. ואז לוחצים על Containers, Networking, Security כדי להרחיב את דף הגדרת השירות.
אם אתם מגדירים שירות קיים, לוחצים על השירות ואז על הכרטיסייה Scaling.
בקטע Revision scaling, מציינים את המספר המקסימלי של מכונות קונטיינר בשדה Maximum number of instances.
כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.
gcloud
כדי לעדכן את המספר המקסימלי של המכונות בשירות מסוים, משתמשים בפקודה הבאה:
gcloud run services update SERVICE --max-instances MAX-VALUE
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: שם השירות.
- MAX-VALUE: המספר המקסימלי הנדרש של מכונות קונטיינר, באמצעות כל ערך של מספר שלם מ-
1ועד המגבלה המקסימלית.
YAML
אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:
gcloud run services describe SERVICE --format export > service.yaml
מעדכנים את המאפיין
autoscaling.knative.dev/maxScale::apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: annotations: autoscaling.knative.dev/maxScale: 'MAX-INSTANCE' name: REVISION
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של שירות Cloud Run
- MAX-INSTANCE: המספר המקסימלי הנדרש של מכונות קונטיינר, באמצעות כל ערך של מספר שלם מ-
1ועד המגבלה המקסימלית. -
REVISION: שם גרסה חדש או מחיקה של השם (אם הוא קיים). אם אתם נותנים שם חדש לגרסה, הוא חייב לעמוד בקריטריונים הבאים:- מתחיל ב-
SERVICE- - מכיל רק אותיות קטנות, מספרים ו-
- - לא מסתיים ב-
- - לא חורג מ-63 תווים
- מתחיל ב-
יוצרים או מעדכנים את השירות באמצעות הפקודה הבאה:
gcloud run services replace service.yaml
כברירת מחדל, הפקודה
gcloud run services replaceמשתמשת בקובץservice.yamlאם הוא קיים.
הצגת ההגדרות של מספר המכונות המקסימלי ברמת הגרסה
אפשר לשנות את קנה המידה ברמת הגרסה רק בשירותים שבהם התכונה הוגדרה בעבר.
כדי לראות את ההגדרות הנוכחיות של מספר המכונות המקסימלי ברמת הגרסה של שירות Cloud Run:
המסוף
נכנסים לדף Services של Cloud Run במסוף Cloud de Confiance by S3NS :
לוחצים על השירות כדי לפתוח את החלונית Service details.
לוחצים על הכרטיסייה Scaling.
בקטע Revision scaling, בודקים את הערך של Maximum number of instances.
gcloud
משתמשים בפקודה הבאה:
gcloud run services describe SERVICE
מאתרים את הערך של Max instances: בהגדרות שמוחזרות.