Live- und Vorschaukanäle, Releases und Versionen für Ihre Website verwalten

Firebase Hosting bietet sowohl über die Firebase-Konsole als auch über die Firebase-Befehlszeile Tools zum Verwalten der Kanäle, Releases und Versionen für Ihre Hosting-Website.

Übersicht über die Hosting-Infrastruktur

Wenn Sie die Hosting-Infrastruktur kennen, können Sie die auf dieser Seite beschriebenen Verwaltungsoptionen besser nachvollziehen.

Jedes Firebase-Projekt hat eine Hosting-Standardwebsite mit Zugriff auf alle Ressourcen des Projekts (Datenbanken, Authentifizierung, Funktionen usw.). Eine Website enthält einen oder mehrere Kanäle. Jeder Kanal ist mit einer URL verknüpft, über die bestimmte Inhalte ausgeliefert werden, und einer Hosting-Konfiguration.

ein Bild von <span class=Firebase Hosting-Hierarchie" />

Jede Hosting-Website hat einen „Live“-Kanal, über den Inhalte gesendet werden, und eine Hosting-Konfiguration unter (1) den von Firebase bereitgestellten Subdomains der Website (SITE_ID.web.app und SITE_ID.firebaseapp.com) und (2) allen verbundenen benutzerdefinierten Domains. Optional können Sie auch „Vorschaukanäle“ erstellen, die eigene Inhalte und eine eigene Konfiguration über temporäre, freigegebene „Vorschau-URLs“ (SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app) bereitstellen.

Die Inhalte und die Konfiguration, die über jeden Kanal bereitgestellt werden, werden in einem Version-Objekt mit einer eindeutigen Kennung verpackt. Beim Bereitstellen auf Ihrer Website erstellt Firebase ein Release-Objekt, das auf eine bestimmte Version verweist. Ein Release enthält Metadaten zur Bereitstellung, z. B. wer die Bereitstellung vorgenommen hat und wann.

Im HostingDashboard Ihres Firebase-Projekts finden Sie in der Tabelle Release-Verlauf einen vollständigen Verlauf der Releases Ihres Live-Kanals. Wenn Sie mehrere Hosting-Websites haben, klicken Sie bei der gewünschten Website auf Ansehen, um den Veröffentlichungsverlauf aufzurufen. Falls du Vorschaukanäle hast, werden diese auch auf dem Hosting-Dashboard angezeigt.

Einstellungen eines Kanals verwalten

Sie können die Einstellungen für jeden Kanal Ihrer Website verwalten. Einige Einstellungen wie die Kanalaktivierungsdauer gelten nur für Vorschaukanäle.

Anzahl der beizubehaltenden Releases begrenzen

Jedes Mal, wenn Sie eine Bereitstellung auf einem Kanal vornehmen und einen Release erstellen, speichert Hosting die Version, die dem vorherigen Release zugeordnet ist, im Hosting-Speicher Ihres Projekts. Sie können die Anzahl der Releases festlegen, die für jeden Kanal in Ihrem Projekt beibehalten werden sollen, sowohl für Live- als auch für Vorschaukanäle.

  • Warum behält Hosting vorherige Releases bei?
    Wenn du frühere Releases für deinen Livekanal bewahrst, kannst du bei Bedarf ein Rollback auf eine frühere Version deiner Website durchführen. Für deine Vorschaukanäle ist ein Rollback noch nicht möglich.

  • Warum sollte die Anzahl der zu behaltenden Releases begrenzt werden?
    Mit dieser Funktion können Sie die Auslastung des Hosting-Speichers Ihres Projekts steuern, da die Inhalte früherer Releases in diesem Speicher aufbewahrt werden. Sie können den Hosting-Speicher in der Console auf dem Tab Speicher beobachten.

  • Was passiert, wenn ich die Anzahl der zu behaltenden Releases einschränke?
    Wenn Sie ein Limit für zu behaltende Releases festlegen, werden die Inhalte aller Releases, die das Limit überschreiten, zum Löschen vorgesehen. Das Löschen erfolgt beginnend mit den ältesten Releases.

So legen Sie das Speicherplatzlimit für Releases für einen Kanal fest:

  1. Rufen Sie in der Firebase-Konsole das Dialogfeld mit den Einstellungen für den Releasespeicher auf:

    • Für deinen Livekanal
      Klicke in der Tabelle Release-Verlauf für deine Website auf und wähle dann Release-Speichereinstellungen aus.

    • Für einen Vorschaukanal
      Klicken Sie in der Zeile für den Vorschaukanal auf  und wählen Sie Kanaleinstellungen aus.

  2. Gib die Anzahl der Releases ein, die du behalten möchtest, und klicke dann auf Speichern.

Ablaufdatum für einen Vorschaukanal festlegen

Ein Vorschaukanal läuft standardmäßig sieben Tage nach dem Erstellungsdatum ab. Der Livekanal Ihrer Website läuft jedoch nie ab.

Wenn ein Vorschaukanal abläuft, werden der Kanal sowie seine Releases und zugehörigen Versionen innerhalb von 24 Stunden zum Löschen vorgemerkt. Die zugehörige Vorschau-URL wird ebenfalls deaktiviert. Eine Ausnahme vom Löschen von Versionen ist, wenn eine Version mit einem anderen Release verknüpft ist. Dies ist beispielsweise der Fall, wenn Sie eine Version von einem Kanal zum anderen auf derselben Website klonen.

Hosting unterstützt zwei verschiedene Möglichkeiten, das Ablaufen eines Kanals zu steuern:

  • Firebase Console
    Klicke in der Zeile für den Vorschaukanal auf  und wähle Kanaleinstellungen aus. Geben Sie das Ablaufdatum und die Ablaufzeit ein.

  • Firebase-Befehlszeile
    Übergeben Sie beim Bereitstellen in Ihrem Vorschaukanal das Flag --expires DURATION. Beispiel:

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

    Die Gültigkeitsdauer kann bis zu 30 Tage ab dem Datum der Bereitstellung betragen. Verwenden Sie h für Stunden, d für Tage und w für Wochen (z. B. 12h, 7d und 2w).

Versionen von einem Kanal in einen anderen klonen

Sie können eine bereitgestellte Version von einem Kanal in einen anderen klonen. Du kannst zwischen Live- oder Vorschaukanälen, zwischen Hosting-Websites oder sogar zwischen Firebase-Projekten klonen.

Mit dem Befehl „clone“ wird der Inhalt und die Konfiguration der geklonten Hosting auch auf dem Zielkanal bereitgestellt, sodass sie automatisch über die zugehörige URL des Zielkanals ausgeliefert werden.

Diese Funktion ist nützlich für das Versionstracking oder wenn Sie sicher sein möchten, dass Sie genau die Inhalte bereitstellen, die Sie sich in einem anderen Kanal angesehen und/oder getestet haben. Hier sind einige Beispiele:

  • Klonen Sie von einem "QA"-Vorschaukanal in den Live-Kanal Ihrer Website.

  • Klonen Sie die Website aus dem Live-Kanal in einen Vorschaukanal für die Fehlerbehebung (z. B. vor einem Rollback).

  • Kanal aus dem Firebase-Stagingprojekt in einen Vorschaukanal im Firebase-Produktionsprojekt klonen

Führen Sie in einem beliebigen Verzeichnis den folgenden Befehl aus, um eine Version zu klonen:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

Ersetzen Sie jeden Platzhalter durch Folgendes:

  • SOURCE_SITE_ID und TARGET_SITE_ID: Dies sind die IDs der Hosting-Websites, die die Channels enthalten.

    • Verwenden Sie für Ihre Hosting-Standardwebsite Ihre Firebase-Projekt-ID.
    • Sie können Hosting Websites angeben, die sich im selben oder in verschiedenen Firebase-Projekten befinden.

  • SOURCE_CHANNEL_ID und TARGET_CHANNEL_ID: Dies sind die IDs der Kanäle.

    • Verwende für einen Livekanal live als Kanal-ID.
    • Wenn der angegebene Zielkanal noch nicht vorhanden ist, wird mit diesem Befehl der Kanal vor der Bereitstellung erstellt.

Rollback auf eine frühere Version Ihrer Website durchführen

Sie können ein Rollback durchführen, um eine frühere Version des Live-Kanals Ihrer Website auszuliefern. Diese Aktion ist nützlich, wenn bei Ihrer aktuellen Version ein Problem auftritt und Sie zu einer bekannten funktionierenden Version Ihrer Website zurückkehren möchten. Vielleicht wurden auf Ihrer Website auch vorübergehende Inhalte für einen Feiertag oder ein besonderes Ereignis ausgeliefert, Sie möchten aber jetzt wieder Ihre „normalen“ Inhalte präsentieren.

Wenn Sie ein Rollback durchführen, erstellen Sie einen neuen Release, bei dem dieselben Inhalte wie bei einem vorherigen Release ausgeliefert werden. In der Tabelle Release-Verlauf wird für beide Releases dieselbe Versions-ID angezeigt.

So führen Sie ein Rollback durch:

  1. Bewegen Sie in der Firebase Console in der Tabelle Release-Verlauf für Ihre Website den Mauszeiger auf den vorherigen Release-Eintrag, zu dem Sie ein Rollback ausführen möchten.

  2. Klicken Sie auf  und wählen Sie Rollback ausführen aus.

Release manuell löschen

Möglicherweise musst du eine Veröffentlichung manuell aus deinem Live-Kanal löschen, um Hosting Speicherplatz für dein Projekt freizugeben. Sie können nur vorherige Releases löschen, nicht den Release, der derzeit auf Ihrer Live-Website ausgeliefert wird.

Wenn Sie einen Release löschen, werden die zugehörigen Inhalte gelöscht, die innerhalb von 24 Stunden gelöscht werden. Das Release-Objekt selbst wird aufbewahrt, damit Sie die Metadaten (wer und wann es bereitgestellt wurde) weiterhin sehen können.

So löschen Sie einen Release:

  1. Bewegen Sie in der Firebase Console den Mauszeiger in der Tabelle Release-Verlauf für Ihre Website auf den vorherigen Release-Eintrag, den Sie löschen möchten.

  2. Klicken Sie auf  und wählen Sie Löschen aus.

Dateien manuell löschen

In Firebase Hosting werden ausgewählte Dateien von einer bereitgestellten Website primär dadurch gelöscht, dass Sie die Dateien lokal löschen und dann noch einmal bereitstellen.

Vorschaukanal manuell löschen

Sie können sich eine Vorschau Ihrer Kanäle ansehen, indem Sie auf den gewünschten Kanal klicken. In dieser Ansicht können Sie die neuesten Bereitstellungen und Releases, die mit dem jeweiligen Kanal verknüpft sind, ansehen, löschen und zurücksetzen. Sie können einen Vorschaukanal löschen, den Livekanal Ihrer Website jedoch nicht.

Wenn Sie einen Vorschaukanal löschen, werden der Kanal sowie seine Releases und zugehörigen Versionen innerhalb von 24 Stunden zum Löschen vorgemerkt. Die zugehörige Vorschau-URL wird ebenfalls deaktiviert. Eine Ausnahme vom Löschen von Versionen besteht, wenn eine Version mit einem anderen Release verknüpft ist. Das ist beispielsweise der Fall, wenn Sie eine Version innerhalb derselben Website von einem Kanal in einen anderen klonen.

Hosting unterstützt zwei Möglichkeiten, einen Vorschaukanal zu löschen:

  • Firebase Console
    Klicken Sie in der Zeile für den Vorschaukanal auf und wählen Sie dann Channel löschen aus. Bestätigen Sie den Löschvorgang.

  • Firebase CLI
    Führen Sie den folgenden Befehl in einem beliebigen Verzeichnis aus:

    firebase hosting:channel:delete CHANNEL_ID

Befehle für die Befehlszeile für Vorschaukanäle und Klonen

Befehle für Vorschaukanäle

Alle Befehle für Vorschaukanäle unterstützen Bereitstellungsziele, wenn Sie mehrere Hosting-Websites haben.

Befehl Beschreibung
firebase hosting:channel:create CHANNEL_ID

Erstellt mit dem angegebenen CHANNEL_ID einen neuen Vorschaukanal auf der standardmäßigen Hosting-Website.

Dieser Befehl führt keine Bereitstellung auf dem Kanal aus.
firebase hosting:channel:delete CHANNEL_ID

Löscht den angegebenen Vorschaukanal.

Der Livekanal einer Website kann nicht gelöscht werden.
firebase hosting:channel:deploy CHANNEL_ID

Stellt die Inhalte und die Konfiguration von Hosting im angegebenen Vorschaukanal bereit

Wenn der Vorschaukanal noch nicht vorhanden ist, wird er mit diesem Befehl auf der Standardwebsite Hosting erstellt, bevor er auf dem Kanal bereitgestellt wird.

firebase hosting:channel:list Listet alle Kanäle (einschließlich des „Live“-Kanals) auf der Standardseite von Hosting auf.
firebase hosting:channel:open CHANNEL_ID Öffnet einen Browser mit der URL des angegebenen Kanals oder gibt die URL zurück, wenn das Öffnen in einem Browser nicht möglich ist

Befehle zum Klonen von Versionen

Befehl Beschreibung
firebase hosting:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

Die zuletzt bereitgestellte Version auf dem angegebenen Quellkanal wird auf dem angegebenen Zielkanal geklont.

Dieser Befehl wird auch für den angegebenen Zielkanal bereitgestellt. Wenn der Kanal "target" noch nicht vorhanden ist, erstellt dieser Befehl vor der Bereitstellung auf dem Kanal einen neuen Vorschaukanal auf der Hosting-Website "target".

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

Die angegebene Version wird auf den angegebenen Zielkanal geklont.

Dieser Befehl wird auch für den angegebenen Zielkanal bereitgestellt. Wenn der Kanal „target“ noch nicht vorhanden ist, wird mit diesem Befehl ein neuer Vorschaukanal auf der Ziel-Hosting-Website erstellt, bevor die Bereitstellung auf dem Kanal erfolgt.

Sie finden die VERSION_ID im Hosting-Dashboard der Firebase-Konsole.