אירוח אתר סטטי ב-App Engine

מזהה אזור

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

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

אפשר להשתמש ב-App Engine כדי לארח אתר סטטי. דפי אינטרנט סטטיים יכולים להכיל טכנולוגיות בצד הלקוח, כמו HTML, ‏ CSS ו-JavaScript. אירוח אתר סטטי ב-App Engine יכול להיות זול יותר משימוש בספק אירוח מסורתי, כי הסביבה הרגילה של App Engine מספקת תוכנית בחינם.

אתרים שמתארחים ב-App Engine מתארחים בתת-הדומיין REGION_ID.r.appspot.com, למשל [my-project-id].uc.r.appspot.com. אחרי פריסת האתר, אפשר למפות את שם הדומיין שלכם לאתר שמתארח ב-App Engine.

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

כדי לארח את האתר ב-App Engine:

  1. יוצרים פרויקט חדש במסוף Google Cloud או מאחזרים את מזהה הפרויקט של פרויקט קיים לשימוש:

    כניסה לדף Projects

  2. מתקינים את Google Cloud CLI ומפעילים אותו:

    הורדת ה-SDK

יצירת אתר לאירוח ב-Google App Engine

המבנה הבסיסי של הפרויקט

הפרויקט במדריך הזה בנוי בצורה הבאה:

  • ‫app.yaml: הגדרת ההגדרות של אפליקציית App Engine.
  • ‫www/: ספרייה לאחסון כל הקבצים הסטטיים, כמו HTML,‏ CSS, תמונות ו-JavaScript.
    • ‫css/: ספרייה לאחסון של גיליונות סגנונות.
      • ‫style.css: גיליון סגנונות בסיסי שמעצב את המראה והתחושה של האתר.
    • ‫images/: ספרייה אופציונלית לאחסון תמונות.
    • ‫index.html: קובץ HTML שמציג תוכן באתר.
    • ‫js/: ספרייה אופציונלית לאחסון קובצי JavaScript.
    • ספריות נכסים אחרות.

יצירת הקובץ app.yaml

קובץ app.yaml הוא קובץ תצורה שמציין ל-App Engine איך למפות כתובות URL לקבצים סטטיים. בשלבים הבאים תוסיפו פונקציות לטיפול באירועים שיטענו את www/index.html כשמישהו יבקר באתר, וכל הקבצים הסטטיים יאוחסנו בספרייה www וייקראו ממנה.

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

  1. יוצרים ספרייה עם שם זהה למזהה הפרויקט. אפשר למצוא את מזהה הפרויקט במסוף.
  2. בספרייה שיצרתם, יוצרים קובץ בשם app.yaml.

  3. עורכים את קובץ app.yaml ומוסיפים את רכיב ה-handlers בהתאם לדרישות של האתר. לדוגמה, אפשר ליצור קובץ app.yaml עבור זמן ריצה של Python באופן הבא:

    runtime: python314

handlers:
- url: /
  static_files: www/index.html
  upload: www/index.html

- url: /(.*)
  static_files: www/\1
  upload: www/(.*)

מידע נוסף על קובץ app.yaml זמין במאמרי העזרה של app.yaml.

יצירת הקובץ index.html

יוצרים קובץ HTML שיוצג כשמשתמשים ינווטו לדף הבסיסי באתר. מאחסנים את הקובץ בספרייה www.

<html>
  <head>
    <title>Hello, world!</title>
    <link rel="stylesheet" type="text/css" href="/css/style.css">
  </head>
  <body>
    <h1>Hello, world!</h1>
    <p>
      This is a simple static HTML file that will be served from Google App
      Engine.
    </p>
  </body>
</html>

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

כשפורסים את קובצי האפליקציה, האתר שלכם מועלה ל-App Engine. כדי לפרוס את האפליקציה, מריצים את הפקודה הבאה מתוך תיקיית השורש של האפליקציה, שבה נמצא הקובץ app.yaml:

gcloud app deploy

דגלים אופציונליים:

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

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

צפייה בבקשה

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

gcloud app browse

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

הצגת אתר שמתארח ב-App Engine מדומיין מותאם אישית.