סביבת זמן הריצה של Python

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

גרסאות Python

‫Python 3.14 משתמש ב-buildpacks. במאמר הזה מפורטת רשימה מלאה של גרסאות Python נתמכות וגרסאות Ubuntu התואמות להן.

כדי להשתמש בגרסת Python נתמכת, צריך:

  • כדי לציין מערכת הפעלה, צריך לכלול את ההגדרות runtime_config ו-operating_system בקובץ app.yaml.

  • מתקינים את gcloud CLI גרסה 420.0.0 ואילך. כדי לעדכן את כלי ה-CLI, מריצים את הפקודה gcloud components update. כדי לראות את הגרסה המותקנת, מריצים את הפקודה gcloud version.

  • אפשר גם לציין גרסת זמן ריצה על ידי הוספת ההגדרה runtime_version לקובץ app.yaml. כברירת מחדל, נעשה שימוש בגרסה העדכנית ביותר של Python אם לא מציינים את ההגדרה runtime_version.

דוגמאות

  • כדי לציין Python 3.14 ב-Ubuntu 24:

    runtime: python
env: flex
entrypoint: gunicorn -b :$PORT main:app

runtime_config:
    operating_system: "ubuntu24"
    runtime_version: "3.14"

  • כדי לציין את גרסת Python הנתמכת האחרונה ב-Ubuntu 24:

      runtime: python
  env: flex
  entrypoint: gunicorn -b :$PORT main:app

  runtime_config:
      operating_system: "ubuntu24"

מידע נוסף זמין בדף העזרה של app.yaml.

תמיכה בסביבות זמן ריצה אחרות של Python

אם אתם צריכים להשתמש בגרסת Python שלא נתמכת, אתם יכולים ליצור סביבת ריצה בהתאמה אישית ולבחור תמונת בסיס תקינה עם גרסת Python שאתם צריכים.

מידע על תמונות בסיס שסופקו על ידי Google או על תמונות בסיס של Docker Python זמין במאמר יצירת סביבות ריצה בהתאמה אישית.

כדי לבדוק לעומק את האפשרות להעביר אפליקציות של App Engine ל-Cloud Run באמצעות קונטיינרים, אפשר לעיין במדריך להעברת נתונים.

תלויות

סביבת זמן הריצה מחפשת קובץ requirements.txt בספריית קובצי המקור של האפליקציה ומשתמשת ב-pip כדי להתקין את כל יחסי התלות לפני הפעלת האפליקציה. מידע נוסף על הצהרה וניהול של חבילות זמין במאמר שימוש בספריות Python.

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

הפעלת האפליקציה

סביבת זמן הריצה מפעילה את האפליקציה באמצעות entrypoint שמוגדר בקובץ app.yaml. נקודת הכניסה צריכה להפעיל תהליך שמגיב לבקשות HTTP ביציאה שמוגדרת על ידי משתנה הסביבה PORT.

רוב אפליקציות האינטרנט משתמשות בשרת WSGI כמו Gunicorn, ‏ uWSGI או Waitress.

כדי להשתמש באחד מהשרתים האלה, צריך להוסיף אותם כתלות בקובץ requirements.txt של האפליקציה. אם אתם משתמשים ב-gunicorn באפליקציית Flask, אתם צריכים לוודא שגרסת Python של האפליקציה תואמת ל-gunicorn.

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

Flask==2.0.2
gunicorn==20.1.0

דוגמה לנקודת כניסה באמצעות gunicorn לאפליקציית Flask:

entrypoint: gunicorn -b :$PORT main:app

דוגמה לנקודת כניסה באמצעות gunicorn לאפליקציית Django:

entrypoint: gunicorn -b :$PORT mydjangoapp:wsgi

מומלץ להשתמש ב-Gunicorn כשרת WSGI, אבל אפשר להשתמש בכל שרת WSGI אחר. לדוגמה, הנה נקודת כניסה שמשתמשת ב-uWSGI עם Flask:

entrypoint: uwsgi --http :$PORT --wsgi-file main.py --callable app

באפליקציות שיכולות לטפל בבקשות בלי שרת WSGI, אפשר פשוט להריץ סקריפט Python:

entrypoint: python main.py

הדוגמאות הבסיסיות לנקודות כניסה שמוצגות למעלה נועדו לשמש כנקודות התחלה, ויכול להיות שהן יתאימו לאפליקציות האינטרנט שלכם. עם זאת, ברוב האפליקציות יהיה צורך להגדיר עוד את שרת ה-WSGI. במקום לציין את כל ההגדרות בנקודת הכניסה, יוצרים קובץ gunicorn.conf.py בספריית הבסיס של הפרויקט, שבה נמצא הקובץ app.yaml, ומציינים אותו בנקודת הכניסה:

entrypoint: gunicorn -c gunicorn.conf.py -b :$PORT main:app

בתיעוד של Gunicorn אפשר לקרוא על כל ערכי ההגדרה שלו.

עובדים

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

מומלץ להגדיר את מספר העובדים לערך שגדול פי 2 עד פי 4 ממספר ליבות ה-CPU במופע, ועוד אחד. אפשר לציין את הערך הזה ב-gunicorn.conf.py באופן הבא:

import multiprocessing

workers = multiprocessing.cpu_count() * 2 + 1

בנוסף, יכול להיות ששימוש בסוג אחר של worker ישפר את הביצועים של חלק מאפליקציות האינטרנט שמוגבלות בעיקר על ידי קלט/פלט. אם סוג ה-worker שלכם דורש תלות נוספת, כמו gevent או tornado, תצטרכו להצהיר על התלות הזו בקובץ requirements.txt של האפליקציה.

פרוטוקול HTTPS ושרתי proxy להעברה

‫App Engine מפסיק את חיבור ה-HTTPS במאזן העומסים ומעביר את הבקשה לאפליקציה. לרוב האפליקציות לא צריך לדעת אם הבקשה נשלחה באמצעות HTTPS או לא, אבל אפליקציות שצריכות את המידע הזה צריכות להגדיר את Gunicorn כך שיסמוך על ה-proxy של App Engine ב-gunicorn.conf.py:

forwarded_allow_ips = '*'
secure_scheme_headers = {'X-FORWARDED-PROTO': 'https'}

‫Gunicorn יוודא עכשיו ש-wsgi.url_scheme עד 'https', שרוב מסגרות האינטרנט ישתמשו בהן כאינדיקציה לכך שהבקשה מאובטחת. אם שרת ה-WSGI או המסגרת לא תומכים בזה, פשוט בודקים את הערך של הכותרת X-Forwarded-Proto באופן ידני.

יש גם אפליקציות שצריכות לזהות את כתובת ה-IP של המשתמש. האפשרות הזו זמינה בכותרת X-Forwarded-For.

שימו לב שההגדרה secure_scheme_headers ב-gunicorn.conf.py צריכה להיות באותיות רישיות, כמו X-FORWARDED-PROTO, אבל הכותרות שהקוד יכול לקרוא יהיו באותיות מעורבות, כמו X-Forwarded-Proto.

הארכת זמן הריצה

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

משתני סביבה

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

משתנה סביבה תיאור
GAE_INSTANCE השם של המכונה הנוכחית.
GAE_MEMORY_MB נפח הזיכרון שזמין לתהליך האפליקציה.
GAE_SERVICE שם השירות שצוין בקובץ app.yaml של האפליקציה, או אם לא צוין שם שירות, הוא מוגדר כ-default.
GAE_VERSION תווית הגרסה של האפליקציה הנוכחית.
GOOGLE_CLOUD_PROJECT מזהה הפרויקט שמשויך לאפליקציה, שמופיע במסוף Google Cloud
PORT היציאה שתקבל בקשות HTTP.

אפשר להגדיר משתני סביבה נוספים בקובץ app.yaml.

שרת מטא-נתונים

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

הפונקציה בדוגמה הזו משתמשת בשרת המטא-נתונים כדי לקבל את כתובת ה-IP החיצונית של המופע:

METADATA_NETWORK_INTERFACE_URL = (
    "http://metadata/computeMetadata/v1/instance/network-interfaces/0/"
    "access-configs/0/external-ip"
)


def get_external_ip():
    """Gets the instance's external IP address from the Compute Engine metadata
    server.

    If the metadata server is unavailable, it assumes that the application is running locally.

    Returns:
        The instance's external IP address, or the string 'localhost' if the IP address
        is not available.
    """
    try:
        r = requests.get(
            METADATA_NETWORK_INTERFACE_URL,
            headers={"Metadata-Flavor": "Google"},
            timeout=2,
        )
        return r.text
    except requests.RequestException:
        logging.info("Metadata server could not be reached, assuming local.")
        return "localhost"