מזהה אזור
REGION_ID הוא קוד מקוצר ש-Google מקצה על סמך האזור שבוחרים כשיוצרים את האפליקציה. הקוד לא תואם למדינה או למחוז, למרות שחלק ממזהי האזורים עשויים להיראות דומים לקודים נפוצים של מדינות ומחוזות. באפליקציות שנוצרו אחרי פברואר 2020, המחרוזת REGION_ID.r כלולה בכתובות ה-URL של App Engine. באפליקציות קיימות שנוצרו לפני התאריך הזה, מזהה האזור הוא אופציונלי בכתובת ה-URL.
בקטע הזה במדריך נסביר איך להשתמש ב-CLI של gcloud כדי לפרוס את שירות האינטרנט של Node.js ב-App Engine. מידע נוסף על סביבת זמן הריצה של Node.js זמין במאמר סביבת זמן הריצה של Node.js.
לפני שמתחילים
- יוצרים פרויקט Google Cloud עם אפליקציית App Engine.
- כתיבת שרת אינטרנט ב-Node.js שמוכן לפריסה ב-App Engine
- מתקינים את Google Cloud CLI, שמספק את כלי שורת הפקודה
gcloud. מוודאים ש-gcloudמוגדר לשימוש בפרויקט Google Cloud שאליו רוצים לפרוס.
נקודות עיקריות
משתמשים ב-gcloud app deploy וב-gcloud app browse כדי לפרוס את השירות ולצפות בו.
פריסת השירות
בתיקייה my-nodejs-service, שבה נמצא הקובץ app.yaml, מריצים את הפקודה הבאה במסוף:
gcloud app deploy
אחר כך קובצי המקור מועלים ל-Google Cloud Storage. Cloud Build בונה את האפליקציה ופורס אותה ב-App Engine.
במאמר בדיקה ופריסה של האפליקציה מוסבר על דרכים אחרות לבנייה ולפריסה של האפליקציה.
אם אין לכם קובץ כזה, נוצר קובץ .gcloudignore כדי לוודא שהתיקייה node_modules לא תועלה.
מודולים של Node.js מותקנים בענן כמו שמופיע בקובצי package.json ו-package-lock.json, והשירות מופעל באמצעות npm start.
פריסת כמה שירותים
אפשר להוסיף כמה שירותים לפרויקט על ידי יצירת קובץ app.yaml לכל שירות. צריך לכלול את המאפיין service בכל קובץ app.yaml כדי לציין את שם השירות.
במאמר Structuring Web Services in App Engine (ארגון שירותי אינטרנט ב-App Engine) מוסבר איך לארגן את האפליקציה באמצעות כמה שירותים.
כדי לפרוס כמה שירותים, פועלים לפי ההוראות האלה. לכל שירות שפורס תוקצה כתובת URL משלו.
צפייה בשירות
כדי להפעיל במהירות את הדפדפן ולגשת לשירות האינטרנט בכתובת https://PROJECT_ID.REGION_ID.r.appspot.com, משתמשים בפקודה הבאה:
gcloud app browse
שירותים וגרסאות
הרגע יצרתם ופרסתם שירות ב-App Engine.
אפשר לציין את שם השירות בקובץ app.yaml. אם משמיטים את השם, המערכת מתייחסת אליו כאילו הוא default. השירות הראשון שפורסים חייב להיות שירות ברירת המחדל.
אפשר לעדכן את השירות בכל שלב על ידי הפעלת הפקודה gcloud app deploy שוב. בכל פעם שמבצעים פריסה, נוצרת גרסה חדשה והתנועה מנותבת אוטומטית לגרסה האחרונה.
כדי לוודא שהשירות נוצר וגרסה שלו נפרסה:
כדי לראות את השירותים של App Engine במסוף Google Cloud :
אמור להופיע שירות אחד בשם
default. שירות ברירת המחדל נגיש לכולם בכתובת ה-URL הבאה:https://PROJECT_ID.REGION_ID.r.appspot.comכדי לראות את הגרסאות:
אמורה להופיע גרסה אחת עם חותמת זמן, שמתאימה לפריסה שלכם.
במאמר איך בקשות מנותבות מוסבר איך לשלוח בקשות לשירותים ולגרסאות ספציפיים.
השלבים הבאים
אחרי ששרת Node.js פועל ב-App Engine, כך מעדכנים את שירות האינטרנט.