הגדרת מגבלות על יחידת עיבוד מרכזית (CPU) לשירותים

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

הגדרה ועדכון של מגבלות ה-vCPU

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

טבלת vCPU וזיכרון

אלה דרישות הזיכרון ל-vCPU:

מעבדים (CPU) נדרש זיכרון
‫0.08 vCPU עד ‎512 MiB
‫0.5 vCPU עד 1GiB
‫1 vCPU עד 4GiB
‫2 מעבדים וירטואליים עד 8GiB
‫4 מעבדים וירטואליים (vCPU) ‫2 עד 16GiB
6 vCPU ‫4 עד 24GiB
‫8 מעבדי vCPU ‫4 עד 32GiB

ערכים שגדולים מ-1 חייבים להיות מספרים שלמים.

הכמות המקסימלית של vCPU

המספר המקסימלי של מעבדי vCPU שאפשר להגדיר הוא 8.

הכמות המינימלית של vCPU

ההגדרה המינימלית של vCPU היא 0.08‎ vCPU.

אם רוצים להשתמש בפחות מ-vCPU אחד, אפשר לבחור כל ערך בין 0.08 ל-1, במרווחים של 0.001.

אם אתם משתמשים בפחות מ-vCPU אחד, הדרישות הבאות נאכפות:

הגדרה דרישה
זיכרון כדי להגדיר מגבלת זיכרון של יותר מ-512MiB, צריך לפחות 0.5 vCPU.
כדי להגדיר מגבלת זיכרון של יותר מ-1GiB, צריך לפחות מעבד וירטואלי אחד.
בו-זמניות צריך להגדיר את הערך של Maximum concurrency ל-1.
חיוב הגדרות החיוב צריכות להיות מוגדרות לחיוב לפי בקשות.
סביבת הפעלה צריך להשתמש בסביבת ההפעלה מהדור הראשון.

שיקולי עלות

העלות של משאב Cloud Run מושפעת מהגדרות המעבד (CPU) שלו, ממשך הזמן שבו המשאב פעיל ומגורמים נוספים. הקצאת יתר של משאבים יכולה להגדיל את העלויות. כדי לקבוע איזו הגדרת מעבד הכי מתאימה למשאב:

  1. הגדירו מגבלת מעבד (CPU) ראשונית שמאזנת בין ניצול המעבד לבין העלויות.
  2. בזמן בדיקת המערכת בעומס, עוקבים אחרי מדדי ניצול המעבד (CPU) ב-Cloud Monitoring.
  3. משנים את הגדרות המעבד (CPU) לפי הצורך.

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

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

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

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

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

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

הגדרת מגבלות על המעבד (CPU)

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

אפשר להגדיר מגבלות מעבד (CPU) באמצעות מסוף Google Cloud , שורת הפקודה של gcloud או קובץ YAML כשיוצרים שירות חדש או פורסים גרסה חדשה:

המסוף

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

    כניסה ל-Cloud Run

  2. בתפריט הניווט של Cloud Run, לוחצים על Services:

    1. אם אתם מגדירים שירות חדש, לוחצים על Deploy container וממלאים את דף הגדרות השירות הראשוני. ואז לוחצים על Containers, Networking, Security כדי להרחיב את דף הגדרת השירות.

    2. אם אתם מגדירים שירות קיים, לוחצים על השירות.

  3. לוחצים על הכרטיסייה מאגרי תגים.

  4. בוחרים את מגבלת המעבד (CPU) מהרשימה. בוחרים ערך של 1,‏ 2,‏ 4,‏ 6 או 8 מעבדים, או לפחות ממעבד אחד, מציינים ערך מ-0.08 עד פחות מ-1.00, במרווחים של 0.01. (בטבלה שבקטע הגדרה ועדכון של מגבלות המעבד (CPU) מפורטות ההגדרות הנדרשות).

  5. כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.

gcloud

כדי לעדכן את מגבלות המעבד (CPU) בשירות מסוים, משתמשים בפקודה הבאה:

gcloud run services update SERVICE --cpu CPU

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

  • ‫SERVICE: שם השירות.
  • ‫CPU: מגבלת המעבד (CPU) הרצויה. מציינים את הערך 1,‏ 2,‏ 4,‏ 6 או 8 מעבדים, או לפחות ממעבד אחד, מציינים ערך מ-0.08 עד פחות מ-1.00, במרווחים של 0.01. (בטבלה שבקטע הגדרה ועדכון של מגבלות המעבד (CPU) מפורטות ההגדרות הנדרשות).

אפשר גם להגדיר את המעבד (CPU) במהלך הפריסה באמצעות הפקודה:

gcloud run deploy --image IMAGE_URL --cpu CPU

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

  • ‫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.
  • ‫CPU: הערך 1,‏ 2,‏ 4,‏ 6 או 8 מעבדים (CPU). אם רוצים פחות ממעבד אחד, מציינים ערך מ-0.08 עד פחות מ-1.00, במרווחים של 0.01. (ההגדרות הנדרשות מפורטות בטבלה שבקטע הגדרה ועדכון של מגבלות המעבד (CPU)).

YAML

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

    gcloud run services describe SERVICE --format export > service.yaml
  2. מעדכנים את המאפיין cpu:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          name: REVISION
        spec:
          containers:
          - image: IMAGE
            resources:
              limits:
                cpu: CPU

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

    • ‫SERVICE: השם של שירות Cloud Run.
    • ‫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.
    • ‫CPU: הערך הרצוי של מגבלת המעבד (CPU). מציינים את הערך 1,‏ 2,‏ 4,‏ 6 או 8 מעבדים, או לפחות ממעבד אחד, מציינים ערך מ-0.08 עד פחות מ-1.00, במרווחים של 0.01. (ההגדרות הנדרשות מפורטות בטבלה שבקטע הגדרה ועדכון של מגבלות המעבד (CPU)).
    • ‫REVISION: שם גרסה חדש או מחיקה של השם (אם הוא קיים). אם אתם נותנים שם חדש לגרסה, הוא חייב לעמוד בקריטריונים הבאים:
      • מתחיל ב-SERVICE-
      • מכיל רק אותיות קטנות, מספרים ו--
      • לא מסתיים ב--
      • לא חורג מ-63 תווים
  3. יוצרים או מעדכנים את השירות באמצעות הפקודה הבאה:

    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     = "cloudrun-service-cpu"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      resources {
        limits = {
          # CPU usage limit
          cpu = "1"
        }
      }
    }
  }
}

המשאב google_cloud_run_v2_service שלמעלה מציין מגבלת מעבד (CPU) בקטע template.containers.resources.limits.

מחליפים את 1 במספר המעבדים הרצוי. טיפ: 1 תואם ל-vCPU אחד.

הגדרת האצת המעבד בזמן אתחול

התכונה האצת המעבד בזמן אתחול לגרסאות מספקת מעבד נוסף במהלך זמן האתחול של המכונה ולמשך 10 שניות אחרי שהמכונה הופעלה.

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

מגבלת מעבד (CPU) מעבד (CPU) מוגבר
0-1 2
2 4
4 8
6 8
8 8

החיוב מתבצע על ה-CPU המוגבר שהוקצה למשך זמן ההפעלה של הקונטיינר. לדוגמה, אם זמן ההפעלה של הקונטיינר הוא 15 שניות, ואתם מקצים 2 מעבדים, עם האצת המעבד בזמן אתחול תחויבו על 4 מעבדים במהלך זמן ההפעלה של המכונה (שעשוי להיות קצר יותר), כולל 10 השניות אחרי שהקונטיינר סיים את ההפעלה, ועל 2 מעבדים במהלך שאר מחזור החיים של הקונטיינר.

אם בפריסה של Cloud Run משתמשים ב-sidecars ומפעילים את האצת המעבד בזמן אתחול, כל הקונטיינרים מקבלים את האצת המעבד. ב-Cloud Run, כמות המעבדים (CPU) שמוגברת לכל קונטיינר נקבעת לפי מגבלת המעבדים.

אפשר להפעיל או להשבית את האצת המעבד בזמן אתחול באמצעות Google Cloud המסוף, Google Cloud CLI, קובץ YAML או קובץ Terraform.

המסוף

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

    כניסה ל-Cloud Run

  2. בתפריט הניווט של Cloud Run, לוחצים על Services:

    1. אם אתם מגדירים שירות חדש, לוחצים על Deploy container וממלאים את דף הגדרות השירות הראשוני. ואז לוחצים על Containers, Networking, Security כדי להרחיב את דף הגדרת השירות.

    2. אם אתם מגדירים שירות קיים, לוחצים על השירות.

  3. לוחצים על הכרטיסייה מאגרי תגים.

  4. כדי להפעיל את האצת המעבד בזמן אתחול, מסמנים את התיבה Startup CPU boost. כדי להשבית את התכונה הזו, מבטלים את הסימון בתיבה.

  5. כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.

gcloud

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

    gcloud run services update SERVICE --cpu-boost

    מחליפים את SERVICE בשם השירות.

    כדי להפעיל את האצת המעבד בזמן אתחול במהלך הפריסה, משתמשים בפקודה:

    gcloud run deploy --image IMAGE_URL --cpu-boost

    מחליפים את 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.

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

    gcloud run services update SERVICE --no-cpu-boost

    מחליפים את SERVICE בשם השירות.

    כדי להשבית את האצת המעבד בזמן אתחול במהלך הפריסה, משתמשים בפקודה:

    gcloud run deploy --image IMAGE_URL --no-cpu-boost

YAML

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

    gcloud run services describe SERVICE --format export > service.yaml
  2. מעדכנים את המאפיין run.googleapis.com/startup-cpu-boost על ידי ציון הערך 'true' כדי להפעיל את האצת המעבד בזמן אתחול, או הערך 'false' כדי להשבית אותה:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          annotations:
            run.googleapis.com/startup-cpu-boost: 'true'

    מחליפים את SERVICE בשם של שירות Cloud Run.

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

    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"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      resources {
        startup_cpu_boost = CPU_BOOST
      }
    }
  }
}

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

  • ‫SERVICE: השם של שירות Cloud Run.
  • ‫REGION: האזור של Google Cloud , לדוגמה europe-west1.
  • ‫CPU_BOOST: הערך true כדי להפעיל את האצת המעבד בזמן אתחול, או הערך false כדי להשבית אותה.

פיתוח נייטיב

כדי לציין מגבלות מעבד (CPU) בקובץ compose.yaml, מוסיפים את המאפיין cpus להגדרת השירות.

  services:
    web:
      image: IMAGE
      cpus: CPU_VALUE

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

  • ‫IMAGE: כתובת ה-URL של קובץ האימג' של הקונטיינר.
  • ‫CPU_VALUE: מגבלת ה-CPU הנדרשת, לדוגמה 2.

פריסת השירותים

  1. כדי לפרוס את השירותים, מריצים את הפקודה gcloud run compose up:

    gcloud run compose up compose.yaml
  2. משיבים y לכל ההנחיות להתקנת הרכיבים הנדרשים או להפעלת ממשקי ה-API.

  3. אופציונלי: הפיכת השירות לציבורי אם רוצים לאפשר גישה לשירות ללא אימות.

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

הצגת הגדרות המעבד (CPU)

כדי לראות את הגדרות המעבד (CPU) הנוכחיות של שירות Cloud Run:

המסוף

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

    כניסה ל-Cloud Run

  2. לוחצים על השירות הרצוי כדי לפתוח את הדף Service details.

  3. לוחצים על הכרטיסייה מאגרי תגים כדי לראות את ההגדרות.

gcloud

  1. משתמשים בפקודה הבאה:

    gcloud run services describe SERVICE
  2. מאתרים את הגדרת המעבד (CPU) בהגדרות שהוחזרו.

הקצאת הליכי משנה (threads) באפליקציה וניצול המעבד (CPU)

כשבוחרים מגבלת מעבד (CPU) שגדולה מ-vCPU אחד, צריך להביא בחשבון את מודל ה-threading של האפליקציה. בזמן התאמה אוטומטית לעומס, Cloud Run משתמש בניצול הממוצע של המעבד (CPU) בכל המעבדים שהוקצו. אם האפליקציה שלכם היא עם שרשור יחיד, יכול להיות שהיא תנצל באופן מלא רק ליבה אחת, מה שיוביל לניצול ממוצע נמוך של המעבד (CPU) גם תחת עומס. זה יכול למנוע את ההתאמה האוטומטית לעומס (automatic scaling) שמבוססת על המעבד (CPU) לפעול כמו שצריך.

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