ניהול שידורים חיים & תצוגה מקדימה של ערוצים, גרסאות וגרסאות של האתר

‫Firebase Hosting מספקת כלים לניהול הערוצים, הגרסאות והמהדורות של האתר שלכם דרך מסוף Firebase ו-CLI של Firebase.Hosting

סקירה כללית על התשתית של Hosting

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

לכל פרויקט ב-Firebase יש Hosting אתר שמוגדר כברירת מחדל עם גישה לכל המשאבים של הפרויקט (מסדי נתונים, אימות, פונקציות וכו'). אתר מכיל ערוץ אחד או יותר, כאשר כל ערוץ משויך לכתובת URL שמציגה תוכן ספציפי ולהגדרה של Hosting.

Firebase Hosting hierarchy" />

לכל אתר Hosting יש ערוץ 'פעיל' שמציג תוכן וHostingהגדרות ב-(1) תתי-הדומיין שהוקצו לאתר ב-Firebase (SITE_ID.web.app ו-SITE_ID.firebaseapp.com) וב-(2) כל דומיין בהתאמה אישית שמקושר לאתר. אפשר גם ליצור ערוצי 'תצוגה מקדימה' אופציונליים שמציגים תוכן והגדרות משלהם בכתובות URL זמניות של 'תצוגה מקדימה' שאפשר לשתף (SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app).

התוכן וההגדרות שמוצגים בכל ערוץ נארזים באובייקט version עם מזהה ייחודי. כשמבצעים פריסה באתר, מערכת Firebase יוצרת אובייקט release שמפנה לגרסה ספציפית. גרסה מכילה מטא-נתונים על הפריסה, כמו מי פרס את הגרסה ומתי.

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

ניהול ההגדרות של הערוץ

אתם יכולים לשלוט בהגדרות של כל ערוץ באתר. חלק מההגדרות, כמו תפוגה של ערוץ, רלוונטיות רק לערוצי טרום-השקה.

הגבלת מספר הגרסאות לשמירה

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

• למה Hosting שומר גרסאות קודמות?
  בערוץ בשידור חי, שמירת הגרסאות הקודמות מאפשרת לכם לחזור לגרסה קודמת של האתר, אם יש צורך בכך. עדיין אי אפשר לבצע חזרה לגרסה קודמת בערוצי התצוגה המקדימה.

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

• מה קורה כשמגבילים את מספר הגרסאות שרוצים לשמור?
  כשמגדירים מגבלה על מספר הגרסאות שרוצים לשמור, התוכן של כל הגרסאות שחורגות מהמגבלה מתוזמן למחיקה, החל מהגרסאות הכי ישנות.

כך מגדירים את מגבלת האחסון של גרסה בערוץ:

1. במסוף Firebase, עוברים אל Hosting & Serverless > Hosting כדי לגשת לתיבת הדו-שיח של הגדרת האחסון של הגרסה:

   • בערוץ בשידור חי
     בטבלה Release History (היסטוריית הגרסאות) באתר, לוחצים על more_vert ואז בוחרים באפשרות Release storage settings (הגדרות אחסון של גרסאות).

   • לכל ערוץ תצוגה מקדימה
     בשורה של ערוץ התצוגה המקדימה, לוחצים עלmore_vert ואז בוחרים באפשרות הגדרות הערוץ.

2. מזינים את מספר הפריטים שרוצים לשמור ולוחצים על שמירה.

הגדרת תפוגה לערוץ בגרסת טרום-הפצה

כברירת מחדל, התוקף של ערוץ בתצוגה מקדימה פג 7 ימים מתאריך היצירה שלו, אבל התוקף של הערוץ הפעיל באתר שלכם לא פג לעולם.

כשערוץ בתצוגה מקדימה מפסיק לפעול, הערוץ, יחד עם הגרסאות והמהדורות שמשויכות אליו, מתוזמנים למחיקה תוך 24 שעות. גם כתובת ה-URL המשויכת לתצוגה המקדימה מושבתת. חריג למחיקת הגרסה הוא אם גרסה משויכת לגרסה להפצה אחרת (זה קורה, למשל, אם משכפלים גרסה מערוץ אחד לערוץ אחר באותו אתר).

‫Hosting תומך בשתי דרכים שונות לשליטה בתוקף של ערוץ:

• מסוף Firebase
  בשורה של ערוץ הטרום-הפצה, לוחצים על more_vert ואז בוחרים באפשרות הגדרות הערוץ. מזינים את התאריך והשעה של התפוגה.

• ‫Firebase CLI ‫
  כשפורסים לערוץ התצוגה המקדימה, מעבירים את הדגל --expires DURATION, לדוגמה:

  firebase hosting:channel:deploy new-awesome-feature --expires 7d

  תאריך התפוגה יכול להיות עד 30 יום מתאריך הפריסה. משתמשים ב-h לשעות, ב-d לימים וב-w לשבועות (לדוגמה, 12h,‏ 7d,‏ 2w בהתאמה).

שיבוט גרסה מערוץ אחד לערוץ אחר

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

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

התכונה הזו שימושית למעקב אחר גרסאות, או אם אתם רוצים לוודא שאתם מפיצים את התוכן המדויק שצפיתם בו או בדקתם אותו בערוץ אחר. הנה כמה דוגמאות:

• שיבוט מערוץ תצוגה מקדימה של 'בקרת איכות' לערוץ הפעיל של האתר (העברה לשידור חי!)

• שיבוט מהערוץ הפעיל של האתר לערוץ תצוגה מקדימה לניפוי באגים (למשל, לפני ביצוע חזרה לגרסה קודמת)

• שיבוט מערוץ בפרויקט Firebase 'staging' לערוץ תצוגה מקדימה בפרויקט Firebase 'prod'

כדי לשכפל גרסה, מריצים את הפקודה הבאה מכל ספרייה:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

מחליפים כל placeholder בערכים הבאים:

• ‫SOURCE_SITE_ID ו-TARGET_SITE_ID: אלה המזהים של אתרי Hosting שמכילים את הערוצים.

  • באתר ברירת המחדל Hosting, משתמשים במזהה הפרויקט ב-Firebase.
  • אפשר לציין Hosting אתרים שנמצאים באותו פרויקט Firebase או אפילו בפרויקטים שונים של Firebase.

• ‫SOURCE_CHANNEL_ID ו-TARGET_CHANNEL_ID: אלה המזהים של הערוצים.

  • בערוץ שידור חי, צריך להשתמש ב-live כמזהה הערוץ.
  • אם הערוץ 'target' שצוין עדיין לא קיים, הפקודה הזו יוצרת את הערוץ לפני הפריסה אליו.

חזרה לגרסה קודמת של האתר

אפשר להחזיר למצב קודם כדי להכניס לשימוש בסביבת הייצור גרסה קודמת של הערוץ הפעיל של האתר. הפעולה הזו שימושית אם יש בעיה בגרסה הנוכחית ואתם רוצים לחזור לגרסה קודמת של האתר שאתם יודעים שהיא תקינה. או אולי האתר שלכם הציג תוכן זמני לכבוד חג או אירוע מיוחד, אבל עכשיו אתם רוצים לחזור להצגת התוכן הרגיל.

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

כך מבצעים חזרה לגרסה הקודמת:

1. במסוף Firebase, עוברים אל Hosting & Serverless (אירוח ושרתים וירטואליים) > Hosting (אירוח).

2. בטבלה היסטוריית ההפצות של האתר, מעבירים את העכבר מעל רשומה של הפצה קודמת שרוצים לחזור אליה.

3. לוחצים על more_vert ואז על החזרה לגרסה קודמת.

מחיקה ידנית של גרסה

יכול להיות שתצטרכו למחוק באופן ידני פריט תוכן מהערוץ הפעיל כדי לפנות נפח אחסון של Hosting לפרויקט. אפשר למחוק רק גרסאות קודמות, ולא את הגרסה שמוצגת כרגע באתר הפעיל.

כשמוחקים פריט תוכן, בעצם מוחקים את התוכן שלו, והוא מתוזמן למחיקה תוך 24 שעות. אובייקט הגרסה עצמו נשמר כדי שעדיין תוכלו לראות את המטא-נתונים שלו (מי פרסם אותו ומתי).

כך מוחקים פריט תוכן:

1. במסוף Firebase, עוברים אל Hosting & Serverless (אירוח ושרתים וירטואליים) > Hosting (אירוח).

2. בטבלה Release History (היסטוריית הגרסאות) של האתר, מעבירים את העכבר מעל לגרסה הקודמת שרוצים למחוק.

3. לוחצים על more_vert ובוחרים באפשרות מחיקה.

מחיקת קבצים באופן ידני

ב-Firebase Hosting, הדרך העיקרית למחוק קבצים נבחרים מאתר שפרסתם היא למחוק את הקבצים באופן מקומי ואז לפרוס מחדש.

מחיקה ידנית של ערוץ תצוגה מקדימה

כדי לראות תצוגה מקדימה של הערוצים, לוחצים על הערוץ שרוצים לראות בתצוגה מקדימה. בתצוגה הזו אפשר לראות, למחוק ולשחזר את הפריסות והגרסאות האחרונות שמשויכות לערוץ הספציפי. אפשר למחוק ערוץ תצוגה מקדימה, אבל אי אפשר למחוק את הערוץ הפעיל של האתר.

כשמוחקים ערוץ בתצוגה מקדימה, הערוץ, הפריטים לפרסום והגרסאות המשויכות שלו מתוזמנים למחיקה תוך 24 שעות. גם כתובת ה-URL המשויכת לתצוגה המקדימה מושבתת. יוצא מן הכלל למחיקת גרסה הוא אם גרסה משויכת למהדורה אחרת (זה קורה, למשל, אם משכפלים גרסה מערוץ אחד לערוץ אחר באותו אתר).

‫Hosting תומך בשתי דרכים שונות למחיקת ערוץ תצוגה מקדימה:

• ‫Firebase console
  בשורה של ערוץ התצוגה המקדימה, לוחצים על more_vert ואז בוחרים באפשרות מחיקת הערוץ. אשר את המחיקה.

• ‫Firebase CLI
  מריצים את הפקודה הבאה מכל ספרייה:

  firebase hosting:channel:delete CHANNEL_ID

פקודות CLI לערוצי תצוגה מקדימה ולשיבוט

פקודות לערוצי תצוגה מקדימה

כל הפקודות לערוצי תצוגה מקדימה תומכות ביעדי פריסה אם יש לכם כמה אתרי Hosting.

פקודות לשכפול גרסה