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

יחסי התלות של אפליקציות Python מוצהרים בקובץ requirements.txt רגיל. לדוגמה:

Flask==MAJOR.MINOR.PATCH
google-cloud-storage

מחליפים את MAJOR, MINOR ו-PATCH במספרי הגרסאות הרצויים של Flask.

אתם יכולים להשתמש בכל חבילת Python שתואמת ל-Linux בסביבה הגמישה של App Engine, כולל חבילות שדורשות תוספים מקוריים (C).

סביבת זמן הריצה של Python תתקין באופן אוטומטי את כל התלויות שמוצהרות ב-requirements.txt במהלך הפריסה.

התקנת יחסי תלות באופן מקומי

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

כדי להשתמש ב-venv להתקנת יחסי תלות, מבצעים את השלבים הבאים:

Mac OS / Linux

הערה: ההוראות האלה מתארות איך להגדיר סביבה וירטואלית ב-Python 3. באפליקציות Python 2, משתמשים ב-virtualenv כדי להגדיר סביבה וירטואלית.

1. יוצרים סביבת Python מבודדת:

   python3 -m venv env
   source env/bin/activate

2. אם אתם לא בספרייה שמכילה את הקוד לדוגמה, עוברים לספרייה שמכילה את הקוד לדוגמה hello_world. לאחר מכן מתקינים את יחסי התלות:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

Windows

הערה: ההוראות האלה מתארות איך להגדיר סביבה וירטואלית ב-Python 3. באפליקציות Python 2, משתמשים ב-virtualenv כדי להגדיר סביבה וירטואלית.

משתמשים ב-PowerShell כדי להריץ את חבילות Python.

1. מוצאים את ההתקנה של PowerShell.
2. לוחצים לחיצה ימנית על קיצור הדרך ל-PowerShell ומפעילים אותו כאדמין.
3. יוצרים סביבת Python מבודדת.

   python -m venv env
   .\env\Scripts\activate

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

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

כך מוודאים שכאשר מריצים את האפליקציה באופן מקומי, זמינים רק יחסי התלות שמוצהרים בקובץ requirements.txt. התלות ש-App Engine מתקין במהלך הפריסה מבוססת על התוכן של הקובץ requirements.txt, ולא על התוכן של הספרייה env/.

טיפ: ברוב המקרים לא תדעו מהן התלויות המדויקות. אחרי שמתקינים את התלויות, אפשר להשתמש ב-pip freeze כדי לכתוב את השם והגרסה של כל החבילות שהותקנו ב-requirements.txt.

התקנה של מסגרת אינטרנט

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

• Flask
• Django
• Pyramid
• בקבוק
• web.py
• Tornado

כדי להשתמש במסגרת אינטרנט מסוימת, פשוט מוסיפים אותה ל-requirements.txt:

Flask==MAJOR.MINOR.PATCH

התקנה של שרת WSGI

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

התקנת ספריות לקוח של Cloud

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

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

כדי להתקין את ספריית הלקוח של Python ל-Cloud Datastore:

1. מתקינים את ספריית הלקוח באופן מקומי באמצעות pip:

   pip install google-cloud-datastore

2. מגדירים אימות. אפשר להגדיר את ספריות הלקוח ב-Cloud לשימוש ב-Python כך שהאימות יתבצע באופן אוטומטי. ספריית הלקוח יכולה לטפל באימות באופן אוטומטי גם באופן מקומי באמצעות Google Cloud CLI.

   gcloud auth login
   

3. כדי להטמיע תמיכה בשירות Cloud Datastore באפליקציה, אפשר להשתמש בהפניה לספריות הלקוח של Datastore.

רשימה מלאה של כל ספריות הלקוח של Python ל-Cloud עבור השירותים הנתמכים שלGoogle Cloud זמינה במאמר ממשקי API וספריות Python.