תחילת העבודה עם Python ב-Compute Engine

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

מטרות

• שימוש ב-Cloud Shell להורדה ולפריסה של אפליקציית Hello World לדוגמה.
• פריסת אפליקציית Hello World לדוגמה במכונה וירטואלית אחת ב-Compute Engine.

עלויות

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

• Compute Engine

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

משתמשים חדשים של 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 Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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 Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. במסוף Google Cloud , פותחים את האפליקציה ב-Cloud Shell.

   כניסה ל-Cloud Shell

   ‫Cloud Shell מספק גישה למשאבי הענן שלכם דרך שורת הפקודה ישירות מהדפדפן.

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

3. ב-Cloud Shell, מגדירים את ה-CLI של gcloud לשימוש בפרויקט החדש Google Cloud :

   # Configure gcloud for your project
   gcloud config set project YOUR_PROJECT_ID

הפעלת האפליקציה ב-Cloud Shell

1. ב-Cloud Shell, מתקינים את יחסי התלות של האפליקציה באמצעות pip:

   pip3 install -r requirements.txt --user
   

2. מתקינים את שרת ה-HTTP של Gunicorn:

   pip3 install gunicorn --user
   

3. מריצים את שרת ה-HTTP של Gunicorn:

   ~/.local/bin/gunicorn -b :8080 main:app
   

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

5. כדי לעצור את שרת האינטרנט המקומי, מקישים על Control+C.

פריסה למופע יחיד

בקטע הזה מוסבר איך להריץ מופע יחיד של האפליקציה ב-Compute Engine.

מ-Cloud Shell, אפשר לבצע פריסה למכונה וירטואלית (VM) של Compute Engine שבה האפליקציה פועלת.

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

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

# Install or update needed software
apt-get update
apt-get install -yq git supervisor python python-pip python3-distutils
pip install --upgrade pip virtualenv

# Fetch source code
export HOME=/root
git clone https://github.com/GoogleCloudPlatform/getting-started-python.git /opt/app

# Install Cloud Ops Agent
sudo bash /opt/app/gce/add-google-cloud-ops-agent-repo.sh --also-install

# Account to own server process
useradd -m -d /home/pythonapp pythonapp

# Python environment setup
virtualenv -p python3 /opt/app/gce/env
/bin/bash -c "source /opt/app/gce/env/bin/activate"
/opt/app/gce/env/bin/pip install -r /opt/app/gce/requirements.txt

# Set ownership to newly created account
chown -R pythonapp:pythonapp /opt/app

# Put supervisor configuration in proper place
cp /opt/app/gce/python-app.conf /etc/supervisor/conf.d/python-app.conf

# Start service via supervisorctl
supervisorctl reread
supervisorctl update

סקריפט לטעינה בזמן ההפעלה מבצע את המשימות הבאות:

• מערכת ההפעלה תתקין את Python 3 ואת Pip.

• התקנת סוכן Cloud Logging. הסוכן אוסף באופן אוטומטי יומנים מ-syslog.

• האפליקציה Supervisor מותקנת כדי להפעיל את האפליקציה כדמון.

• משכפל את קוד המקור של האפליקציה מ-Cloud Source Repositories ומתקין תלויות.

• מגדיר את Supervisor להרצת האפליקציה. Supervisor מוודא שהאפליקציה תופעל מחדש אם היא נסגרת באופן לא צפוי או אם היא מסתיימת על ידי אדמין או תהליך אחר. הוא גם שולח את stdout וstderr של האפליקציה ל-syslog כדי שהסוכן של Logging יאסוף אותם.

יצירה והגדרה של מכונה של Compute Engine

1. יצירת מכונה של Compute Engine:

   ‫Linux/macOS

   MY_INSTANCE_NAME="my-app-instance"
   ZONE=us-central1-a
   
   gcloud compute instances create $MY_INSTANCE_NAME \
       --image-family=debian-10 \
       --image-project=debian-cloud \
       --machine-type=g1-small \
       --scopes userinfo-email,cloud-platform \
       --metadata-from-file startup-script=startup-script.sh \
       --zone $ZONE \
       --tags http-server

   Windows

   gcloud compute instances create my-app-instance ^
       --image-family=debian-9 ^
       --image-project=debian-cloud ^
       --machine-type=g1-small ^
       --scopes userinfo-email,cloud-platform ^
       --metadata-from-file startup-script=gce/startup-script.sh ^
       --zone us-central1-f ^
       --tags http-server
   

   מחליפים את האזור באזור פיתוח, למשל us-central1-a. מידע נוסף על אזורים ותחומים זמין במאמר מיקום גיאוגרפי ואזורים.

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

2. בודקים את התקדמות יצירת המופע:

   gcloud compute instances get-serial-port-output my-app-instance --zone YOUR_ZONE
   

   מחליפים את YOUR_ZONE בתחום (zone) שבו פרסתם את המכונה.

   בסיום סקריפט לטעינה בזמן ההפעלה, תוצג ההודעה הבאה:

   startup-script: INFO Finished running startup scripts.
   

3. יוצרים כלל חומת אש שמאפשר תעבורת נתונים למופע:

   gcloud compute firewall-rules create default-allow-http-8080 \
       --allow tcp:8080 \
       --source-ranges 0.0.0.0/0 \
       --target-tags http-server \
       --description "Allow port 8080 access to http-server"
   

4. מקבלים את כתובת ה-IP החיצונית של המופע:

   gcloud compute instances list
   

5. כדי לראות את האפליקציה פועלת, מזינים את כתובת ה-URL הזו בדפדפן:

   http://YOUR_INSTANCE_IP:8080
   

   מחליפים את הערך YOUR_INSTANCE_IP בכתובת ה-IP החיצונית של המכונה.

ניהול של אירוע ומעקב אחריו

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

1. נכנסים לדף VM instances במסוף Google Cloud .

   כניסה לדף VM instances

2. ברשימת המכונות הווירטואליות, לוחצים על SSH בשורה של המכונה שרוצים להתחבר אליה.

3. כדי לראות את כל היומנים שנוצרו על ידי משאבי Compute Engine, עוברים לדף Logs Explorer.

   כניסה לדף Logs Explorer

   Cloud Logging מוגדר באופן אוטומטי לאיסוף יומנים משירותים נפוצים שונים, כולל syslog.

הסרת המשאבים

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

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

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

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

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

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

   כניסה לדף Manage resources

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

מחיקת המשאבים הבודדים

gcloud compute instances delete my-app-instance --zone=YOUR_ZONE --delete-disks=all
gcloud compute firewall-rules delete default-allow-http-8080

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

• יצירת קבוצות של מופעי מכונה מנוהלים
• יוצרים מאזן עומסים.
• איך מטפלים בסשנים באמצעות Firestore
• הוספת עיבוד ברקע באמצעות Pub/Sub ו-Cloud Run.
• פריסת אפליקציה ב-Google Kubernetes Engine
• אימות משתמשים באמצעות שרת proxy לאימות זהויות (IAP).