הרצת Django בסביבה הגמישה של App Engine

אפליקציות Django שפועלות בסביבה הגמישה של App Engine משתנות באופן דינמי בהתאם לתנועה.

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

המדריך הזה מתמקד ב-Django, אבל אפשר להשתמש בתהליך הפריסה הזה עם מסגרות אחרות שמבוססות על Django, כמו Wagtail ו-Django CMS.

במדריך הזה משתמשים ב-Django 6, שמחייב שימוש ב-Python 3.12 לפחות. מומלץ מאוד להשתמש בגרסה העדכנית ביותר בסדרה הזו. הסביבה הגמישה של App Engine תומכת בגרסאות עד Python 3.14.

מטרות

במדריך הזה תלמדו:

• ליצור מסד נתונים ב-Cloud SQL ולהתחבר אליו.
• ליצור ולהשתמש בערכי סודות של Secret Manager.

• פריסת אפליקציית Django בסביבה הגמישה של App Engine.

• לארח קבצים סטטיים ב-Cloud Storage.

עלויות

במסמך הזה משתמשים ברכיבים הבאים של Google Cloud, והשימוש בהם כרוך בתשלום:

• App Engine
• Cloud SQL
• Secret Manager

בעזרת מחשבון העלויות אתם יכולים להעריך את העלויות בהתאם לשימוש הצפוי.

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

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

נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
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.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud SQL Admin API, Secret Manager, and Cloud Build APIs, if any are 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 APIs
Install the gcloud CLI.
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
To initialize the gcloud CLI, run the following command:
gcloud init
הערה: אתם יכולים להשתמש ב-gcloud CLI במסוף Google Cloud גם בלי להתקין אותו. פתחו את ה-CLI של gcloud במסוף Google Cloud באמצעות Cloud Shell.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud SQL Admin API, Secret Manager, and Cloud Build APIs, if any are 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 APIs

Install the gcloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

הערה: אתם יכולים להשתמש ב-gcloud CLI במסוף Google Cloud גם בלי להתקין אותו. פתחו את ה-CLI של gcloud במסוף Google Cloud באמצעות Cloud Shell.
1. אם עדיין לא עשיתם את זה, צריך להפעיל את App Engine ולבחור את האזור הרצוי:

   gcloud app create
   

הכנת הסביבה

שכפול אפליקציה לדוגמה

הקוד של האפליקציה לדוגמה של Django נמצא במאגר GoogleCloudPlatform/python-docs-samples ב-GitHub.

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

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

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

   ‫Linux/macOS

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

   Windows

   cd python-docs-samples\appengine\flexible\django_cloudsql
   

אישור ההגדרה של Python

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

מידע נוסף זמין במדריך לסביבת הפיתוח של Python.

1. מוודאים שגרסת ה-Python היא לפחות 3.14.

    python -V
   

   צריכה להופיע הגרסה Python 3.14.0 או גרסה חדשה יותר.

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

2. יוצרים סביבה וירטואלית של Python ומתקינים יחסי תלות:

   ‫Linux/macOS

   python -m venv venv
   source venv/bin/activate
   pip install --upgrade pip
   pip install -r requirements.txt
   

   Windows

   python -m venv venv
   venv\scripts\activate
   pip install --upgrade pip
   pip install -r requirements.txt
   

הורדת Cloud SQL Auth Proxy כדי להתחבר ל-Cloud SQL מהמכונה המקומית

הערה: אם אתם משלימים את המדריך הזה מ-Cloud Shell, אתם לא צריכים את החלק הזה.

אחרי הפריסה, האפליקציה משתמשת ב-Cloud SQL Auth Proxy שמובנה בסביבה הגמישה ב-App Engine כדי לתקשר עם המכונה של Cloud SQL. עם זאת, כדי לבדוק את האפליקציה באופן מקומי, צריך להתקין עותק מקומי של שרת ה-proxy ולהשתמש בו בסביבת הפיתוח. לפרטים נוספים, קראו את המדריך ל-Cloud SQL Auth Proxy.

‫Cloud SQL Auth Proxy משתמש ב-Cloud SQL API כדי ליצור אינטראקציה עם מכונת ה-SQL. כדי לעשות את זה, צריך לאמת את האפליקציה באמצעות ה-CLI של gcloud.

1. מאמתים ומקבלים פרטי כניסה ל-API:

   gcloud auth application-default login
   

2. מורידים ומתקינים את Cloud SQL Auth Proxy במחשב המקומי.

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

   אם אתם משתמשים ב-Linux או ב-Mac, אתם יכולים להריץ את הפקודה הבאה כדי למצוא את המידע הזה:

     uname -a
     

   ‏Linux‏ 64 סיביות

   1. מורידים את Cloud SQL Auth Proxy:

      curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.3/cloud-sql-proxy.linux.amd64

   2. הופכים את Cloud SQL Auth Proxy לקובץ הפעלה:

      chmod +x cloud-sql-proxy

   ‏Linux‏ 32 סיביות

   1. מורידים את Cloud SQL Auth Proxy:

      curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.3/cloud-sql-proxy.linux.386

   2. אם הפקודה curl לא נמצאה, מריצים את sudo apt install curl וחוזרים על פקודת ההורדה.
   3. הופכים את Cloud SQL Auth Proxy לקובץ הפעלה:

      chmod +x cloud-sql-proxy

   macOS‏ 64 סיביות

   1. מורידים את Cloud SQL Auth Proxy:

      curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.3/cloud-sql-proxy.darwin.amd64

   2. הופכים את Cloud SQL Auth Proxy לקובץ הפעלה:

      chmod +x cloud-sql-proxy

   Mac M1

   1. מורידים את Cloud SQL Auth Proxy:

        curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.3/cloud-sql-proxy.darwin.arm64
        

   2. הופכים את Cloud SQL Auth Proxy לקובץ הפעלה:

        chmod +x cloud-sql-proxy
        

   ‏Windows‏ 64 סיביות

   לוחצים לחיצה ימנית על הקישור https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.3/cloud-sql-proxy.x64.exe ובוחרים באפשרות Save Link As כדי להוריד את Cloud SQL Auth Proxy. משנים את שם הקובץ ל-cloud-sql-proxy.exe.

   ‏Windows‏ 32 סיביות

   לוחצים לחיצה ימנית על הקישור https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.26.3/cloud-sql-proxy.x86.exe ובוחרים באפשרות Save Link As כדי להוריד את Cloud SQL Auth Proxy. משנים את שם הקובץ ל-cloud-sql-proxy.exe.

   קובץ אימג' של Docker ל-Cloud SQL Auth Proxy

   ל-Cloud SQL Auth Proxy יש קובצי אימג' שונים של קונטיינרים, כמו distroless,‏ alpine ו-buster. קובץ האימג' של הקונטיינר שמשמש כברירת מחדל ל-Cloud SQL Auth Proxy משתמש ב-distroless, שלא מכיל מעטפת. אם אתם צריכים מעטפת או כלים קשורים, הורידו קובץ אימג' שמבוסס על alpine או על buster. מידע נוסף מופיע במאמר קובצי אימג' של קונטיינרים של Cloud SQL Auth Proxy.

   כדי להוריד את קובץ האימג' העדכני למחשב המקומי באמצעות Docker, משתמשים בפקודה הבאה:

   docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.26.3
   

   הערה: ה-Cloud SQL Auth Proxy משתמש במאגר שתומך בדומיין gcr.io, אבל מציג קובצי אימג' מ-Artifact Registry. מידע נוסף זמין במאמר מעבר מ-Container Registry.

   מערכת הפעלה אחרת

   במערכות הפעלה אחרות שלא מופיעות כאן, אפשר להדר את Cloud SQL Auth Proxy מהמקור.

   אפשר להעביר את ההורדה למיקום נפוץ, כמו מיקום ב-PATH או ספריית הבית. אם תבחרו לעשות את זה, כשתפעילו את Cloud SQL Auth Proxy בהמשך המדריך, זכרו להפנות למיקום שבחרתם כשאתם משתמשים בפקודות cloud-sql-proxy.

יצירת שירותים תומכים

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

הגדרת מכונה של Cloud SQL ל-PostgreSQL

Django תומך באופן רשמי במספר מסדי נתונים רלציוניים, אבל התמיכה הטובה ביותר היא ב-PostgreSQL. ‫Cloud SQL תומך ב-PostgreSQL, ולכן במדריך הזה נשתמש בסוג הזה של מסד נתונים.

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

1. יוצרים את מכונת PostgreSQL:

   המסוף

   1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

      כניסה לדף Cloud SQL Instances

   2. לוחצים על Create Instance.

   3. לוחצים על Choose PostgreSQL.

   4. ב-SQL Edition, בוחרים באפשרות Enterprise.

   5. בקטע Edition Preset, בוחרים באפשרות Sandbox.

   6. בשדה Instance ID, מזינים את הערך INSTANCE_NAME.

   7. מזינים סיסמה למשתמש postgres.

   8. משאירים את ערכי ברירת המחדל בשאר השדות.

   9. לוחצים על Create Instance.

   המכונה תהיה מוכנה לשימוש תוך כמה דקות.

   gcloud

   • יוצרים את מכונת PostgreSQL:

     gcloud sql instances create INSTANCE_NAME \
         --project PROJECT_ID \
         --database-version POSTGRES_16 \
         --tier db-n1-standard-2 \
         --region REGION
     

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫INSTANCE_NAME: השם של מכונת Cloud SQL
   • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
   • ‫REGION: Google Cloud האזור

   המכונה נוצרת תוך כמה דקות, ואז היא מוכנה לשימוש.

2. במכונה שנוצרה, יוצרים מסד נתונים:

   המסוף

   1. בדף המכונה, נכנסים לכרטיסייה Databases.
   2. לוחצים על Create database.
   3. בתיבת הדו-שיח Database Name, מזינים DATABASE_NAME.
   4. לוחצים על יצירה.

   gcloud

   • יוצרים את מסד הנתונים במכונה שנוצרה לאחרונה:

     gcloud sql databases create DATABASE_NAME \
         --instance INSTANCE_NAME
     

     מחליפים את DATABASE_NAME בשם של מסד הנתונים בתוך המכונה.

3. יוצרים משתמש במסד הנתונים:

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

   המסוף

   1. בדף המכונה, עוברים לכרטיסייה Users.
   2. לוחצים על הוספת חשבון משתמש.
   3. בתיבת הדו-שיח בחירת שיטת אימות, בקטע "אימות מובנה":
   4. מזינים את שם המשתמש DATABASE_USERNAME.
   5. מזינים את הסיסמה DATABASE_PASSWORD
   6. לוחצים על הוספה.

   gcloud

   • יוצרים את המשתמש במכונה שנוצרה לאחרונה:

     gcloud sql users create DATABASE_USERNAME \
         --instance INSTANCE_NAME \
         --password DATABASE_PASSWORD
     

     מחליפים את PASSWORD בסיסמה מאובטחת.

הגדרת קטגוריה של Cloud Storage

אתם יכולים לאחסן את הנכסים הסטטיים שכלולים ב-Django, וגם מדיה שהמשתמשים העלו, במאגר אובייקטים עם זמינות גבוהה באמצעות Cloud Storage. החבילה django-storages[google] מטפלת באינטראקציה של Django עם הקצה העורפי של האחסון.

המסוף

1. פותחים את הדף Cloud Storage במסוף Google Cloud .

   כניסה לדף Cloud Storage

2. לוחצים על Create Bucket.

3. מזינים את הפרטים הבאים (לוחצים על "המשך" לפי הצורך):

   • בשדה Name, מזינים "PROJECT_ID_MEDIA_BUCKET".
   • בשדה Region, בוחרים באפשרות REGION.
   • משאירים את ערכי ברירת המחדל בשדה Storage Class.
   • בקטע Prevent public access, מבטלים את הסימון של "Enforce public access prevention".
   • בקטע בקרת גישה, בוחרים באפשרות Fine-grained.

4. משאירים את ערכי ברירת המחדל בשאר השדות.

5. לוחצים על יצירה.

gcloud

• יוצרים קטגוריה של Cloud Storage:

  gcloud storage buckets create gs://PROJECT_ID_MEDIA_BUCKET --location=REGION
  

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

אחסון ערכים סודיים ב-Secret Manager

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

יצירת קובץ סביבה של Django כסוד ב-Secret Manager

אתם שומרים את ההגדרות שנדרשות כדי להפעיל את Django בקובץ env מאובטח. האפליקציה לדוגמה משתמשת ב-Secret Manager API כדי לאחזר את ערך הסוד, ובחבילה django-environ כדי לטעון את הערכים לסביבת Django. הסוד מוגדר כך שתהיה גישה אליו מהסביבה הגמישה של App Engine.

1. יוצרים קובץ בשם .env, שמגדיר את מחרוזת החיבור למסד הנתונים, את שם הקטגוריה של המדיה וערך SECRET_KEY חדש:

   echo DATABASE_URL=postgres://DATABASE_USERNAME:DATABASE_PASSWORD@//cloudsql/PROJECT_ID:REGION:INSTANCE_NAME/DATABASE_NAME > .env
   echo GS_BUCKET_NAME=PROJECT_ID_MEDIA_BUCKET >> .env
   echo SECRET_KEY=$(cat /dev/urandom | LC_ALL=C tr -dc '[:alpha:]'| fold -w 50 | head -n1) >> .env
   

2. מאחסנים את הסוד ב-Secret Manager:

   המסוף

   1. נכנסים לדף Secret Manager במסוף Google Cloud .

      כניסה לדף Secret Manager

   2. לוחצים על Create secret.

   3. בשדה Name, מזינים django_settings.

   4. בתיבת הדו-שיח Secret value, מדביקים את התוכן של קובץ ה-.env.

   5. לוחצים על Create secret.

   6. מוחקים את הקובץ המקומי כדי למנוע שינוי של ההגדרות המקומיות.

   gcloud

   1. יוצרים סוד חדש, django_settings, עם הערך של הקובץ .env:

      gcloud secrets create django_settings --data-file .env
      

   2. כדי למנוע שינויים מקומיים בהגדרות, צריך למחוק את הקובץ המקומי:

      rm .env
      

3. מגדירים את הגישה לסוד:

   המסוף

   1. לוחצים על הכרטיסייה Permissions.
   2. לוחצים על הענקת גישה.
   3. בשדה רק הצטרפתי, מזינים את הערך [e-mail] ולוחצים על Enter.
   4. בתפריט הנפתח Role, בוחרים באפשרות Secret Manager Secret Accessor.
   5. לוחצים על Save.

   gcloud

   נותנים גישה לסוד לחשבון השירות של הסביבה הגמישה של App Engine:

     gcloud secrets add-iam-policy-binding django_settings \
         --member serviceAccount:[e-mail] \
         --role roles/secretmanager.secretAccessor
   

   בפלט, מוודאים שחשבון השירות החדש מופיע ב-bindings.

הפעלת האפליקציה במחשב המקומי

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

1. בטרמינל נפרד, מפעילים את Cloud SQL Auth Proxy:

   ‫Linux/macOS

   ./cloud-sql-proxy PROJECT_ID:REGION:INSTANCE_NAME
   

   Windows

   cloud-sql-proxy.exe PROJECT_ID:REGION:INSTANCE_NAME
   

   בשלב הזה נוצר חיבור מהמחשב המקומי למכונה של Cloud SQL למטרות בדיקה מקומית. חשוב להשאיר את Cloud SQL Auth Proxy פועל כל עוד אתם בודקים את האפליקציה באופן מקומי. אם מריצים את התהליך הזה בטרמינל נפרד, אפשר להמשיך לעבוד בזמן שהתהליך פועל.

2. בטרמינל המקורי, מגדירים את מזהה הפרויקט באופן מקומי (משמש את Secret Manager API):

   ‫Linux/macOS

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID
   

   Windows

   set GOOGLE_CLOUD_PROJECT=PROJECT_ID
   

3. מגדירים משתנה סביבה כדי לציין שאתם משתמשים ב-Cloud SQL Auth Proxy (הערך הזה מזוהה בקוד):

   ‫Linux/macOS

   export USE_CLOUD_SQL_AUTH_PROXY=true
   

   Windows

   set USE_CLOUD_SQL_AUTH_PROXY=true
   

4. מריצים את ההעברות של Django כדי להגדיר את המודלים והנכסים:

   python manage.py makemigrations
   python manage.py makemigrations polls
   python manage.py migrate
   python manage.py collectstatic
   

5. מפעילים את שרת האינטרנט של Django:

   python manage.py runserver 8080
   

6. בדפדפן, עוברים אל http://localhost:8080.

   אם אתם ב-Cloud Shell, לוחצים על הכפתור Web Preview ובוחרים באפשרות Preview on port 8080.

   בדף מופיע הטקסט הבא: "Hello, world. הגעת לאינדקס הסקרים". שרת האינטרנט של Django שפועל במחשב שלכם מספק את דפי האפליקציה לדוגמה.

7. מקישים על Ctrl/Cmd+C כדי לעצור את שרת האינטרנט המקומי.

שימוש במסוף Admin של Django

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

1. ליצור משתמש-על. תתבקשו להזין שם משתמש, כתובת אימייל וסיסמה.

   python manage.py createsuperuser
   

2. מפעילים שרת אינטרנט מקומי:

   python manage.py runserver
   

3. בדפדפן, נכנסים לכתובת http://localhost:8000/admin.

4. מתחברים לאתר האדמין באמצעות שם המשתמש והסיסמה שבהם השתמשתם כשהפעלתם את createsuperuser.

הערה: מכיוון שאתם מחוברים למסד הנתונים של Cloud SQL, אתם יכולים להתחבר לאפליקציית Django שנפרסה באמצעות אותם פרטי כניסה.

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

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

1. פותחים את app.yaml ומעדכנים את הערך של cloud_sql_instances במחרוזת של מכונת Cloud SQL:

   ...
   beta_settings:
       cloud_sql_instances: PROJECT_ID:REGION:INSTANCE_NAME
   

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

   gcloud app deploy

3. מאשרים את ההגדרות על ידי הקלדת "yes" כשמוצגת בקשה לעשות זאת.
4. מחכים להודעה שהעדכון הסתיים.

הפעלת האפליקציה שנפרסה

האפליקציה נפרסה, ועכשיו אפשר לגשת אליה:

• פותחים את האתר שנפרס:

  gcloud app browse
  

• אפשר גם להציג את כתובת ה-URL ולפתוח אותה באופן ידני:

  gcloud app describe --format "value(defaultHostname)"
  

הבקשה שלכם מטופלת על ידי שרת אינטרנט שפועל בסביבה גמישה ב-App Engine.

עדכון האפליקציה

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

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

הגדרה לסביבת ייצור

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

השבתת ניפוי הבאגים

מוודאים שהמשתנה DEBUG ב-mysite/settings.py מוגדר כ-False. כך המשתמש לא יראה דפי שגיאה מפורטים, שעלולים להדליף מידע על ההגדרות האישיות.

הגבלת הרשאות המשתמשים במסד הנתונים

לכל המשתמשים שנוצרים באמצעות Cloud SQL יש את ההרשאות שמשויכות לתפקיד cloudsqlsuperuser: CREATEROLE,‏ CREATEDB ו-LOGIN.

כדי למנוע ממשתמש מסד הנתונים של Django לקבל את ההרשאות האלה, צריך ליצור את המשתמש באופן ידני ב-PostgreSQL. צריך להתקין את הטרמינל האינטראקטיבי של psql, או להשתמש ב-Cloud Shell שבו הכלי הזה מותקן מראש.

המסוף

1. מפעילים את Cloud Shell במסוף Google Cloud .

   הפעלת Cloud Shell

2. ב-Cloud Shell, משתמשים בטרמינל המובנה כדי להתחבר למכונה של INSTANCE_NAME:

   gcloud sql connect INSTANCE_NAME --user postgres
   

3. מזינים את סיסמת המשתמש של postgres.

   המודל שלך כרגע הוא psql. אמורה להופיע ההנחיה postgres=>.

4. יצירת משתמש:

   CREATE USER DATABASE_USERNAME WITH PASSWORD 'DATABASE_PASSWORD';
   

   מחליפים את PASSWORD בסיסמה ייחודית ואקראית.

5. מעניקים למשתמש החדש הרשאות מלאות במסד הנתונים החדש:

   GRANT ALL PRIVILEGES ON DATABASE DATABASE_NAME TO DATABASE_USERNAME;
   

6. יציאה psql:

   \q
   

gcloud

הערה: לכל המשתמשים שנוצרו באמצעות Cloud SQL יש את ההרשאות שמשויכות לתפקיד cloudsqlsuperuser: CREATEROLE,‏ CREATEDB ו-LOGIN. במדריך הזה המשתמש נוצר ישירות ב-PostgreSQL.

1. מתחילים חיבור למכונה של SQL:

   gcloud sql connect INSTANCE_NAME --user postgres
   

   מחליפים את INSTANCE_NAME במכונה של Cloud SQL שנוצרה.

2. מזינים את סיסמת המשתמש של postgres.

   המודל שלך כרגע הוא psql. אמורה להופיע ההנחיה postgres=>.

3. יצירת משתמש:

   CREATE USER DATABASE_USERNAME WITH PASSWORD 'DATABASE_PASSWORD';
   

4. מעניקים למשתמש החדש הרשאות מלאות במסד הנתונים החדש:

   GRANT ALL PRIVILEGES ON DATABASE DATABASE_NAME TO DATABASE_USERNAME;
   

5. יציאה psql:

   \q
   

הבנת הקוד

אפליקציה לדוגמה

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

django-admin startproject mysite
python manage.py startapp polls

התצוגות, המודלים והגדרות הניתוב הבסיסיים הועתקו מהמדריך Writing your first Django app (חלק 1 וחלק 2).

סודות מ-Secret Manager

הקובץ settings.py מכיל קוד שמשתמש ב-API בשפת Python של Secret Manager כדי לאחזר את הגרסה העדכנית של הסוד שצוין, ולהעביר אותו לסביבה (באמצעות django-environ):

env = environ.Env(DEBUG=(bool, False))
env_file = os.path.join(BASE_DIR, ".env")

if os.path.isfile(env_file):
    # Use a local secret file, if provided

    env.read_env(env_file)
# ...
elif os.environ.get("GOOGLE_CLOUD_PROJECT", None):
    # Pull secrets from Secret Manager
    project_id = os.environ.get("GOOGLE_CLOUD_PROJECT")

    client = secretmanager.SecretManagerServiceClient()
    settings_name = os.environ.get("SETTINGS_NAME", "django_settings")
    name = f"projects/{project_id}/secrets/{settings_name}/versions/latest"
    payload = client.access_secret_version(name=name).payload.data.decode("UTF-8")

    env.read_env(io.StringIO(payload))
else:
    raise Exception("No local .env or GOOGLE_CLOUD_PROJECT detected. No secrets found.")

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

שינויים מקומיים מברירת המחדל של הסודות

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

חיבור למסד נתונים

הקובץ settings.py מכיל את ההגדרות של מסד הנתונים ב-SQL. הוא משתמש ברכיב העזר env.db() מ-django-environ כדי לטעון את מחרוזת החיבור שמוגדרת ב-DATABASE_URL להגדרה DATABASES.

כשמריצים את האפליקציה באופן מקומי ומשתמשים ב-Cloud SQL Auth Proxy כדי לגשת למסד הנתונים שמתארח, הדגל USE_CLOUD_SQL_AUTH_PROXY משנה את ההגדרות של מסד הנתונים כדי להשתמש בשרת ה-proxy.

# Use django-environ to parse the connection string
DATABASES = {"default": env.db()}

# If the flag as been set, configure to use proxy
if os.getenv("USE_CLOUD_SQL_AUTH_PROXY", None):
    DATABASES["default"]["HOST"] = "127.0.0.1"
    DATABASES["default"]["PORT"] = 5432

סטטי, מאוחסן בענן

הקובץ settings.py משתמש גם ב-django-storages כדי לשלב את קטגוריית המדיה של Cloud Storage ישירות בפרויקט:

# Define static storage via django-storages[google]
GS_BUCKET_NAME = env("GS_BUCKET_NAME")
STATIC_URL = "/static/"
STORAGES = {
    "default": {
        "BACKEND": "storages.backends.gcloud.GoogleCloudStorage",
    },
    "staticfiles": {
        "BACKEND": "storages.backends.gcloud.GoogleCloudStorage",
    },
}
GS_DEFAULT_ACL = "publicRead"

‫App Engine app.yaml

הקובץ app.yaml מכיל את פרטי ההגדרות לפריסה בסביבה הגמישה:

runtime: python
env: flex
entrypoint: gunicorn -b :$PORT mysite.wsgi

beta_settings:
    cloud_sql_instances: PROJECT_ID:REGION:INSTANCE_NAME

runtime_config:
  python_version: 3.7

הסרת המשאבים

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

מחיקת הפרויקט

זהירות: כשמוחקים פרויקט:

• התוכן של הפרויקט נמחק כולו. אם השתמשתם בפרויקט קיים כדי לתרגל את המשימות במדריך הזה, כשתמחקו אותו תימחק גם כל העבודה שביצעתם באותו פרויקט.
• מאבדים את מזהה הפרויקט בהתאמה אישית. כשיצרתם את הפרויקט, יכולתם לבחור לו מזהה פרויקט בהתאמה אישית כדי להשתמש בו בעתיד. כדי לשמור על כתובות ה-URL שמשתמשות במזהה הפרויקט, כמו appspot.com, צריך למחוק את המשאבים שנבחרו בפרויקט אבל לא את הפרויקט כולו.

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

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

   כניסה לדף Manage resources

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

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

• איך מגדירים את PostgreSQL לסביבת הייצור
• מידע נוסף על Django ב- Google Cloud