Pierwsze kroki z App Hosting

w istniejącej aplikacji Next.js lub Angular (Next.js w wersji 13 lub nowszej albo Angular w wersji 17.2 lub nowszej) w repozytorium GitHub pierwsze kroki z App Hosting mogą być to utworzenie backendu App Hosting, a następnie uruchomienie i przeprowadzić wdrożenie, przesyłając je do aktywnej gałęzi. Jeśli nie masz aplikacji, użyj jednej z aby wykonać czynności opisane w tym przewodniku.

Zanim zaczniesz

Zanim skonfigurujesz Firebase App Hosting, musisz utworzyć Firebase projektu (jeśli jeszcze go nie masz) i przejdź na abonament Blaze.

Aby utworzyć projekt:

  1. W konsoli Firebase kliknij Dodaj projekt.

    • Aby dodać zasoby Firebase do istniejącego projektu Google Cloud, wpisz jego nazwę lub wybierz ją z menu.

    • Aby utworzyć nowy projekt, wpisz odpowiednią nazwę. Opcjonalnie możesz też zmień identyfikator projektu wyświetlany pod jego nazwą.

  2. W razie potrzeby przeczytaj i zaakceptuj warunki korzystania z Firebase.

  3. Kliknij Dalej.

  4. (Opcjonalnie) Skonfiguruj w swoim projekcie usługę Google Analytics, która pozwoli Ci aby zoptymalizować jedną z następujących usług Firebase:

    Wybierz istniejący Konto Google Analytics lub utworzyć nowe konto.

    Jeśli tworzysz nowe konto, wybierz Analytics lokalizacja raportowania, a następnie zaakceptuj ustawienia udostępniania danych i warunki korzystania z usługi Google Analytics dotyczące Twojego projektu.

  5. Kliknij Utwórz projekt (lub Dodaj Firebase, jeśli używasz istniejący projekt Google Cloud).

Firebase automatycznie udostępnia zasoby projektu Firebase. Kiedy Gdy proces się zakończy, pojawi się strona przeglądu Firebase projekt w konsoli Firebase.

Krok 0 (opcjonalny). Utwórz repozytorium GitHub i aplikację internetową

Jeśli nie masz jeszcze aplikacji internetowej znajdującej się w repozytorium GitHub lub jeśli wypróbuj proces na przykładowej aplikacji, zacznij od zainicjowania jednego z naszych w przypadku Next.js lub Angular:

npm init @apphosting

Przykładowa aplikację możesz uruchomić lokalnie za pomocą narzędzia next dev lub ng start. Aby kontynuować, utworzyć nowe repozytorium GitHub i przekaż do niego nowo zainicjowany przykładowy kod.

Krok 1. Utwórz backend App Hosting

Backend App Hosting to zbiór zarządzanych zasobów, które App Hosting tworzy i uruchamia Twoją aplikację internetową. Możesz tworzyć i wyświetlać listy App Hosting backendów za pomocą konsoli Firebase lub Interfejs wiersza poleceń Firebase.

Konsola Firebase: w menu Tworzenie wybierz App Hosting (Hosting aplikacji), a następnie Rozpocznij

Interfejs wiersza poleceń: (wersja 3.9 lub nowsza) Aby utworzyć backend, uruchom to polecenie z katalogu głównego projektu lokalnego, dodając identyfikator projektu jako argument (w przypadku podglądu obsługiwany jest tylko region us-central1):

firebase apphosting:backends:create --project PROJECT_ID --location us-central1

W przypadku konsoli lub interfejsu wiersza poleceń postępuj zgodnie z instrukcjami, aby przypisać nazwę do backendu, aby skonfiguruj połączenie z GitHubem, i skonfigurować te podstawowe ustawienia wdrożenia:

  • Ustaw katalog główny aplikacji (domyślnie /).

    Zwykle w tym miejscu znajduje się plik package.json.

  • Ustaw aktywną gałąź.

    To gałąź repozytorium GitHub, które jest wdrażane w adresu URL wersji opublikowanej. Często jest to gałąź, w której występują gałęzie lub zabudowy, gałęzie są scalone.

  • Akceptowanie lub odrzucanie wdrożeń automatycznych

    Wdrażanie automatyczne jest domyślnie włączone. Po utworzeniu backendu możesz wybrać opcję natychmiastowego wdrożenia aplikacji w App Hosting.

Krok 2. Wyświetl wdrożoną aplikację

Gdy tworzysz backend, Firebase udostępnia bezpłatną subdomenę, w której kończy się użytkownicy mogą odwiedzać Twoją aplikację internetową. Format jest backend-id--project-id.us-central1.hosted.app.

Aby wyświetlić adres URL aplikacji internetowej, sprawdź konsolę Firebase lub uruchom następujący interfejs wiersza poleceń polecenie:

firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID} --location us-central1

Krok 3. Aktywuj wdrożenie przez wypchnięcie zmiany

Po utworzeniu backendu i opublikowaniu adresu URL uruchamiać wdrażanie nowej wersji aplikacji internetowej za każdym razem, w aktywnej gałęzi repozytorium GitHub. Aby wykonać test konfiguracji App Hosting:

  1. W GitHubie prześlij zmianę do aktywnej gałęzi aplikacji internetowej.
  2. Otwórz aplikację App Hosting w w konsoli Firebase i wybierz Wyświetl panel dla swojego backendu. Lista tabel zawiera konkretne zatwierdzenie powiązane z wdrożeniem powodowane przez wprowadzone zmiany.

Dalsze kroki