לפני הפריסה לאתר החי שלך, תרצה להציג ולבדוק את השינויים שלך. Firebase Hosting מאפשר לך להציג ולבדוק שינויים באופן מקומי ולקיים אינטראקציה עם משאבי פרויקט עורפי מחקו. אם אתה צריך את חברי הצוות שלך כדי להציג ולבדוק את השינויים שלך, אירוח יכול ליצור כתובות אתרים זמניות לתצוגה מקדימה עבור האתר שלך. אנו אפילו תומכים באינטגרציה של GitHub לפריסה מבקשת משיכה.
לפני שאתה מתחיל
השלם את השלבים המפורטים בדף התחלת אירוח , במיוחד את המשימות הבאות:
- התקן או עדכן את Firebase CLI לגרסה האחרונה שלו.
- חבר את ספריית הפרויקט המקומית (המכילה את תוכן האפליקציה שלך) לפרויקט Firebase שלך.
אתה יכול לפרוס את תוכן האחסון ואת התצורה של האפליקציה שלך, אבל זה לא תנאי מוקדם לשלבים בדף זה.
שלב 1: בדיקה מקומית
אם אתה מבצע איטרציות מהירות או שאתה רוצה שהאפליקציה שלך תיצור אינטראקציה עם משאבי פרויקט אחורי מדומה, תוכל לבדוק את תוכן האירוח שלך ולהגדיר באופן מקומי. בעת בדיקה מקומית, Firebase מגיש את אפליקציית האינטרנט שלך בכתובת אתר שמתארחת באופן מקומי.
אירוח הוא חלק מחבילת ה-Firebase Local Emulator Suite , המאפשרת לאפליקציה שלך לקיים אינטראקציה עם תוכן אירוח ותצורת אמולציה שלך, כמו גם עם משאבי הפרויקט המחויכים שלך (פונקציות, מסדי נתונים וכללים).
(אופציונלי) כברירת מחדל, האפליקציה המתארחת המקומית שלך תקיים אינטראקציה עם משאבי פרויקט אמיתיים , לא חקוקים (פונקציות, מסד נתונים, כללים וכו'). במקום זאת, אופציונלי, אתה יכול לחבר את האפליקציה שלך כדי להשתמש בכל משאבי פרויקט חיקוי שהגדרת. למידע נוסף: מסד נתונים בזמן אמת | Cloud Firestore | פונקציות ענן
מהשורש של ספריית הפרויקט המקומית שלך, הפעל את הפקודה הבאה:
firebase emulators:start
פתח את אפליקציית האינטרנט שלך בכתובת האתר המקומית המוחזרת על ידי ה-CLI (בדרך כלל
http://localhost:5000
).כדי לעדכן את כתובת האתר המקומית עם שינויים, רענן את הדפדפן.
בדוק ממכשירים מקומיים אחרים
כברירת מחדל, האמולטורים מגיבים רק לבקשות מ- localhost
. משמעות הדבר היא שתוכל לגשת לתוכן המתארח שלך מדפדפן האינטרנט של המחשב שלך, אך לא מהתקנים אחרים ברשת שלך. אם תרצה לבדוק מהתקנים מקומיים אחרים, הגדר את firebase.json
שלך כך:
"emulators": {
// ...
"hosting": {
"port": 5000
"host": "0.0.0.0"
}
}
בעת שימוש firebase serve
, האפליקציה שלך מקיימת אינטראקציה עם קצה אחורי מדומה עבור תוכן ותצורת האירוח שלך (ואופציונלי פונקציות) אבל הקצה האחורי האמיתי שלך עבור כל משאבי הפרויקט האחרים.
מהשורש של ספריית הפרויקט המקומית שלך, הפעל את הפקודה הבאה:
firebase serve --only hosting
פתח את אפליקציית האינטרנט שלך בכתובת האתר המקומית המוחזרת על ידי ה-CLI (בדרך כלל
http://localhost:5000
).כדי לעדכן את כתובת האתר המקומית עם שינויים, רענן את הדפדפן.
השתמש firebase serve
כדי לבדוק ממכשירים מקומיים אחרים
כברירת מחדל, firebase serve
מגיב רק לבקשות מ- localhost
. משמעות הדבר היא שתוכל לגשת לתוכן המתארח שלך מדפדפן האינטרנט של המחשב שלך, אך לא מהתקנים אחרים ברשת שלך. אם תרצה לבדוק ממכשירים מקומיים אחרים, השתמש בדגל --host
, כך:
firebase serve --host 0.0.0.0 // accepts requests to any host
שלב 2: תצוגה מקדימה ושתף
אם אתה רוצה שאחרים יצפו בשינויים באפליקציית האינטרנט שלך לפני העלייה לאוויר, תוכל להשתמש בערוצי תצוגה מקדימה.
לאחר הפריסה לערוץ תצוגה מקדימה, Firebase מגיש את אפליקציית האינטרנט שלך ב"כתובת אתר תצוגה מקדימה", שהיא כתובת URL זמנית הניתנת לשיתוף. בעת שימוש ב-URL תצוגה מקדימה, אפליקציית האינטרנט שלך מקיימת אינטראקציה עם הקצה העורפי האמיתי שלך עבור כל משאבי הפרויקט (למעט כל פונקציות "מוצמדות" בתצורת השכתובים שלך ).
שים לב שלמרות שקשה לנחש כתובות אתרים של תצוגה מקדימה (כיוון שהן מכילות hash אקראי), הן ציבוריות. אז כל מי שמכיר את כתובת האתר יכול לגשת אליה.
מהשורש של ספריית הפרויקט המקומית שלך, הפעל את הפקודה הבאה:
firebase hosting:channel:deploy CHANNEL_ID
החלף CHANNEL_ID במחרוזת ללא רווחים (לדוגמה,
feature_mission-2-mars
). המזהה הזה ישמש לבניית כתובת ה-URL של התצוגה המקדימה המשויכת לערוץ התצוגה המקדימה.פתח את אפליקציית האינטרנט שלך בכתובת ה-URL של התצוגה המקדימה שהוחזרה על ידי ה-CLI. זה ייראה בערך כך:
PROJECT_ID -- CHANNEL_ID - RANDOM_HASH .web.app
כדי לעדכן את כתובת האתר של התצוגה המקדימה שלך בשינויים, הפעל שוב את אותה פקודה. הקפד לציין את אותו
CHANNEL_ID
בפקודה.
למד על ניהול ערוצי תצוגה מקדימה , כולל כיצד להגדיר תפוגה של ערוץ.
Firebase Hosting תומך בפעולת GitHub שיוצרת ומעדכנת באופן אוטומטי כתובת URL לתצוגה מקדימה כאשר אתה מבצע שינויים בבקשת משיכה. למד כיצד להגדיר ולהשתמש בפעולת GitHub זו .
שלב 3: פרוס בשידור חי
כשתהיה מוכן לשתף את השינויים שלך עם העולם, פרוס את תוכן האירוח שלך והגדר לערוץ החי שלך. Firebase מציעה כמה אפשרויות שונות עבור שלב זה בהתאם למקרה השימוש שלך (ראה אפשרויות למטה).
אפשרות 1: שכפול מערוץ תצוגה מקדימה לערוץ החי שלך
אפשרות זו מספקת ביטחון שאתה פורס בערוץ החי שלך את התוכן והתצורה המדויקים שבדקת בערוץ תצוגה מקדימה. למידע נוסף על גירסאות שיבוט .
מכל ספריה, הפעל את הפקודה הבאה:
firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:live
החלף כל מציין מיקום בדברים הבאים:
SOURCE_SITE_ID ו- TARGET_SITE_ID : אלו הם המזהים של אתרי האירוח המכילים את הערוצים.
- עבור אתר האירוח המוגדר כברירת מחדל, השתמש במזהה הפרויקט שלך ב-Firebase.
- אתה יכול לציין אתרים שנמצאים באותו פרויקט Firebase או אפילו בפרויקטים שונים של Firebase.
SOURCE_CHANNEL_ID : זהו המזהה של הערוץ שמשרת כעת את הגרסה שברצונך לפרוס בערוץ החי שלך.
- לערוץ חי, השתמש
live
כמזהה הערוץ.
- לערוץ חי, השתמש
הצג את השינויים שלך (השלב הבא).
אפשרות 2: פרוס מספריית הפרויקט המקומית שלך לערוץ החי שלך
אפשרות זו מספקת לך גמישות להתאים תצורות ספציפיות לערוץ החי או לפריסה גם אם לא השתמשת בערוץ תצוגה מקדימה.
מהשורש של ספריית הפרויקט המקומית שלך, הפעל את הפקודה הבאה:
firebase deploy --only hosting
הצג את השינויים שלך (השלב הבא).
שלב 4: הצג את השינויים שלך באתר החי שלך
שתי האפשרויות לעיל לפרוס את תוכן האירוח שלך ולהגדיר לאתרים הבאים:
תת-הדומיינים שסופקו על ידי Firebase עבור אתר האירוח המוגדר כברירת מחדל וכל אתרי אירוח נוספים:
SITE_ID .web.app
(כמוPROJECT_ID .web.app
)
SITE_ID .firebaseapp.com
(כמוPROJECT_ID .firebaseapp.com
)כל הדומיינים המותאמים אישית שחיברת לאתרי האירוח שלך
כדי להגביל את הפריסה לאתר אירוח ספציפי, ציין יעד פריסה בפקודת ה-CLI שלך.
פריסה אחרת של פעילויות ומידע
הוסף הערה עבור הפריסה
ניתן להוסיף הערה לפריסה באופן אופציונלי. הערה זו תוצג יחד עם מידע הפריסה האחר בלוח המחוונים של אירוח במסוף Firebase. לדוגמה:
firebase deploy --only hosting -m "Deploying the best new feature ever."
הוסף משימות סקריפטים מראש ואחרי פריסה
באפשרותך לחבר סקריפטים מעטפת לפקודת ה- firebase deploy
כדי לבצע משימות קדם-פריסה או לאחר-פריסה. לדוגמה, הוק לאחר פריסה יכול להודיע למנהלי מערכת על פריסת תוכן אתר חדש. עיין בתיעוד Firebase CLI לפרטים נוספים.
שמירה במטמון של תוכן שנפרס
כאשר מוגשת בקשה לתוכן סטטי , Firebase Hosting מאחסן באופן אוטומטי את התוכן ב-CDN. אם תפרוס מחדש את תוכן האתר שלך, Firebase מנקה אוטומטית את כל התוכן הסטטי השמור שלך ב-CDN כך שבקשות חדשות יקבלו את התוכן החדש שלך.
שים לב שאתה יכול להגדיר את שמירה במטמון של תוכן דינמי .
הגשה באמצעות HTTPS
ודא שכל המשאבים החיצוניים שאינם מתארחים ב-Firebase Hosting נטענים באמצעות SSL (HTTPS), כולל סקריפטים חיצוניים. רוב הדפדפנים אינם מאפשרים למשתמשים לטעון "תוכן מעורב" (תעבורת SSL ולא SSL).
הצעדים הבאים
שלב עם GitHub וחזר על התוכן התצוגה המקדימה שלך על ידי הגדרת פעולת GitHub .
למד על יכולות אירוח נוספות:
עיין בתיעוד המלא עבור Firebase CLI .
היכונו להפעלת האפליקציה שלכם:
- הגדר התראות תקציב עבור הפרויקט שלך ב-Google Cloud Console.
- עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים. אתה יכול גם לבקר בלוח המחוונים של שימוש באחסון למידע מפורט יותר על שימוש.
- עיין ברשימת המשימות להפעלת Firebase .