Check out what’s new from Firebase at Google I/O 2022. Learn more

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

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

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

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

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

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

לכל אתר אירוח יש ערוץ "חי" המגיש תוכן ותצורת אירוח ב-(1) תת-הדומיינים שסופקו לפי Firebase של האתר ( SITE_ID .web.app ו-SITE_ID 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.