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

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

סקירה כללית של תשתית האחסון

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

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

תמונה של היררכיית אירוח Firebase

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

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

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

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

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

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

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

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

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

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

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

  1. במסוף Firebase , גש לתיבת הדו-שיח של שחרור הגדרות האחסון:

    • לערוץ החי שלך
      בטבלה 'היסטוריית שחרורים' עבור האתר שלך, לחץ על ולאחר מכן בחר שחרור הגדרות אחסון .

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

  2. הזן את מספר הגרסאות שברצונך לשמור, ולאחר מכן לחץ על שמור .

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

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

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

אירוח תומך בשתי דרכים שונות לשלוט בתפוגה של ערוץ:

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

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

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

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

שכפול גרסה מערוץ אחד לאחר

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

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

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

  • שיבוט מערוץ תצוגה מקדימה "QA" לערוץ החי של האתר שלך (הועלה לאוויר!)

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

  • שיבוט מערוץ בפרויקט Firebase ה"ביים" שלך לערוץ תצוגה מקדימה בפרויקט Firebase ה"פרוד" שלך

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

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

החלף כל מציין מיקום בדברים הבאים:

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

    • עבור אתר האירוח המוגדר כברירת מחדל, השתמש במזהה הפרויקט שלך ב-Firebase.
    • אתה יכול לציין אתרי אירוח שנמצאים באותו פרויקט Firebase או אפילו בפרויקטים שונים של Firebase.
  • SOURCE_CHANNEL_ID ו- TARGET_CHANNEL_ID : אלו הם המזהים של הערוצים.

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

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

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

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

הנה איך לחזור אחורה:

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

  2. לחץ על ולאחר מכן בחר באפשרות חזור לאחור .

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

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

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

הנה איך למחוק גרסה:

  1. במסוף Firebase , בטבלה 'היסטוריית מהדורות' עבור האתר שלך, העבר את העכבר מעל רשומת ההפצה הקודמת שברצונך למחוק.

  2. לחץ על ולאחר מכן בחר מחק .

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

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

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

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

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

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

    firebase hosting:channel:delete CHANNEL_ID

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

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

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

פקודה תיאור
firebase hosting:channel:create CHANNEL_ID

יוצר ערוץ תצוגה מקדימה חדש באתר אירוח ברירת המחדל באמצעות CHANNEL_ID שצוין

פקודה זו אינה נפרסת לערוץ.

firebase hosting:channel:delete CHANNEL_ID

מוחק את ערוץ התצוגה המקדימה שצוין

אינך יכול למחוק ערוץ חי של אתר.

firebase hosting:channel:deploy CHANNEL_ID

פורס את תוכן האחסון ואת התצורה שלך לערוץ התצוגה המקדימה שצוין

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

firebase hosting:channel:list מפרט את כל הערוצים (כולל ערוץ ה"חי") באתר האירוח המוגדר כברירת מחדל
firebase hosting:channel:open CHANNEL_ID פותח דפדפן לכתובת ה-URL של הערוץ שצוין או מחזיר את כתובת ה-URL אם פתיחה בדפדפן אינה אפשרית

פקודות עבור שיבוט גרסאות

פקודה תיאור
firebase hosting:clone \
SOURCE_SITE_ID : SOURCE_CHANNEL_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

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

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

firebase hosting:clone \
SOURCE_SITE_ID :@ VERSION_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

משבט את הגרסה שצוינה לערוץ ה"יעד" שצוין

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

אתה יכול למצוא את ה- VERSION_ID בלוח המחוונים של אירוח של מסוף Firebase.