תחילת העבודה עם אירוח אפליקציות

באמצעות אפליקציית Next.js או Angular קיימת (בגרסאות Next.js בגרסה 13 ואילך או בגרסה Angular 17.2 ואילך) במאגר ב-GitHub, אפשר להתחיל עם App Hosting ממש כמו יצירת קצה עורפי של App Hosting, ואז התחלת השקה באמצעות דחיפה להסתעפות הפעילה. אם אין לכם אפליקציה, תוכלו להשתמש באחת מהאפליקציות לדוגמה שלנו כדי לבצע את השלבים שמפורטים במדריך הזה.

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

כדי להגדיר את Firebase App Hosting צריך ליצור פרויקט Firebase (אם עדיין אין לכם) ולשדרג לתוכנית Blaze.

כדי ליצור פרויקט:

  1. במסוף Firebase, לוחצים על Add project.

    • כדי להוסיף משאבים של Firebase לפרויקט Google Cloud קיים, מזינים את שם הפרויקט או בוחרים אותו מהתפריט הנפתח.

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

  2. אם תופיע בקשה, קוראים את התנאים של Firebase ומאשרים אותם.

  3. לוחצים על המשך.

  4. (אופציונלי) מגדירים את Google Analytics בפרויקט כדי ליהנות מחוויית שימוש אופטימלית בכל אחד מהמוצרים הבאים של Firebase:

    בוחרים חשבון Google Analytics קיים או יוצרים חשבון חדש.

    אם יוצרים חשבון חדש, בוחרים את Analytics מיקום הדיווח ולאחר מכן מאשרים את ההגדרות של שיתוף הנתונים ואת התנאים של Google Analytics לפרויקט.

  5. לוחצים על Create project (או על Add Firebase, אם משתמשים בפרויקט Google Cloud קיים).

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

שלב 0 (אופציונלי): יצירת מאגר ו-Web App ב-GitHub

אם עדיין אין לכם אפליקציית אינטרנט שמאוחסנת במאגר GitHub, או אם אתם מעדיפים לנסות את התהליך עם אפליקציה לדוגמה, תחילה צריך לאתחל אחת מהדוגמאות שלנו ל-Next.js או ל-Angular:

npm init @apphosting

אפשר להריץ את אפליקציית הדוגמה באופן מקומי באמצעות next dev או ng start. כדי להמשיך, צריך ליצור מאגר חדש ב-GitHub ולהעביר אליו את הקוד לדוגמה שהפעלתם.

שלב 1: יצירת קצה עורפי של App Hosting

הקצה העורפי של App Hosting הוא האוסף של המשאבים המנוהלים שנוצרים על ידי App Hosting כדי ליצור ולהפעיל את אפליקציית האינטרנט. אפשר ליצור ולפרט את הקצוות העורפיים של App Hosting באמצעות מסוף Firebase או CLI של Firebase.

מסוף Firebase: בתפריט Build, בוחרים App Hosting (אירוח אפליקציות) ואז Get started (תחילת העבודה).

CLI: (גרסה 13.15.4 ואילך) כדי ליצור קצה עורפי, מריצים את הפקודה הבאה מהשורש של ספריית הפרויקט המקומי, ומספקים את projectID ואת region המועדף כארגומנטים:

firebase apphosting:backends:create --project PROJECT_ID --location us-central1

במסוף או ב-CLI, פועלים לפי ההנחיות כדי להקצות שם לקצה העורפי, להגדיר חיבור ל-GitHub ולהגדיר את הגדרות הפריסה הבסיסיות הבאות:

  • מגדירים את ספריית השורש של האפליקציה (ברירת המחדל היא /)

    בדרך כלל זהו המיקום של הקובץ package.json.

  • מגדירים את ההסתעפות הפעילה.

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

  • אישור או דחייה של השקות אוטומטיות

    השקות אוטומטיות מופעלות כברירת מחדל. בסיום יצירת הקצה העורפי, תוכלו לבחור לפרוס את האפליקציה ב-App Hosting באופן מיידי.

שלב 2: מציגים את האפליקציה שנפרסה

כשיוצרים קצה עורפי, Firebase נותן תת-דומיין ללא עלות שבאמצעותו משתמשי הקצה יכולים להיכנס לאפליקציית האינטרנט שלכם. הפורמט שלו הוא backend-id--project-id.us-central1.hosted.app.

כדי להציג את כתובת ה-URL של אפליקציית האינטרנט, אפשר לבדוק במסוף Firebase או להריץ את הפקודה הבאה ב-CLI:

firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID} --location us-central1

שלב 3: הפעלת השקה על ידי דחיפת שינוי

אחרי שיוצרים את הקצה העורפי ויש כתובת URL פעילה, אפשר להפעיל את ההשקה של גרסה חדשה של אפליקציית האינטרנט בכל פעם שדוחפים שינויים להסתעפות הפעילה של מאגר GitHub. כדי לבצע בדיקה של ההגדרה של App Hosting:

  1. ב-GitHub, מעבירים שינוי להסתעפות הפעילה של אפליקציית האינטרנט.
  2. פותחים את הכרטיסייה App Hosting במסוף Firebase ובוחרים באפשרות View dashboard לקצה העורפי. ברשימה בטבלה מוצגת ההתחייבות הספציפית שמשויכת להשקה שהתרחשה בעקבות השינוי.

השלבים הבאים