Firebase Hosting zapewnia narzędzia za pośrednictwem konsoli Firebase i interfejsu CLI Firebase do zarządzania kanałami, wydaniami i wersjami witryny hostingowej.
Przegląd infrastruktury hostingowej
Zrozumienie infrastruktury hostingowej pomoże Ci zrozumieć opcje zarządzania opisane na tej stronie.
Każdy projekt Firebase ma domyślną witrynę Hostingową z dostępem do wszystkich zasobów projektu (bazy danych, uwierzytelnianie, funkcje itp.). Witryna zawiera jeden lub więcej kanałów , z których każdy jest powiązany z adresem URL obsługującym określoną treść i konfiguracją Hostingu.
Każda witryna Hostingu ma kanał „na żywo”, który udostępnia treść i konfigurację Hostingu w (1) subdomenach udostępnianych przez Firebase witryny ( SITE_ID .web.app i SITE_ID .firebaseapp.com ) oraz (2) wszelkich podłączonych domenach niestandardowych . Opcjonalnie możesz także utworzyć kanały „podglądu”, które udostępniają własną treść i konfigurację pod tymczasowymi, udostępnianymi „adresami URL podglądu” (SITE_ID -- CHANNEL_ID - RANDOM_HASH .web.app ).
Treść i konfiguracja udostępniana przez każdy kanał są spakowane w obiekt wersji , który ma unikalny identyfikator. Po wdrożeniu w witrynie Firebase tworzy obiekt wydania , który wskazuje konkretną wersję. Wersja zawiera metadane dotyczące wdrożenia, np. kto i kiedy wdrożył.
W panelu hostingu projektu Firebase możesz zobaczyć pełną historię wydań swojego kanału na żywo w tabeli Historia wydań . Jeśli masz wiele witryn hostingowych , kliknij opcję Wyświetl przy żądanej witrynie, aby wyświetlić historię jej wydań. Jeśli masz jakieś kanały podglądu, są one również wyświetlane na pulpicie nawigacyjnym Hostingu.
Zarządzaj ustawieniami kanału
Dla każdego kanału Twojej witryny możesz kontrolować jego ustawienia. Niektóre ustawienia, np. wygaśnięcie kanału, mają zastosowanie tylko do kanałów w wersji zapoznawczej.
Ogranicz liczbę zachowanych wydań
Za każdym razem, gdy wdrażasz na kanale (i tworzysz wersję), Hosting przechowuje wersję powiązaną z poprzednią wersją w magazynie Hostingu Twojego projektu. Możesz ustawić liczbę wydań, które mają być przechowywane dla każdego kanału w projekcie, zarówno kanałów na żywo, jak i kanałów podglądu.
Dlaczego Hosting przechowuje poprzednie wydania?
W przypadku kanału na żywo zachowanie poprzednich wersji umożliwia w razie potrzeby przywrócenie poprzedniej wersji witryny. W przypadku kanałów podglądu wycofanie nie jest jeszcze dostępne.Po co ograniczać liczbę przechowywanych wersji?
Ta funkcja może pomóc Ci kontrolować poziom wykorzystania magazynu Hostingu Twojego projektu , ponieważ zawartość poprzednich wydań jest przechowywana w tym magazynie. Możesz monitorować swoją pamięć hostingową na karcie Pamięć w konsoli.Co się stanie, jeśli ograniczysz wydania, które chcesz zachować?
Jeśli ustawisz limit zachowywania wydań, zawartość wszystkich wydań przekraczających ustalony limit zostanie zaplanowana do usunięcia, zaczynając od najstarszych wydań .
Oto jak ustawić limit miejsca na wydanie dla kanału:
W konsoli Firebase przejdź do okna dialogowego ustawień magazynu wersji:
Dla Twojego kanału na żywo
W tabeli Historia wydań swojej witryny kliknij , a następnie wybierz Ustawienia przechowywania wersji .Dla dowolnego kanału podglądu
W wierszu kanału podglądu kliknij , a następnie wybierz Ustawienia kanału .
Wpisz liczbę wersji, które chcesz zachować, a następnie kliknij Zapisz .
Ustaw datę wygaśnięcia kanału podglądu
Domyślnie kanał podglądu wygasa po 7 dniach od daty utworzenia, ale kanał aktywny w Twojej witrynie nigdy nie wygaśnie.
Po wygaśnięciu kanału podglądu kanał wraz z jego wydaniami i powiązanymi wersjami zostanie usunięty w ciągu 24 godzin. Powiązany adres URL podglądu również jest dezaktywowany. Wyjątkiem od usunięcia wersji jest sytuacja, gdy wersja jest powiązana z inną wersją (dzieje się tak na przykład wtedy, gdy sklonujesz wersję z jednego kanału do innego w tej samej witrynie ).
Hosting obsługuje dwa różne sposoby kontrolowania wygaśnięcia kanału:
Konsola Firebase
W wierszu kanału podglądu kliknij , a następnie wybierz Ustawienia kanału . Wprowadź datę i godzinę wygaśnięcia.Interfejs wiersza polecenia Firebase
Podczas wdrażania w kanale podglądu przekaż flagę--expires DURATION, na przykład:firebase hosting:channel:deploy new-awesome-feature --expires 7d
Wygaśnięcie może wynosić do 30 dni od daty wdrożenia. Użyj
hdla godzin,ddla dni iwdla tygodni (na przykład odpowiednio12h,7d,2w).
Sklonuj wersję z jednego kanału na drugi
Wdrożoną wersję można sklonować z jednego kanału do innego kanału. Możesz klonować w kanałach na żywo lub w podglądzie, w witrynach hostingowych, a nawet w projektach Firebase.
Polecenie clone jest również wdrażane w kanale „docelowym”, dzięki czemu sklonowana zawartość i konfiguracja hostingu są automatycznie udostępniane pod adresem URL skojarzonym z kanałem „docelowym”.
Ta funkcja jest przydatna do śledzenia wersji lub jeśli chcesz mieć pewność, że wdrażasz dokładnie tę treść, którą oglądałeś i/lub testowałeś na innym kanale. Oto kilka przykładów:
Sklonuj kanał podglądu „QA” do kanału na żywo swojej witryny (wprowadzanie na żywo!)
Sklonuj kanał na żywo swojej witryny do kanału podglądu „debugowania” (jak przed wycofaniem)
Sklonuj kanał w projekcie Firebase „stagingowym” do kanału podglądu w projekcie Firebase „prod”.
Aby sklonować wersję, uruchom następującą komendę 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 następującym:
SOURCE_SITE_ID i TARGET_SITE_ID : są to identyfikatory witryn hostingowych zawierających kanały.
- W przypadku domyślnej witryny hostingowej użyj identyfikatora projektu Firebase.
- Możesz określić witryny hostingowe, które znajdują się w tym samym projekcie Firebase lub nawet w różnych projektach Firebase.
SOURCE_CHANNEL_ID i TARGET_CHANNEL_ID : To są identyfikatory kanałów.
- W przypadku kanału na żywo użyj
livejako identyfikatora kanału. - Jeśli określony kanał „docelowy” jeszcze nie istnieje, to polecenie tworzy kanał przed wdrożeniem w nim.
- W przypadku kanału na żywo użyj
Kiedy klonujesz wersję z jednego kanału do innego kanału w tej samej witrynie hostingowej , Firebase tworzy nowy obiekt wydania, który wskazuje dokładnie tę samą wersję . W witrynie hostingowej zobaczysz dwie wersje, które wskazują na tę samą wersję (identyfikowaną za pomocą identyfikatora wersji).
Jeśli jednak sklonujesz wersję na kanał w innej witrynie Hosting (lub w innym projekcie Firebase), Firebase utworzy zarówno nową wersję, jak i nową wersję (identyfikowaną za pomocą innego identyfikatora wersji).
Przywróć poprzednią wersję swojej witryny
Możesz przywrócić poprzednią wersję kanału na żywo w swojej witrynie. Ta czynność jest przydatna, jeśli w bieżącej wersji występuje problem i chcesz ją przywrócić, aby udostępnić znaną, działającą wersję witryny. A może Twoja witryna udostępniała tymczasową treść z okazji święta lub specjalnego wydarzenia, ale teraz chcesz ją przywrócić, aby wyświetlać „zwykłą” treść.
Wycofując się, tworzysz nową wersję, która udostępnia tę samą wersję treści, co poprzednia wersja. W tabeli historii wydań oba wydania będą miały ten sam identyfikator wersji.
Oto jak cofnąć:
W konsoli Firebase w tabeli Historia wydań swojej witryny najedź kursorem na wpis poprzedniej wersji, do której chcesz wrócić.
Kliknij , a następnie wybierz Cofnij .
Ręcznie usuń wersję
Może być konieczne ręczne usunięcie wersji z kanału na żywo, aby zwolnić miejsce w Hostingu dla Twojego projektu. Możesz usunąć tylko poprzednie wydania, a nie te, które są aktualnie udostępniane w Twojej działającej witrynie.
Usuwając wersję, w rzeczywistości usuwasz jej zawartość, której usunięcie zaplanowano w ciągu 24 godzin. Sam obiekt wydania jest zachowywany, dzięki czemu nadal można zobaczyć jego metadane (kto i kiedy wdrożył).
Oto jak usunąć wersję:
W konsoli Firebase w tabeli Historia wydań swojej witryny najedź kursorem na wpis poprzedniej wersji, który chcesz usunąć.
Kliknij , a następnie wybierz Usuń .
Ręcznie usuń kanał podglądu
Możesz wyświetlić podgląd swoich kanałów, klikając kanał, który chcesz wyświetlić. W tym widoku możesz przeglądać, usuwać i przywracać najnowsze wdrożenia i wydania powiązane z określonym kanałem. Możesz usunąć kanał podglądu, ale nie możesz usunąć kanału na żywo w swojej witrynie.
Gdy usuniesz kanał podglądu, kanał wraz z jego wydaniami i powiązanymi wersjami zostaną usunięte w ciągu 24 godzin. Powiązany adres URL podglądu również jest dezaktywowany. Wyjątkiem od usunięcia wersji jest sytuacja, gdy wersja jest powiązana z innym wydaniem (dzieje się tak na przykład, jeśli sklonujesz wersję z jednego kanału do innego w tej samej witrynie ).
Hosting obsługuje dwa różne sposoby usuwania kanału podglądu:
Konsola Firebase
W wierszu kanału podglądu kliknij , a następnie wybierz opcję Usuń kanał . Potwierdź usunięcie.Interfejs wiersza polecenia Firebase
Uruchom następujące polecenie z dowolnego katalogu:firebase hosting:channel:delete CHANNEL_ID
Polecenia CLI do podglądu kanałów i klonowania
Polecenia dotyczące kanałów podglądu
Wszystkie polecenia dotyczące kanałów podglądu obsługują wdrażanie obiektów docelowych, jeśli masz wiele witryn hostingowych .
| Komenda | Opis |
|---|---|
firebase hosting:channel:create CHANNEL_ID | Tworzy nowy kanał podglądu w domyślnej witrynie hostingowej, używając określonego To polecenie nie jest wdrażane w kanale. |
firebase hosting:channel:delete CHANNEL_ID | Usuwa określony kanał podglądu Nie można usunąć kanału na żywo witryny. |
firebase hosting:channel:deploy CHANNEL_ID | Wdraża zawartość i konfigurację hostingu w określonym kanale podglądu Jeśli kanał podglądu jeszcze nie istnieje, to polecenie tworzy kanał w domyślnej witrynie hostingowej przed wdrożeniem w kanale. |
firebase hosting:channel:list | Wyświetla listę wszystkich kanałów (w tym kanału „na żywo”) w domyślnej witrynie hostingowej |
firebase hosting:channel:open CHANNEL_ID | Otwiera przeglądarkę na adres URL określonego kanału lub zwraca adres URL, jeśli otwarcie w przeglądarce nie jest możliwe |
Polecenia do klonowania wersji
| Komenda | Opis |
|---|---|
firebase hosting:clone \ | Klonuje ostatnio wdrożoną wersję na określonym kanale „źródłowym” do określonego kanału „docelowego”. To polecenie jest również wdrażane w określonym kanale „docelowym”. Jeśli kanał „docelowy” jeszcze nie istnieje, to polecenie tworzy nowy kanał podglądu w „docelowej” witrynie hostingowej przed wdrożeniem na kanale. |
firebase hosting:clone \ | Klonuje określoną wersję do określonego kanału „docelowego”. To polecenie jest również wdrażane w określonym kanale „docelowym”. Jeśli kanał „docelowy” jeszcze nie istnieje, to polecenie tworzy nowy kanał podglądu w „docelowej” witrynie hostingowej przed wdrożeniem na kanale. Identyfikator |