Verwalten Sie Live & Vorschaukanäle, Veröffentlichungen und Versionen für Ihre Website anzeigen

Firebase Hosting stellt über die Firebase-Konsole und die Firebase-CLI Tools zur Verwaltung der Kanäle, Releases und Versionen für Ihre Hosting-Site bereit.

Überblick über die Hosting-Infrastruktur

Das Verständnis der Hosting-Infrastruktur hilft Ihnen, die auf dieser Seite beschriebenen Verwaltungsoptionen zu verstehen.

Jedes Firebase-Projekt verfügt über eine Standard-Hosting- Site mit Zugriff auf alle Ressourcen des Projekts (Datenbanken, Authentifizierung, Funktionen usw.). Eine Site enthält einen oder mehrere Kanäle , wobei jeder Kanal einer URL zugeordnet ist, die bestimmte Inhalte bereitstellt, und einer Hosting-Konfiguration.

ein Bild der Firebase Hosting-Hierarchie

Jede Hosting-Site verfügt über einen „Live“-Kanal, der Inhalte und eine Hosting-Konfiguration auf (1) den von Firebase bereitgestellten Subdomains der Site ( SITE_ID .web.app und SITE_ID .firebaseapp.com ) und (2) allen verbundenen benutzerdefinierten Domains bereitstellt. Sie können optional auch „Vorschau“-Kanäle erstellen, die ihren eigenen Inhalt und ihre eigene Konfiguration unter temporären, gemeinsam nutzbaren „Vorschau-URLs“ bereitstellen ( SITE_ID -- CHANNEL_ID - RANDOM_HASH .web.app ).

Der von jedem Kanal bereitgestellte Inhalt und die Konfiguration werden in ein Versionsobjekt gepackt, das über eine eindeutige Kennung verfügt. Wenn Sie auf Ihrer Site bereitstellen, erstellt Firebase ein Release- Objekt, das auf eine bestimmte Version verweist. Eine Veröffentlichung enthält Metadaten über die Bereitstellung, z. B. wer die Bereitstellung durchgeführt hat und wann.

Im Hosting-Dashboard Ihres Firebase-Projekts können Sie den vollständigen Verlauf der Veröffentlichungen Ihres Live-Kanals in einer Veröffentlichungsverlaufstabelle sehen. Wenn Sie über mehrere Hosting-Sites verfügen, klicken Sie für die gewünschte Site auf Anzeigen , um deren Veröffentlichungsverlauf anzuzeigen. Wenn Sie über Vorschaukanäle verfügen, werden diese auch im Hosting-Dashboard angezeigt.

Verwalten Sie die Einstellungen eines Kanals

Für jeden Kanal Ihrer Site können Sie dessen Einstellungen steuern. Einige Einstellungen, wie z. B. das Ablaufdatum des Kanals, gelten nur für Vorschaukanäle.

Begrenzen Sie die Anzahl der zu behaltenden Releases

Jedes Mal, wenn Sie auf einem Kanal bereitstellen (und ein Release erstellen), behält Hosting die mit dem vorherigen Release verknüpfte Version im Hosting-Speicher Ihres Projekts. Sie können die Anzahl der Veröffentlichungen festlegen, die für jeden Kanal in Ihrem Projekt aufbewahrt werden sollen, sowohl für Live- als auch für Vorschaukanäle.

  • Warum behält Hosting frühere Versionen bei?
    Wenn Sie für Ihren Live-Kanal frühere Versionen behalten, können Sie bei Bedarf auf eine frühere Version Ihrer Website zurückgreifen . Für Ihre Vorschaukanäle ist ein Rollback noch nicht verfügbar.

  • Warum die Anzahl der zu behaltenden Releases begrenzen?
    Mit dieser Funktion können Sie den Nutzungsgrad des Hosting-Speichers Ihres Projekts steuern, da der Inhalt früherer Versionen in diesem Speicher aufbewahrt wird. Sie können Ihren Hosting-Speicher über die Registerkarte „Speicher“ in der Konsole überwachen.

  • Was passiert, wenn Sie die Anzahl der zu behaltenden Releases beschränken?
    Wenn Sie ein Limit für die Aufbewahrung von Veröffentlichungen festlegen, wird der Inhalt aller Veröffentlichungen, die Ihr festgelegtes Limit überschreiten, zum Löschen eingeplant, beginnend mit den ältesten Veröffentlichungen zuerst .

So legen Sie das Release-Speicherlimit für einen Kanal fest:

  1. Greifen Sie in der Firebase-Konsole auf das Dialogfeld „Release-Speichereinstellungen“ zu:

    • Für Ihren Live-Kanal
      Klicken Sie in der Tabelle „Release-Verlauf“ für Ihre Site auf und wählen Sie dann „Release-Speichereinstellungen“ aus.

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

  2. Geben Sie die Anzahl der Veröffentlichungen ein, die Sie behalten möchten, und klicken Sie dann auf Speichern .

Legen Sie den Ablauf eines Vorschaukanals fest

Standardmäßig läuft ein Vorschaukanal sieben Tage nach seinem Erstellungsdatum ab, der Live-Kanal Ihrer Website läuft jedoch nie ab.

Wenn ein Vorschaukanal abläuft, ist die Löschung des Kanals sowie seiner Veröffentlichungen und zugehörigen Versionen innerhalb von 24 Stunden geplant. Die zugehörige Vorschau-URL ist ebenfalls deaktiviert. Eine Ausnahme von dieser Versionslöschung besteht, wenn eine Version mit einer anderen Version verknüpft ist (dies geschieht beispielsweise, wenn Sie eine Version von einem Kanal auf einen anderen innerhalb derselben Site klonen).

Hosting unterstützt zwei verschiedene Möglichkeiten, den Ablauf eines Kanals zu steuern:

  • Firebase-Konsole
    Klicken Sie in der Zeile für den Vorschaukanal auf und wählen Sie dann Kanaleinstellungen aus. Geben Sie Datum und Uhrzeit für den Ablauf ein.

  • Firebase-CLI
    Übergeben Sie bei der Bereitstellung in Ihrem Vorschaukanal das Flag --expires DURATION , zum Beispiel:

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

    Der Ablauf kann bis zu 30 Tage ab dem Bereitstellungsdatum betragen. Verwenden Sie h für Stunden, d für Tage und w für Wochen (z. B. 12h , 7d bzw. 2w ).

Klonen Sie eine Version von einem Kanal auf einen anderen

Sie können eine bereitgestellte Version von einem Kanal auf einen anderen Kanal klonen. Sie können über Live- oder Vorschaukanäle, über Hosting-Sites oder sogar über Firebase-Projekte hinweg klonen.

Der Klonbefehl wird auch auf dem „Ziel“-Kanal bereitgestellt , sodass der geklonte Hosting-Inhalt und die geklonte Konfiguration automatisch unter der zugehörigen URL des „Ziel“-Kanals bereitgestellt werden.

Diese Funktion ist nützlich für die Versionsverfolgung oder wenn Sie sicher sein möchten, dass Sie genau den Inhalt bereitstellen, den Sie auf einem anderen Kanal angesehen und/oder getestet haben. Hier sind einige Beispiele:

  • Klonen Sie von einem „QA“-Vorschaukanal auf den Live-Kanal Ihrer Website (Live-Schaltung!)

  • Klonen Sie vom Live-Kanal Ihrer Website in einen „Debug“-Vorschaukanal (wie vor einem Rollback).

  • Klonen Sie von einem Kanal in Ihrem „Staging“-Firebase-Projekt in einen Vorschaukanal in Ihrem „Prod“-Firebase-Projekt

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

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-Sites, die die Kanäle enthalten.

    • Verwenden Sie für Ihre Standard-Hosting-Site Ihre Firebase-Projekt-ID.
    • Sie können Hosting-Sites angeben, die sich im selben Firebase-Projekt oder sogar in verschiedenen Firebase-Projekten befinden.
  • SOURCE_CHANNEL_ID und TARGET_CHANNEL_ID : Dies sind die Kennungen für die Kanäle.

    • Für einen Live-Kanal verwenden Sie live als Kanal-ID.
    • Wenn der angegebene „Ziel“-Kanal noch nicht existiert, erstellt dieser Befehl den Kanal, bevor er ihn bereitstellt.

Führen Sie einen Rollback zu einer früheren Version Ihrer Website durch

Sie können ein Rollback durchführen, um eine frühere Version des Live-Kanals Ihrer Website bereitzustellen. Diese Aktion ist nützlich, wenn bei Ihrer aktuellen Version ein Problem auftritt und Sie ein Rollback durchführen möchten, um eine bekanntermaßen funktionierende Version Ihrer Website bereitzustellen. Oder vielleicht hat Ihre Website temporäre Inhalte für einen Feiertag oder ein besonderes Ereignis bereitgestellt, aber jetzt möchten Sie auf die Bereitstellung Ihrer „normalen“ Inhalte zurückgreifen.

Durch ein Rollback erstellen Sie eine neue Version, die dieselbe Inhaltsversion wie eine frühere Version bereitstellt. In Ihrer Release-Verlaufstabelle werden beide Releases dieselbe Versionskennung enthalten.

So führen Sie einen Rollback durch:

  1. Bewegen Sie in der Firebase-Konsole in der Tabelle „Release-Verlauf“ für Ihre Site den Mauszeiger über den vorherigen Release-Eintrag, zu dem Sie ein Rollback durchführen möchten.

  2. Klicken Sie auf und wählen Sie dann Rollback aus.

Eine Veröffentlichung manuell löschen

Möglicherweise müssen Sie eine Veröffentlichung manuell aus Ihrem Live-Kanal löschen, um Hosting-Speicherplatz für Ihr Projekt freizugeben. Sie können nur frühere Veröffentlichungen löschen, nicht jedoch die Veröffentlichung, die derzeit auf Ihrer Live-Site bereitgestellt wird.

Wenn Sie eine Veröffentlichung löschen, löschen Sie tatsächlich deren Inhalt, dessen Löschung innerhalb von 24 Stunden geplant ist. Das Release-Objekt selbst bleibt erhalten, sodass Sie weiterhin seine Metadaten sehen können (wer hat es bereitgestellt und wann es bereitgestellt hat).

So löschen Sie eine Veröffentlichung:

  1. Bewegen Sie in der Firebase-Konsole in der Tabelle „Release-Verlauf“ für Ihre Site den Mauszeiger über den vorherigen Release-Eintrag, den Sie löschen möchten.

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

Löschen Sie einen Vorschaukanal manuell

Sie können eine Vorschau Ihrer Kanäle anzeigen, indem Sie auf den Kanal klicken, den Sie in der Vorschau anzeigen möchten. In dieser Ansicht können Sie die neuesten Bereitstellungen und Releases, die mit dem jeweiligen Kanal verknüpft sind, anzeigen, löschen und zurücksetzen. Sie können einen Vorschaukanal löschen, aber Sie können den Live-Kanal Ihrer Website nicht löschen.

Wenn Sie einen Vorschaukanal löschen, ist die Löschung des Kanals sowie seiner Veröffentlichungen und zugehörigen Versionen innerhalb von 24 Stunden geplant. Die zugehörige Vorschau-URL ist ebenfalls deaktiviert. Eine Ausnahme von der Versionslöschung besteht, wenn eine Version mit einer anderen Version verknüpft ist (dies geschieht beispielsweise, wenn Sie eine Version von einem Kanal auf einen anderen innerhalb derselben Site klonen).

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

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

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

    firebase hosting:channel:delete CHANNEL_ID

CLI-Befehle für Vorschaukanäle und Klonen

Befehle für Vorschaukanäle

Alle Befehle für Vorschaukanäle unterstützen die Bereitstellung von Zielen, wenn Sie über mehrere Hosting-Sites verfügen.

Befehl Beschreibung
firebase hosting:channel:create CHANNEL_ID

Erstellt einen neuen Vorschaukanal auf der Standard- Hosting-Site unter Verwendung der angegebenen CHANNEL_ID

Dieser Befehl wird nicht auf dem Kanal bereitgestellt.

firebase hosting:channel:delete CHANNEL_ID

Löscht den angegebenen Vorschaukanal

Sie können den Live-Kanal einer Site nicht löschen.

firebase hosting:channel:deploy CHANNEL_ID

Stellt Ihren Hosting-Inhalt und Ihre Hosting-Konfiguration im angegebenen Vorschaukanal bereit

Wenn der Vorschaukanal noch nicht vorhanden ist, erstellt dieser Befehl den Kanal auf der Standard- Hosting-Site, bevor er im Kanal bereitgestellt wird.

firebase hosting:channel:list Listet alle Kanäle (einschließlich des „Live“-Kanals) auf der Standard- Hosting-Site 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 Versionsklonen

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

Klont die zuletzt bereitgestellte Version auf dem angegebenen „Quell“-Kanal auf den angegebenen „Ziel“-Kanal

Dieser Befehl wird auch auf dem angegebenen „Ziel“-Kanal bereitgestellt. Wenn der „Ziel“-Kanal noch nicht existiert, erstellt dieser Befehl einen neuen Vorschaukanal auf der „Ziel“-Hosting-Site, bevor er auf dem Kanal bereitgestellt wird.

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

Klont die angegebene Version auf den angegebenen „Ziel“-Kanal

Dieser Befehl wird auch auf dem angegebenen „Ziel“-Kanal bereitgestellt. Wenn der „Ziel“-Kanal noch nicht existiert, erstellt dieser Befehl einen neuen Vorschaukanal auf der „Ziel“-Hosting-Site, bevor er auf dem Kanal bereitgestellt wird.

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