Live bereitstellen & Vorschaukanäle über GitHub-Pull-Anfragen

Sie können Bereitstellungen in Firebase Hosting über eine GitHub Action einbinden. Das kann diese GitHub Action für Sie tun:

  • Erstellt für jeden Pull Request (PR) in Ihrem GitHub-Repository einen neuen Vorschaukanal (und die zugehörige Vorschau-URL).

  • Fügt dem PR einen Kommentar mit der Vorschau-URL hinzu, damit Sie und jeder Prüfer die Änderungen des PR in einer „Vorschauversion“ Ihrer App ansehen und testen können.

    Bild eines GitHub-Aktionskommentars zu einer Pull-Anfrage mit Vorschau-URL

  • Aktualisiert die Vorschau-URL mit Änderungen aus jedem Commit, indem sie automatisch im zugehörigen Vorschaukanal bereitgestellt werden. Die URL ändert sich nicht mit jedem neuen Commit.

  • (Optional) Stellt den aktuellen Status Ihres GitHub-Repositorys in Ihrem Live-Kanal bereit, wenn der PR zusammengeführt wird.

Hinweis: Wenn Sie Vorschau-URLs verwenden, interagiert Ihre App mit den echten Backend-Ressourcen Ihres Firebase-Projekts.

GitHub Action für die Bereitstellung in Firebase Hosting einrichten

  1. Erstellen Sie ein GitHub-Repository (öffentlich oder privat) oder verwenden Sie ein vorhandenes. Sie benötigen Administratorberechtigungen für das Repository.

  2. Richten Sie in einer lokalen Version Ihres Repositorys Firebase Hosting mit dem firebase init Befehl ein.

    • Wenn Sie Hosting noch NICHT eingerichtet haben, führen Sie diese Version des Befehls im Stammverzeichnis Ihres lokalen Verzeichnisses aus:

      firebase init hosting
    • Wenn Sie Hosting BEREITS eingerichtet haben, müssen Sie nur den Teil der GitHub Action von Hosting einrichten. Führen Sie diese Version des Befehls im Stammverzeichnis Ihres lokalen Verzeichnisses aus:

      firebase init hosting:github
  3. Folgen Sie der Aufforderung der Befehlszeile. Der Befehl richtet die GitHub Action automatisch ein:

    • Erstellt in Ihrem Firebase-Projekt ein Dienstkonto mit der Berechtigung, in Firebase Hosting bereitzustellen.

    • Verschlüsselt den JSON-Schlüssel dieses Dienstkontos und lädt ihn als GitHub-Secret in das angegebene GitHub-Repository hoch.

    • Schreibt yaml-Konfigurationsdateien für den GitHub-Workflow, die auf das neu erstellte Secret verweisen. Mit diesen Dateien wird die GitHub Action für die Bereitstellung in Firebase Hosting konfiguriert.

  4. Erstellen Sie in GitHub einen neuen Branch und übertragen Sie die von der Befehlszeile erstellten yaml-Dateien des Workflows.

  5. Veröffentlichen Sie den Branch in Ihrem GitHub-Repository.

  6. Führen Sie den Branch zusammen.

Geschafft! Jeder nachfolgende PR in diesem GitHub-Repository erhält automatisch eine eigene Vorschau-URL.

Weitere Informationen zur GitHub Action

  • Firebase verwaltet die GitHub Action „In Firebase Hosting bereitstellen“ als Open-Source-Projekt. Quellcode ansehen

  • Die GitHub Action „In Firebase Hosting bereitstellen“ ermöglicht weitere Konfigurationen, z. B. das Anpassen des Ablaufdatums für einen Vorschaukanal oder das Festlegen eines Nicht-Live-Kanals, in dem bereitgestellt werden soll, wenn ein PR zusammengeführt wird. Verfügbare Konfigurationsoptionen

  • Weitere Informationen zu GitHub Actions, im Allgemeinen.