הגדרת זמן קצוב לתפוגת בקשה

במאמר הזה מוסבר איך מגדירים את הזמן שבו שירותי Knative צריכים להחזיר תשובה לבקשה. אם לא מתקבלת תשובה בתוך הזמן שצוין, הבקשה מסתיימת ומוחזרת שגיאה 504.

מגבלות זמן קצוב

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

גרסת GKE הגבלה שמוגדרת כברירת מחדל מגבלת הזמן הקצוב לתפוגה
‫0.16.0-gke.1 ואילך ‫300 שניות 24 שעות
‫0.15.0-gke.3 ומגרסאות קודמות ‫300 שניות ‫900 שניות

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

הגדרה ועדכון של זמן קצוב לתפוגה של בקשה

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

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

המסוף

  1. נכנסים אל Knative serving במסוף Google Cloud :

    מעבר אל Knative serving

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

  3. בקטע הגדרות מתקדמות, לוחצים על מאגר תגים.

  4. בשדה Request timeout, מזינים את ערך הזמן הקצוב לתפוגה שרוצים להשתמש בו. הערך שאתם מציינים צריך להיות קטן ממגבלת הזמן הקצוב לתפוגה של גרסת ה-GKE של האשכול.

  5. לוחצים על הבא כדי להמשיך לקטע הבא.

  6. בקטע Configure how this service is triggered (הגדרה של אופן הפעלת השירות), בוחרים את סוג הקישוריות שרוצים להשתמש בו כדי להפעיל את השירות.

  7. לוחצים על יצירה כדי לפרוס את התמונה ב-Knative serving ומחכים עד שהפריסה תסתיים.

שורת הפקודה

  • בשירותים קיימים, כדי להגדיר את הזמן הקצוב לתפוגה של הבקשה, מריצים את הפקודה gcloud run services update עם הפרמטר --timeout:

    gcloud run services update SERVICE --timeout TIMEOUT

    מחליפים את:

  • בשירותים חדשים, מגדירים את הזמן הקצוב לתפוגה של הבקשה באמצעות הפקודה gcloud run deploy עם הפרמטר --timeout:

    gcloud run deploy SERVICE --image=IMAGE_URL --timeout TIMEOUT

    מחליפים את:

    • SERVICE בשם של השירות.
    • ‫IMAGE_URL עם הפניה לקובץ אימג' של קונטיינר, לדוגמה, gcr.io/cloudrun/hello.
    • ‫TIMEOUT עם הזמן הרצוי, באמצעות ערך מסוג מספר שלם בשניות, או ערך משך מוחלט, לדוגמה 1m20s ששווה לדקה ו-20 שניות. הערך שאתם מציינים חייב להיות קטן ממגבלת הזמן הקצוב לתפוגה של גרסת ה-GKE של האשכול. מציינים 0 כדי להגדיר את הזמן הקצוב לתפוגה לערך ברירת המחדל.

YAML

אפשר להוריד את ההגדרה של שירות קיים לקובץ YAML באמצעות הפקודה gcloud run services describe והדגל --format=export. אחר כך תוכלו לשנות את קובץ ה-YAML ולפרוס את השינויים האלה באמצעות הפקודה gcloud run services replace. חשוב לוודא שמשנים רק את המאפיינים שצוינו.

  1. מורידים את ההגדרה של השירות לקובץ בשם service.yaml בסביבת העבודה המקומית:

    gcloud run services describe SERVICE --format export > service.yaml

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

  2. מעדכנים את המאפיין timeoutSeconds בקובץ המקומי:

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    spec:
      containers:
      - image: IMAGE
      timeoutSeconds: TIMEOUT

    מחליפים את:

    • ‫SERVICE בשם של שירות Knative serving
    • ‫IMAGE_URL עם הפניה לקובץ אימג' של קונטיינר, לדוגמה, gcr.io/cloudrun/hello.
    • ‫TIMEOUT עם ערך הזמן הקצוב לתפוגה הרצוי, בשניות.

  3. מחליפים את השירות בהגדרות החדשות באמצעות הפקודה הבאה:

    gcloud run services replace service.yaml