Zarządzaj transmisjami na żywo kanały podglądu, wersje i wersje witryny

Firebase Hosting udostępnia narzędzia za pomocą konsoli Firebase i Firebase Interfejs wiersza poleceń do zarządzania kanałami, wersjami i wersjami Hosting.

Omówienie infrastruktury Hosting

Poznanie infrastruktury Hosting ułatwia zrozumienie opcji zarządzania opisanych na tej stronie.

Każdy projekt Firebase ma domyślną Hosting witrynę z dostępem do wszystkich zasobów projektu (baz danych, uwierzytelniania, funkcji itp.). Witryna zawiera co najmniej 1 kanał, a każdy kanał jest powiązany z adresem URL, który obsługuje określone treści i konfigurację Hosting.

obraz <span class=Hierarchia Hostingu Firebase” />

Każda witryna Hosting ma „opublikowaną” kanał, który udostępnia treści Konfiguracja Hosting w (1) subdomenach witryny obsługiwanych przez Firebase (SITE_ID.web.app i SITE_ID.firebaseapp.com) i (2) dowolne połączone domenach niestandardowych. Możesz też opcjonalnie utworzyć „preview” z kanałami, które tymczasowo wyświetlają własne treści i konfigurację, udostępniane „adresy URL podglądu” (SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app).

Treści i konfiguracja udostępniane na każdym kanale są spakowane w version z unikalnym identyfikatorem. Po wdrożeniu aplikacji Firebase tworzy obiekt release wskazujący konkretną wersję. O wersja zawiera metadane dotyczące wdrożenia, na przykład informacje o tym, kto i kiedy wdrożył wersję została wdrożona.

Na podstawie panel Hosting, możesz zobaczyć pełną historię publikacji kanału na żywo Tabela historii wersji. Jeśli masz kilka witryn Hosting, kliknij Wyświetl obok wybranej witryny, aby zobaczyć historię jej wersji. Jeśli masz kanały podglądu, wyświetlają się też w panelu Hosting.

Zarządzanie ustawieniami kanału

Możesz kontrolować ustawienia każdego kanału w swojej witrynie. Niektóre ustawienia, takie jak wygaśnięcia kanału, dotyczą tylko kanałów próbnych.

Ogranicz liczbę wersji, które mają zostać zachowane

Za każdym razem, gdy wdrażasz kanał (i tworzysz wersję), Hosting zachowuje wersja powiązana z poprzednią wersją w: Hosting projektu pamięci masowej. Możesz ustawić liczbę wersji, które mają być zachowane na każdym kanale w projekcie, zarówno na kanale na żywo, jak i na kanale podglądu.

  • Dlaczego Hosting zachowuje poprzednie wersje?
    W przypadku kanału na żywo przechowywanie poprzednich wersji umożliwia w razie potrzeby powrót do poprzedniej wersji witryny. Dla: kanałów podglądu, przywrócenie poprzedniej wersji nie jest jeszcze dostępne.

  • Po co ograniczać liczbę wersji do zachowania?
    Ta funkcja może Ci pomóc kontrolować poziom wykorzystania miejsca na dane Hosting w projekcie, ponieważ treści z poprzednich wersji są przechowywane w tym miejscu. Możesz monitorować Hosting miejsca na dane z Karta Miejsce na dane w konsoli.

  • Co się stanie, gdy ograniczysz liczbę wersji do zachowania?
    Gdy ustawisz limit wersji do zachowania, treść wszystkich wersji przekracza ustalony limit jest przeznaczony do usunięcia, zaczynając od najstarszych wersji.

Aby ustawić limit miejsca na dane dla kanału:

  1. W konsola Firebase, otwórz okno ustawień przechowywania wersji:

    • Dla Twojego kanału nadawanego na żywo:
      W tabeli Historia wersji dla swojej witryny kliknij , a następnie wybierz Ustawienia miejsca na dane wersji

    • W przypadku dowolnego kanału podglądu
      W wierszu kanału podglądu kliknij , a następnie wybierz Ustawienia kanału.

  2. Wpisz liczbę wersji, które chcesz zachować, a następnie kliknij Zapisz.

Ustawianie daty wygaśnięcia kanału wersji testowej

Domyślnie kanał z podglądem wygasa po 7 dniach od daty jego utworzenia, ale kanał na żywo Twojej witryny nigdy nie wygaśnie.

Po wygaśnięciu kanału podglądu kanał, wraz z informacjami o premierach powiązane wersje są przeznaczone do usunięcia w ciągu 24 godzin. powiązany adres URL podglądu też jest dezaktywowany. Wyjątki od tej reguły usunięcie wersji polega na tym, że wersja jest powiązana z inną wersją (to Dzieje się tak na przykład wtedy, gdy sklonujesz wersję z jednego kanału do drugiego. w tej samej witrynie).

Hosting udostępnia dwa sposoby kontrolowania wygaśnięcia kanału:

  • Konsola Firebase
    W wierszu kanału podglądu kliknij , a następnie wybierz Ustawienia kanału. Wpisz datę i godzinę wygaśnięcia ważności.

  • Interfejs wiersza poleceń Firebase
    Przy wdrażaniu w kanale podglądu prześlij --expires DURATION, na przykład:

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

    Wygaśnięcie może potrwać do 30 dni od daty wdrożenia. Używaj h do godz., d – dni i w – tygodnie (np. 12h, 7d, 2w, ).

Kopiowanie wersji z jednego kanału na inny

Możesz sklonować wdrożoną wersję z 1 kanału do innego. Możesz klonować kanały na żywo lub podglądu, witryny Hosting, a nawet projekty Firebase.

Polecenie klonowania wdraża też obiekt w środowisku docelowym tak aby sklonowany kanał Treści i konfiguracja Hosting są automatycznie udostępniane w środowisku docelowym z powiązanym adresem URL kanału.

Ta funkcja jest przydatna przy śledzeniu wersji lub jeśli chcesz mieć pewność, że wdrażasz dokładnie wyświetlone lub przetestowane treści w innym miejscu. kanał. Oto przykłady:

  • Klonowanie z kanału podglądu „QA” na kanał na żywo Twojej witryny.

  • Klonowanie z aktywnego kanału witryny do funkcji „debugowanie” kanał podglądu (np. przed przywróceniem poprzedniej wersji)

  • Klonowanie z kanału w „testowym” projekcie Firebase do kanału podglądu w „produkcyjnym” projekcie Firebase

Aby skopiować wersję, uruchom to polecenie z dowolnego katalogu:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

Zastąp każdy obiekt zastępczy takim kodem:

  • SOURCE_SITE_ID i TARGET_SITE_ID: to są identyfikatory obiektów Witryny zawierające te kanały: Hosting.

    • W przypadku domyślnej witryny Hosting użyj identyfikatora projektu Firebase.
    • Możesz określić Hosting witryn w tym samym projekcie Firebase lub nawet w różnych projektach Firebase.

  • SOURCE_CHANNEL_ID i TARGET_CHANNEL_ID: to identyfikatory kanałów.

    • W przypadku kanału na żywo jako identyfikator kanału użyj wartości live.
    • Jeśli określony „target” kanał jeszcze nie istnieje, to polecenie tworzy przed wdrożeniem.

Przywracanie poprzedniej wersji witryny

Możesz je przywrócić, aby wyświetlać poprzednią wersję aktywnego kanału witryny. Ten to działanie jest przydatne, jeśli w bieżącej wersji występuje problem i chcesz ją wycofać która działa w znanej, działającej wersji witryny. lub Twoja witryna treści tymczasowe dotyczące święta lub wydarzenia, a teraz chcesz je przywrócić aby wyświetlać „standardowe” reklamy, treści.

W efekcie tworzysz nową wersję, która zawiera tę samą treść co poprzednia. W tabeli Historia wersji obie wersje zawierać ten sam identyfikator wersji.

Aby przywrócić poprzednią wersję systemu:

  1. W konsola Firebase, w tabeli Historia wersji witryny najedź kursorem na poprzednią pozycję wersji, do której chcesz przywrócić poprzednią wersję.

  2. Kliknij i wybierz Wycofanie zmian.

Ręczne usuwanie wersji

Aby zwolnić miejsce, konieczne może być ręczne usunięcie wersji z kanału transmisji na żywo. Hosting miejsca na dane na projekt. Ty mogą usuwać tylko wcześniejsze wersje, a nie te, na których jest aktualnie wyświetlane w Twojej działającej witrynie.

Gdy usuniesz wersję, usuwasz jej zawartość, która zostanie zaplanowana do usunięcia w ciągu 24 godzin. Obiekt wersji jest zachowywany, aby umożliwić wyświetlanie metadanych (o tym, kto i kiedy wdrożył aplikację).

Aby usunąć wersję:

  1. W konsoli Firebase w tabeli Historia wersji dotyczącej Twojej witryny najedź kursorem na poprzedni wpis wersji, który chcesz usunąć.

  2. Kliknij i wybierz Usuń.

Ręczne usuwanie plików

Głównym sposobem usuwania wybranych plików w usłudze Firebase Hosting jest z wdrożonej witryny jest lokalne usunięcie plików i ponowne wdrożenie.

Ręczne usuwanie kanału podglądu

Możesz wyświetlić podgląd swoich kanałów, klikając kanał, którego podgląd chcesz wyświetlić. W tym widoku możesz wyświetlać, usuwać i przywracać najnowsze wdrożenia oraz powiązane z konkretnym kanałem. Możesz usunąć kanał z podglądem, ale nie możesz usunąć aktywnego kanału witryny.

Gdy usuniesz kanał podglądu, kanał wraz z jego wersjami produkcyjnymi i powiązanymi wersjami zostanie usunięty w ciągu 24 godzin. powiązany adres URL podglądu też jest dezaktywowany. Wyjątek od usunięcie wersji polega na tym, że wersja jest powiązana z inną wersją (to Dzieje się tak na przykład wtedy, gdy sklonujesz wersję z jednego kanału do drugiego. w tej samej witrynie).

W usłudze Hosting możesz usunąć kanał podglądu na 2 sposoby:

  • Firebase konsoli
    W wierszu kanału podglądu kliknij , a następnie wybierz Usuń kanał. Potwierdź usunięcie.

  • Interfejs wiersza poleceń Firebase
    Uruchom to polecenie z dowolnego katalogu:

    firebase hosting:channel:delete CHANNEL_ID

Polecenia interfejsu wiersza poleceń dotyczące kanałów podglądu i klonowania

Polecenia dotyczące kanałów podglądu

Wszystkie polecenia dotyczące kanałów podglądu obsługują cele wdrażania, jeśli dla wielu witryn Hosting.

Polecenie Opis
firebase hosting:channel:create CHANNEL_ID

Tworzy nowy kanał podglądu w default witryny Hosting korzystającej z określonego CHANNEL_ID

To polecenie nie jest wdrażane na kanale.
firebase hosting:channel:delete CHANNEL_ID

usuwa określony kanał podglądu.

Nie możesz usunąć aktywnego kanału witryny.
firebase hosting:channel:deploy CHANNEL_ID

Wdraża zawartość i konfigurację Hosting w podanym kanał wersji testowej

Jeśli kanał podglądu nie istnieje jeszcze, to polecenie utworzy go na stronie domyślnej Hosting, zanim wdrożysz go na kanale.

firebase hosting:channel:list Wyświetla listę wszystkich kanałów (w tym kanał „aktywny”) w domyślna witryna Hosting
firebase hosting:channel:open CHANNEL_ID Otwiera przeglądarkę na wskazany adres URL kanału lub zwraca adres URL, jeśli otwarcie w przeglądarce nie jest możliwe

Polecenia dotyczące klonowania wersji

Polecenie Opis
firebase hosting:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

Klonuje ostatnio wdrożony wariant na określonym kanale „source” (źródło) i przesyła go na określony kanał „target” (docelowy).

To polecenie jest też wdrażane w podanym „miejscu docelowym” kanał. Jeśli „target” kanał jeszcze nie istnieje, to polecenie tworzy nowy podglądu kanału w polu „docelowy” Hosting witryna przed wdrożeniem w kanału.

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

Klonuje określoną wersję na określonym kanale „docelowym”.

To polecenie jest też wdrażane w podanym „miejscu docelowym” kanał. Jeśli „target” kanał jeszcze nie istnieje, to polecenie tworzy nowy podglądu kanału w polu „docelowy” Hosting witryna przed wdrożeniem w kanału.

VERSION_ID znajdziesz w Panel Hosting konsoli Firebase.