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

Firebase Hosting udostępnia narzędzia w Firebase konsoli i Firebase CLI do zarządzania kanałami, wersjami i wydaniami witryny Hosting.

Omówienie infrastruktury Hosting

Zrozumienie infrastruktury Hosting pomoże Ci poznać opisane na tej stronie opcje zarządzania.

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 wyświetla określone treści, oraz z konfiguracją Hosting.

Hierarchia Hostingu Firebase" />

Każda witryna Hosting ma kanał „na żywo”, który wyświetla treści i konfigurację Hosting w (1) poddomenach udostępnionych przez Firebase (SITE_ID.web.app i SITE_ID.firebaseapp.com) oraz (2) w dowolnych połączonych domenach niestandardowych. Opcjonalnie możesz też utworzyć kanały „podglądu”, które obsługują własne treści i konfigurację pod tymczasowymi, udostępnianymi „adresami URL podglądu” (SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app).

Treści i konfiguracja dostarczane przez każdy kanał są pakowane w obiekt version, który ma unikalny identyfikator. Gdy wdrożysz aplikację w witrynie, Firebase utworzy obiekt wersji, który wskazuje konkretną wersję. Wersja zawiera metadane dotyczące wdrożenia, takie jak informacje o osobie, która je przeprowadziła, i czasie wdrożenia.

Na Hostingpanelu projektu Firebase możesz wyświetlić pełną historię wydań kanału na żywo w tabeli Historia wydań. Jeśli masz kilka Hosting witryn, kliknij Wyświetl obok wybranej witryny, aby zobaczyć jej historię wersji. Jeśli masz jakieś kanały wersji przedpremierowych, są one również wyświetlane na Hosting panelu.

Zarządzanie ustawieniami kanału

W przypadku każdego kanału w witrynie możesz kontrolować jego ustawienia. Niektóre ustawienia, takie jak wygaśnięcie kanału, mają zastosowanie tylko w przypadku kanałów wersji zapoznawczej.

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

Za każdym razem, gdy wdrażasz wersję na kanale (i tworzysz wersję), Hosting przechowuje wersję powiązaną z poprzednią wersją w Hosting pamięci projektu. Możesz ustawić liczbę wersji do zachowania dla każdego kanału w projekcie, zarówno dla kanałów wersji produkcyjnej, jak i wersji podglądowej.

• Dlaczego Hosting zachowuje poprzednie wersje?
  W przypadku kanału na żywo przechowywanie poprzednich wersji umożliwia w razie potrzeby przywrócenie poprzedniej wersji witryny. W przypadku kanałów w wersji podglądowej wycofanie zmian nie jest jeszcze dostępne.

• Dlaczego warto ograniczyć liczbę wersji do zachowania?
  Ta funkcja pomaga kontrolować poziom wykorzystania miejsca na dane w projekcie, ponieważ w tym miejscu przechowywane są treści z poprzednich wersji.Hosting Możesz monitorować pamięć Hosting na karcie Pamięć w konsoli.

• Co się stanie, gdy ograniczysz liczbę zachowywanych wersji?
  Gdy ustawisz limit przechowywanych wersji, zawartość wszystkich wersji powyżej tego limitu zostanie przeznaczona do usunięcia, zaczynając od najstarszych wersji.

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

1. W Firebasekonsoli otwórz okno ustawień miejsca na wersje:

   • W przypadku kanału na żywo
     W tabeli Historia wersji witryny kliknij more_vert, a następnie wybierz Ustawienia miejsca na wersje.

   • W przypadku dowolnego kanału z wersją zapoznawczą:
     w wierszu kanału z wersją zapoznawczą kliknijmore_vert, 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 podglądu

Domyślnie kanał podglądu wygasa po 7 dniach od daty utworzenia, ale aktywny kanał witryny nigdy nie wygasa.

Gdy kanał z wersją zapoznawczą wygaśnie, kanał oraz jego wersje produkcyjne i wersje z nim powiązane zostaną usunięte w ciągu 24 godzin. Powiązany adres URL podglądu również zostanie wyłączony. Wyjątkiem od usuwania wersji jest sytuacja, gdy jest ona powiązana z inną wersją (dzieje się tak na przykład, gdy sklonujesz wersję z jednego kanału na inny w ramach tej samej witryny).

Hosting obsługuje 2 sposoby kontrolowania wygaśnięcia kanału:

• Firebase konsola
  W wierszu kanału podglądu kliknij more_vert, a następnie wybierz Ustawienia kanału. Wpisz datę i godzinę wygaśnięcia.

• Firebase CLI
  Podczas wdrażania na kanale podglądu przekaż flagę --expires DURATION, na przykład:

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

  Okres ważności może wynosić do 30 dni od daty wdrożenia. Użyj h w przypadku godzin, d w przypadku dni i w w przypadku tygodni (np. 12h, 7d, 2w).

Klonowanie wersji z jednego kanału na inny

Możesz sklonować wdrożoną wersję z jednego kanału na inny. Możesz klonować na kanałach na żywo lub w wersji podglądowej, w Hosting witrynach, a nawet w projektach Firebase.

Polecenie klonowania wdraża też zmiany na kanale „docelowym”, dzięki czemu sklonowane treści i konfiguracja są automatycznie wyświetlane pod adresem URL powiązanym z kanałem „docelowym”.Hosting

Ta funkcja jest przydatna do śledzenia wersji lub gdy chcesz mieć pewność, że wdrażasz dokładnie te treści, które zostały wyświetlone lub przetestowane w innym kanale. Oto przykłady:

• Sklonuj z kanału podglądu „QA” na kanał na żywo w swojej witrynie (przejście na żywo).

• Sklonuj z aktywnego kanału witryny do kanału podglądu „debug” (np. przed wycofaniem zmian).

• Klonowanie z kanału w projekcie Firebase „staging” na kanał podglądu w projekcie Firebase „prod”

Aby sklonować 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 symbol zastępczy tymi elementami:

• SOURCE_SITE_ID i TARGET_SITE_ID: identyfikatory witrynHosting, które zawierają kanały.

  • W przypadku domyślnej witryny Hosting użyj identyfikatora projektu Firebase.
  • Możesz określić Hosting witryny, które znajdują się 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 użyj live jako identyfikatora kanału.
  • Jeśli określony kanał „target” jeszcze nie istnieje, to polecenie utworzy go przed wdrożeniem.

Przywracanie poprzedniej wersji witryny

Możesz przywrócić poprzednią wersję kanału na żywo w witrynie. Ta czynność jest przydatna, jeśli w bieżącej wersji występuje problem i chcesz przywrócić znaną, działającą wersję witryny. Może Twoja witryna wyświetlała tymczasowe treści z okazji świąt lub specjalnego wydarzenia, ale teraz chcesz przywrócić wyświetlanie „zwykłych” treści.

Przywracając poprzednią wersję, tworzysz nową wersję, która zawiera tę samą wersję treści co poprzednia. W tabeli Historia wersji obie wersje będą miały ten sam identyfikator wersji.

Aby przywrócić poprzednią wersję:

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

2. Kliknij more_vert, a potem wybierz Cofnij.

Ręczne usuwanie wersji

Aby zwolnić Hosting miejsce na dane na potrzeby projektu, może być konieczne ręczne usunięcie wydania z aktywnego kanału. Możesz usuwać tylko poprzednie wersje, a nie wersję, która jest obecnie wyświetlana w Twojej witrynie.

Gdy usuniesz wersję, usuniesz jej zawartość, która zostanie usunięta w ciągu 24 godzin. Sam obiekt wersji jest zachowywany, aby można było zobaczyć jego metadane (kto i kiedy wdrożył wersję).

Aby usunąć wydanie:

1. W Firebasekonsoli w tabeli Historia wersji dotyczącej Twojej witryny najedź kursorem na poprzednią wersję, którą chcesz usunąć.

2. Kliknij more_vert, a następnie wybierz Usuń.

Ręczne usuwanie plików

W Firebase Hosting podstawowym sposobem usuwania wybranych plików z wdrożonej witryny jest usunięcie ich lokalnie, a następnie ponowne wdrożenie.

Ręczne usuwanie kanału podglądu

Aby wyświetlić podgląd kanałów, kliknij ten, który Cię interesuje. W tym widoku możesz wyświetlać, usuwać i przywracać najnowsze wdrożenia i wersje powiązane z określonym kanałem. Możesz usunąć kanał podglądu, ale nie możesz usunąć aktywnego kanału witryny.

Gdy usuniesz kanał podglądu, kanał oraz jego wersje produkcyjne i wersje z nim powiązane zostaną usunięte w ciągu 24 godzin. Powiązany adres URL podglądu również zostanie wyłączony. Wyjątkiem od usuwania wersji jest sytuacja, gdy wersja jest powiązana z inną wersją (dzieje się tak na przykład, gdy klonujesz wersję z jednego kanału na inny w ramach tej samej witryny).

Hosting obsługuje 2 sposoby usuwania kanału podglądu:

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

• Firebase Interfejs wiersza poleceń
  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 masz kilka witryn.Hosting

Polecenia do klonowania wersji