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

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

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

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

זמני ריצה וקובצי אימג' בסיסיים נתמכים של Python

זמן ריצה	המזהה של סביבת זמן הריצה	מקבצים	תמונת הבסיס בזמן הריצה
Python 3.14	python314	‫google-24 (ברירת מחדל) google-24-full	google-24/python314 google-24-full/python314
Python 3.13	python313	‫google-22 (ברירת מחדל) google-22-full	google-22/python313 google-22-full/python313
Python 3.12	python312	‫google-22 (ברירת מחדל) google-22-full	google-22/python312 google-22-full/python312
Python 3.11	python311	‫google-22 (ברירת מחדל) google-22-full	google-22/python311 google-22-full/python311
Python 3.10	python310	‫google-22 (ברירת מחדל) google-22-full	google-22/python310 google-22-full/python310
Python 3.9	python39	google-18-full	google-18-full/python39
Python 3.8	python38	google-18-full	google-18-full/python38
Python 3.7	python37	google-18-full	google-18-full/python37

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

במהלך הפריסה, אפשר לבחור אחת מסביבות זמן הריצה הנתמכות של 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 מריץ כשהפונקציה פועלת. הערך של הדגל הזה צריך להיות שם של פונקציה או שם מלא של מחלקה שקיימים בקוד המקור.

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

המסוף

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

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

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

   כניסה ל-Cloud Run

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

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

4. לוחצים על Create ומחכים ש-Cloud Run ייצור את השירות באמצעות עדכון placeholder.

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

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

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

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

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

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

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

משתני סביבה

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