הגדרת מגבלות זיכרון לשירותים

אתם יכולים לבחור את כמות הזיכרון שתוקצה לשירות Cloud Run. בדף הזה מוסבר איך לציין את כמות הזיכרון שזמינה לשירות.

הסבר על השימוש בזיכרון

מכונות של Cloud Run שחורגות ממגבלת הזיכרון המותרת נסגרות.

הזיכרון הזמין במכונה צריך להספיק בשביל:

  • הפעלת קובץ ההפעלה של השירות, כי צריך לטעון את קובץ ההפעלה לזיכרון
  • הקצאת זיכרון בתהליך השירות
  • כתיבת קבצים במערכת הקבצים

גודל קובץ האימג' של הקונטיינר שנפרס לא משפיע על הזיכרון שזמין למכונה.

הגדרה ועדכון של מגבלות הזיכרון

אפשר להגדיר מגבלות זיכרון בשירותי Cloud Run. כברירת מחדל, הזיכרון שמוקצה לכל מכונה של גרסה הוא ‎512MiB.

הזיכרון הנדרש כשמגדירים ערך למעבד (CPU)

כשמגדירים ערך למעבד (CPU), נדרש הזיכרון הבא:

מעבדים (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
אם אתם משתמשים בזיכרון של פחות מ-512MiB, כדאי להשתמש בסביבת ההפעלה מהדור הראשון.

כמות הזיכרון המקסימלית

כמות הזיכרון המקסימלית שאפשר להגדיר היא 32GiB‏ (32 Gi).

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

זיכרון מינימלי

הגדרת הזיכרון המינימלית משתנה בהתאם לשימוש בסביבת זמן ריצה של הדור הראשון או הדור השני:

  • ‫‎128MiB בדור הראשון
  • ‫512MiB בדור השני

שיקולי עלות

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

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

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

למידע נוסף, קראו את המאמר תמחור של Cloud Run או השתמשו במחשבון עלויות כדי להעריך את העלויות.

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

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

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

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

הגדרת מגבלות זיכרון

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

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

המסוף

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

    כניסה ל-Cloud Run

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

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

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

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

  4. בוחרים את גודל הזיכרון מהרשימה Memory.

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

gcloud

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

gcloud run services update SERVICE --memory SIZE

מחליפים את SERVICE בשם השירות ואת SIZE בגודל הזיכרון הרצוי. הפורמט של הגודל הוא מספר קבוע או מספר נקודה צפה (floating point) ואחריו יחידה: G או M שתואמים לג'יגה-בייט או למגה-בייט, בהתאמה, או שימוש במקבילות של חזקה של שתיים: Gi או Mi שתואמים לגיביבייט או למביבייט, בהתאמה.

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

gcloud run deploy --image IMAGE_URL --memory SIZE

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

  • ‫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.
  • ‫SIZE: הערכים שמתוארים למעלה.

YAML

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

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

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

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

    • ‫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.
    • ‫SIZE: גודל הזיכרון הנדרש. הפורמט הוא מספר עם נקודה קבועה או צפה, ואחריו יחידה: G או M שתואמים לג'יגה-בייט או למגה-בייט, בהתאמה, או שימוש במקבילות של חזקה של שתיים: Gi או Mi שתואמים לגיביבייט או למביבייט, בהתאמה.
    • ‫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-memory-limits"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

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

      resources {
        limits = {
          # Memory usage limit (per container)
          memory = "512Mi"
        }
      }
    }
  }
}

בקטע template.containers.resources.limits, מחליפים את 512Mi במגבלת הזיכרון הנדרשת לשירות.

פיתוח נייטיב

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

  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 .

אופטימיזציה של הזיכרון לשירותים

בשירות של Cloud Run, אפשר לקבוע את דרישת הזיכרון המקסימלית לשירות באמצעות הנוסחה הבאה: (זיכרון קבוע) + (זיכרון לכל בקשה) * (בקשות בו-זמניות לשירות)

לכן,

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

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

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

הצגת ההגדרות של מגבלת הזיכרון

כדי לראות את ההגדרות הנוכחיות של מגבלת הזיכרון בשירות Cloud Run:

המסוף

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

    כניסה ל-Cloud Run

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

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

gcloud

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

    gcloud run services describe SERVICE
  2. מאתרים את ההגדרה של מגבלת הזיכרון בהגדרות שהוחזרו.