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

פונקציית Cloud Run פועלת בסביבה שמורכבת מגרסה של מערכת הפעלה עם חבילות של תוספים, תמיכה בשפה וספריית Python Functions Framework שתומכת בפונקציה ומפעילה אותה. הסביבה הזו מזוהה לפי גרסת השפה, והיא נקראת מזהה סביבת זמן הריצה.

הכנת הפונקציה

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

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

זמן ריצה	המזהה של סביבת זמן הריצה	מקבצים	תמונת הבסיס של סביבת זמן הריצה	הוצאה משימוש	הוצאה משימוש
‫Python 3.15 (גרסת טרום-השקה (Preview))	python315	‫google-24 (ברירת המחדל) google-24-full	google-24/python315 google-24-full/python315
‫Python 3.14	python314	‫google-24 (ברירת המחדל) google-24-full	google-24/python314 google-24-full/python314	2030-10-10	2031-04-10
‫Python 3.13	python313	‫google-22 (ברירת מחדל) google-22-full	google-22/python313 google-22-full/python313	2029-10-10	2030-04-10
‫Python 3.12	python312	‫google-22 (ברירת מחדל) google-22-full	google-22/python312 google-22-full/python312	2028-10-02	2029-04-02
Python 3.11	python311	‫google-22 (ברירת מחדל) google-22-full	google-22/python311 google-22-full/python311	2027-10-24	2028-04-24
Python 3.10	python310	‫google-22 (ברירת מחדל) google-22-full	google-22/python310 google-22-full/python310	2026-10-04	2027-04-04
‫Python 3.9	python39	google-18-full	google-18-full/python39	2025-10-05	2026-04-05
‫Python 3.8	python38	google-18-full	google-18-full/python38	2024-10-14	2025-10-14
Python 3.7	python37	google-18-full	google-18-full/python37	2024-01-30	2025-01-30

בחירת סביבת זמן הריצה

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

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

gcloud

כשפורסים את הפונקציה, מציינים את תמונת הבסיס של Python לפונקציה באמצעות הדגל --base-image. לדוגמה:

gcloud run deploy FUNCTION \
    --source . \
    --function FUNCTION_ENTRYPOINT \
    --base-image python314

מחליפים את:

• ‫FUNCTION בשם הפונקציה שאתם פורסים. אפשר להשמיט את הפרמטר הזה לגמרי, אבל אם תשמיטו אותו תתבקשו להזין את השם.

• ‫FUNCTION_ENTRYPOINT בנקודת הכניסה לפונקציה בקוד המקור. זה הקוד ש-Cloud Run מריץ כשהפונקציה פועלת. הערך של הדגל הזה חייב להיות שם של פונקציה או שם מלא של מחלקה שקיימים בקוד המקור.

במאמר פריסת פונקציות ב-Cloud Run מוסבר בפירוט איך פורסים פונקציה באמצעות ה-CLI של gcloud.

המסוף

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

כדי לבחור סביבת זמן ריצה במסוף Google Cloud כשיוצרים פונקציה:

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

   כניסה ל-Cloud Run

2. לוחצים על כתיבת פונקציה.

3. ברשימה Runtime, בוחרים גרסת סביבת זמן ריצה של Python.

4. לוחצים על Create ומחכים ש-Cloud Run ייצור את השירות באמצעות גרסה זמנית.

5. המסוף יפנה אתכם לכרטיסייה Source, שבה תוכלו לראות את קוד המקור של הפונקציה. לוחצים על Save and redeploy.

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

מבנה קוד המקור

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

ציון יחסי תלות

יש כמה דרכים לציין יחסי תלות של פונקציות Cloud Run ב-Python: להשתמש בקובץ requirements.txt של מנהל חבילות, להגדיר קובץ pyproject.toml כקובץ הגדרת הפרויקט הרגיל או לארוז יחסי תלות מקומיים לצד הפונקציה. מידע נוסף זמין במאמר ציון יחסי תלות ב-Python.

בפונקציות Cloud Run אי אפשר לציין יחסי תלות באמצעות Pipfile/Pipfile.lock, ולכן הפרויקט לא צריך לכלול את הקבצים האלה.

משתני סביבה

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