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

אם יש לכם אפליקציית 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 לקצה העורפי. ברשימה בטבלה מוצגת ההתחייבות הספציפית שמשויכת להשקה שהתרחשה בעקבות השינוי.

השלבים הבאים