יצירת אפליקציית Python בסביבה גמישה ב-App Engine

מזהה אזור

‫REGION_ID הוא קוד מקוצר ש-Google מקצה על סמך האזור שבוחרים כשיוצרים את האפליקציה. הקוד לא תואם למדינה או למחוז, למרות שחלק ממזהי האזורים עשויים להיראות דומים לקודים נפוצים של מדינות ומחוזות. באפליקציות שנוצרו אחרי פברואר 2020, REGION_ID.r נכלל בכתובות ה-URL של App Engine. באפליקציות קיימות שנוצרו לפני התאריך הזה, מזהה האזור הוא אופציונלי בכתובת ה-URL.

מידע נוסף על מזהי אזורים

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

לפני שמתחילים

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Cloud Build API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  4. Install the Google Cloud CLI.

  5. Configure the gcloud CLI to use your federated identity.

    For more information, see Sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות להשלמת המדריך הזה, אתם צריכים לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

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

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

דרישות מוקדמות נוספות

  1. מאתחלים את אפליקציית App Engine עם הפרויקט ובוחרים את האזור שלה:

    gcloud app create --project=[YOUR_PROJECT_ID]

    כשמופיעה בקשה, בוחרים את האזור שבו רוצים למקם את אפליקציית App Engine.

  2. מתקינים את הרכיבים הבאים במחשב המקומי:

    • מריצים את הפקודה הבאה כדי להתקין את רכיב gcloud שכולל את התוסף App Engine ל-Python:

      gcloud components install app-engine-python

  3. הכנת הסביבה לפיתוח ב-Python. מומלץ להתקין במערכת את הגרסה העדכנית של Python, ‏pip וכלים קשורים אחרים. הוראות מופיעות במדריך להגדרת סביבת הפיתוח בשפת Python.

המיקומים של App Engine

‫App Engine הוא אזורי, כלומר התשתית שמריצה את האפליקציות שלכם נמצאת באזור ספציפי, ו-Google מנהלת אותה כך שהיא תהיה זמינה באופן יתיר בכל התחומים באותו אזור.

הגורמים העיקריים לבחירת האזור שבו האפליקציות שלכם יפעלו הם עמידה בדרישות של זמן אחזור, זמינות או עמידות. בדרך כלל אפשר לבחור את האזור הכי קרוב למשתמשים של האפליקציה, אבל כדאי להביא בחשבון את המיקומים שבהם App Engine זמין ואת המיקומים שלGoogle Cloud המוצרים והשירותים האחרים שבהם האפליקציה משתמשת. שימוש בשירותים בכמה מיקומים יכול להשפיע על זמן האחזור של האפליקציה ועל התמחור שלה.

אחרי שמגדירים את האזור של האפליקציה, אי אפשר לשנות אותו.

אם כבר יצרתם אפליקציית App Engine, תוכלו לראות את האזור שלה באחת מהדרכים הבאות:

במדריך למתחילים הזה נדגים את האפליקציה העדכנית ביותר של Python 3 שנכתבה באמצעות Flask, מסגרת אינטרנט שאפשר לפרוס ב-App Engine. למרות שבקוד לדוגמה הזה נעשה שימוש ב-Flask, אפשר להשתמש בכל מסגרת אינטרנט שעומדת בדרישות שלמעלה. מסגרות חלופיות כוללות את Django,‏ Pyramid,‏ Bottle ו-web.py.

הורדה של אפליקציית Hello World

יצרנו אפליקציית Hello World ל-App Engine כדי שתוכלו להבין במהירות איך פורסים אפליקציה ב- Google Cloud.

  1. משכפלים את המאגר של אפליקציית Hello World לדוגמה למכונה המקומית.

    git clone https://github.com/GoogleCloudPlatform/python-docs-samples

    אפשרות נוספת היא להוריד את הקובץ לדוגמה כקובץ ZIP ולחלץ אותו.

  2. עוברים לספרייה שמכילה את הקוד לדוגמה.

       cd python-docs-samples/appengine/flexible/hello_world

הרצת Hello World במחשב המקומי

כדי להריץ את אפליקציית Hello World במחשב המקומי:

Mac OS / Linux

  1. יוצרים סביבת Python מבודדת: 
    python3 -m venv env
source env/bin/activate
  2. אם אתם לא בספרייה שמכילה את הקוד לדוגמה, עוברים לספרייה שמכילה את הקוד לדוגמה של hello_world. ואז מתקינים את יחסי התלות: 
    cd YOUR_SAMPLE_CODE_DIR
pip install -r requirements.txt
  3. מריצים את האפליקציה: 
    python main.py
  4. בדפדפן האינטרנט, מזינים את הכתובת הבאה: 
    http://localhost:8080

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

Windows

משתמשים ב-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
  5. מריצים את האפליקציה: 
    python main.py
  6. בדפדפן האינטרנט, מזינים את הכתובת הבאה: 
    http://localhost:8080

ההודעה Hello World מאפליקציית הדוגמה מוצגת בדף. בחלון הטרמינל, מקישים על Ctrl+C כדי לצאת משרת האינטרנט.

פריסה והפעלה של Hello World ב-App Engine

כדי לפרוס את האפליקציה בסביבה הגמישה של App Engine:

  1. מריצים את הפקודה הבאה מהספרייה hello_world כדי לפרוס את אפליקציית Hello World: 

    gcloud app deploy

    מידע על הדגלים האופציונליים

    הגדרות flag נפוצות של הפקודה gcloud

    • מוסיפים את הדגל --version כדי לציין מזהה ייחודי לגרסה הזו של האפליקציה. אם לא תציינו מזהה, המערכת תיצור מזהה בשבילכם. לדוגמה: --version [YOUR_VERSION_ID]
    • מוסיפים את הדגל --project כדי לציין מזהה פרויקט ב- Google Cloud שונה מזה שהגדרתם כברירת המחדל בכלי gcloud. לדוגמה: --project [YOUR_PROJECT_ID]

    דוגמה:

    gcloud app deploy --version pre-prod-5 --project my-sample-app

    במאמר בדיקה ופריסה של האפליקציה תוכלו לקרוא מידע נוסף על פריסת האפליקציה משורת הפקודה. רשימה של כל הדגלים של הפקודה מופיעה במאמר בנושא gcloud app deploy.

  2. מפעילים את הדפדפן כדי להציג את האפליקציה בכתובת https://PROJECT_ID.REGION_ID.r.appspot.com

    ‫
    gcloud app browse
    , כאשר PROJECT_ID מייצג את מזהה הפרויקט ב- Google Cloud.

הפעם, הדף שמציג את ההודעה Hello World מועבר על ידי שרת אינטרנט שפועל במופע של App Engine.

מזל טוב! פרסתם את האפליקציה הראשונה שלכם ב-App Engine בסביבה הגמישה ב-App Engine!

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

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

הסרת המשאבים

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

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

    כניסה לדף Manage resources

  2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
  3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

המאמרים הבאים

לומדים את כל הפלטפורמה

עכשיו, אחרי שראיתם איך מפתחים ומפעילים אפליקציות App Engine, אתם יכולים לעיין בשאר המאמרים בנושא Google Cloud. כבר מותקן אצלכם Google Cloud CLI, שכולל את הכלים שמאפשרים לכם ליצור אינטראקציה עם מוצרים כמו Cloud SQL, ‏ Cloud Storage,‏ Firestore ועוד.

מידע על סביבה גמישה ב-App Engine

הנה כמה נושאים שיעזרו לכם להמשיך ללמוד על App Engine:

סקר קוד של Hello World

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

main.py

האפליקציה Hello World היא אפליקציית Flask בסיסית עם קובץ אחד.

from flask import Flask


app = Flask(__name__)


@app.route("/")
def hello() -> str:
    """Return a friendly HTTP greeting.

    Returns:
        A string with the words 'Hello World!'.
    """
    return "Hello World!"


if __name__ == "__main__":
    # This is used when running locally only. When deploying to Google App
    # Engine, a webserver process such as Gunicorn will serve the app.
    app.run(host="127.0.0.1", port=8080, debug=True)

app.yaml

בקובץ app.yaml מפורטת התצורה הבאה של האפליקציה:

  • הערך env: flex מציין שהאפליקציה משתמשת בסביבה גמישה ב-App Engine.

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

  • הקובץ entrypoint מציין ל-App Engine איך להפעיל את האפליקציה. האפליקציה הזו משתמשת ב-gunicorn כדי להפעיל את אפליקציית Python כחלופה לשרת הפיתוח של Flask (שמשמש להרצה מקומית). המשתנה $PORT מוגדר על ידי App Engine כשהוא מפעיל את האפליקציה. מידע נוסף על entrypoint זמין במאמר בנושא הפעלת אפליקציה.

# Copyright 2021 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

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

runtime_config:
  operating_system: ubuntu24
  runtime_version: 3.14

# This sample incurs costs to run on the App Engine flexible environment.
# The settings below are to reduce costs during testing and are not appropriate
# for production use. For more information, see:
# https://cloud.google.com/appengine/docs/flexible/python/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

requirements.txt

‫requirements.txt ומנהל החבילות של Python‏ pip מצהירים על יחסי התלות של האפליקציה ומתקינים אותם. אפליקציית Hello World דורשת את Flask, מסגרת אינטרנט, ואת Gunicorn, שרת WSGI.

Flask==3.1.3; python_version >= '3.9'
gunicorn==22.0.0

‫requirements.txt מגדיר את הספריות שיותקנו באופן מקומי וגם במהלך הפריסה ב-App Engine.