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

Firebase Hosting bietet Tools sowohl über die Firebase-Konsole als auch über die Firebase-CLI, um die Kanäle, Releases und Versionen für Ihre Hosting-Site zu verwalten.

Überblick über die Hosting-Infrastruktur

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

Jedes Projekt Firebase verfügt über eine Standard - Hosting - Website mit Zugriff auf alle Projektressourcen (Datenbanken, Authentifizierung, Funktionen, etc.). Eine Seite enthält eine oder mehrere Kanäle, wobei jeder Kanal mit einer URL zugeordnet ist , die spezifischen Inhalte und eine Hosting - Konfiguration dient.

ein Bild der Firebase Hosting-Hierarchie

Jede Host - Website hat einen „live“ Kanal, den Inhalt und eine Hosting - Konfiguration auf (1) die Site-Firebase bereitgestellt Subdomänen (dient SITE_ID .web.app und SITE_ID .firebaseapp.com ) und (2) all angeschlossenen individuellen Domänen . Sie können auch erstellen optional „Vorschau“ Kanäle , die ihre eigenen Inhalte und Konfiguration auf zeitlich begrenzten, gemeinsam nutzbaren „Vorschau - URLs“ dienen ( SITE_ID -- CHANNEL_ID - RANDOM_HASH .web.app ).

Der Inhalt und die Konfiguration , die durch jeden Kanal bedient wird , in eine Version zu verpackende Objekt , das eine eindeutige Kennung hat. Wenn Sie auf Ihrer Website bereitstellen, Firebase erzeugt ein Freigabeobjekt , dass Punkte auf eine bestimmte Version. Ein Release enthält Metadaten zur Bereitstellung, z. B. wer bereitgestellt hat und wann sie bereitgestellt wurden.

Von Ihrer Firebase Projekt - Hosting - Armaturenbrett , können Sie eine vollständige Geschichte Ihres Live - Kanales Releases in einer Veröffentlichung der Geschichte Tabelle. Wenn Sie mehrere Hosting - Sites , klicken Sie auf die gewünschte Stelle seiner Veröffentlichung Geschichte zu sehen. Wenn Sie über Vorschaukanäle verfügen, werden diese auch im Hosting-Dashboard angezeigt.

Einstellungen eines Kanals verwalten

Für jeden Kanal Ihrer Website können Sie seine Einstellungen steuern. Einige Einstellungen, wie das Ablaufen von Kanälen, gelten nur für Vorschaukanäle.

Begrenzen Sie die Anzahl der zu behaltenden Veröffentlichungen

Jedes Mal, wenn Sie in einem Kanal bereitstellen (und eine Version erstellen), behält Hosting die Version, die der vorherigen Version zugeordnet ist, im Hosting-Speicher Ihres Projekts. Sie können die Anzahl der Meldungen festgelegt für jeden Kanal in Ihrem Projekt zu halten, sowohl live als auch Vorschau - Kanäle.

  • Warum behält Hosting frühere Versionen bei?
    Für die Live - Kanal, können Sie frühere Versionen halten zu Rollback zu einer früheren Version Ihrer Website, wenn nötig. Für Ihre Vorschaukanäle ist das Rollback noch nicht verfügbar.

  • Warum die Anzahl der zu behaltenden Releases begrenzen?
    Diese Funktion können Sie den Nutzungsgrad Ihrer Kontrolle helfen Projekt Hosten von Speicher , wie der Inhalt für frühere Versionen in dieser Lagerung gehalten. Sie können Ihre Hosting - Speicher aus dem Monitor Registerkarte Speicher in der Konsole.

  • Was passiert, wenn Sie die Freigaben einschränken, um sie zu behalten?
    Wenn Sie eine Grenze für Freisetzungen gesetzt zu halten, wird der Inhalt der Meldungen über Ihre festgelegte Grenze für die Löschung geplant, zunächst mit den ältesten Versionen beginnen.

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

  1. In der Firebase - Konsole , den Zugang des Freigabespeichereinstellungsdialog:

    • Für deinen Live-Kanal
      In der Version Verlauf Tabelle für Ihre Website, klicken Sie , dann Freigabe Speichereinstellungen wählen.

    • Für jeden Vorschaukanal
      In der Zeile für den Vorschau - Kanal, klicken , dann Kanaleinstellungen wählen.

  2. Geben Sie die Anzahl der Meldungen , die Sie möchten halten, dann klicken Sie auf Speichern.

Ablaufdatum eines Vorschaukanals festlegen

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

Wenn ein Vorschaukanal abläuft, wird der Kanal zusammen mit seinen Releases und zugehörigen Versionen innerhalb von 24 Stunden gelöscht. Auch die zugehörige Vorschau-URL ist deaktiviert. Eine Ausnahme von dieser Version-Löschung ist , wenn eine Version mit einem anderen Release zugeordnet ist ( in diesem Fall zum Beispiel, wenn Sie eine Version von einem Kanal zum anderen innerhalb der gleichen Stelle klonen).

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

  • Firebase-Konsole
    In der Zeile für den Vorschau - Kanal, klicken , dann Kanaleinstellungen wählen. Geben Sie Datum und Uhrzeit für das Ablaufdatum ein.

  • Firebase-CLI
    Wenn Sie auf Ihre Vorschau Kanal bereitstellen, übergeben Sie den --expires DURATION Flagge, zum Beispiel:

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

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

Klonen Sie eine Version von einem Kanal auf einen anderen

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

Der Klon - Befehl setzt auch für den „Ziel“ Kanal , so dass der klonierte Hosting - Gehalt und Konfiguration werden automatisch an dem „Ziel“ Kanals zugehöriger URL serviert.

Diese Funktion ist nützlich für Versionskontrolle oder wenn Sie Vertrauen möchten , dass Sie den genauen Inhalt sind die Bereitstellung von Ihnen gesehen haben und / oder auf einem anderen Kanal getestet. Hier sind einige Beispiele:

  • Klonen Sie von einem "QA"-Vorschaukanal in den Live-Kanal Ihrer Website (wird live geschaltet!)

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

  • Klonen Sie von einem Kanal in Ihrem Firebase-Projekt "Staging" in einen Vorschaukanal in Ihrem Firebase-Projekt "Prod".

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 identifers für die Kanäle.

    • Für einen Live - Kanal verwendet live als Kanal - ID.
    • Wenn der angegebene "Ziel"-Kanal noch nicht vorhanden ist, erstellt dieser Befehl den Kanal vor der Bereitstellung.

Rollback zu einer früheren Version Ihrer Website

Sie können ein Rollback durchführen, um eine frühere Version des Live-Kanals Ihrer Website bereitzustellen. Diese Aktion ist nützlich, wenn in Ihrer aktuellen Version ein Problem auftritt und Sie ein Rollback durchführen möchten, um eine bekannte funktionierende Version Ihrer Site bereitzustellen. Oder vielleicht hat Ihre Website temporäre Inhalte für einen Feiertag oder ein besonderes Ereignis bereitgestellt, aber jetzt möchten Sie ein Rollback durchführen, um Ihre "normalen" Inhalte bereitzustellen.

Durch ein Rollback erstellen Sie eine neue Version, die dieselbe Inhaltsversion wie eine vorherige Version bereitstellt. In Ihrer Veröffentlichung Geschichte Tabelle listet beide Versionen die gleiche Versionskennung.

So rollen Sie zurück:

  1. In der Firebase - Konsole , in der Release - History - Tabelle für Ihre Website, schwebt über den vorherigen Release - Eintrag , dass Sie ein Rollback zu.

  2. Klicken Sie , dann wählen Sie ein Rollback.

Release manuell löschen

Möglicherweise müssen Sie manuell eine Freigabe von Ihrem Live - Kanal löschen freizugeben Hosten von Speicher für Ihr Projekt. Sie können nur frühere Versionen löschen, nicht die Version, die derzeit auf Ihrer Live-Site bereitgestellt wird.

Wenn Sie eine Veröffentlichung löschen, löschen Sie tatsächlich ihren Inhalt, der innerhalb von 24 Stunden gelöscht werden soll. Das Release-Objekt selbst wird beibehalten, sodass Sie seine Metadaten weiterhin sehen können (wer und wann bereitgestellt wurden).

So löschen Sie eine Veröffentlichung:

  1. In der Firebase - Konsole , in der Release - History - Tabelle für Ihre Website, schweben über dem vorherigen Release - Eintrag, den Sie löschen möchten.

  2. Klicken Sie , wählen Sie dann Löschen.

Einen Vorschaukanal manuell löschen

Sie können einen Vorschaukanal löschen, den Livekanal Ihrer Website jedoch nicht.

Wenn Sie einen Vorschaukanal löschen, wird der Kanal zusammen mit seinen Releases und zugehörigen Versionen innerhalb von 24 Stunden gelöscht. Auch die zugehörige Vorschau-URL wird deaktiviert. Eine Ausnahme von der Version-Löschung ist , wenn eine Version mit einem anderen Release zugeordnet ist ( in diesem Fall zum Beispiel, wenn Sie eine Version von einem Kanal zum anderen innerhalb der gleichen Stelle klonen).

Das Hosting unterstützt zwei verschiedene Möglichkeiten zum Löschen eines Vorschaukanals:

  • Firebase-Konsole
    In der Zeile für den Vorschaukanal, klicken , dann löscht Kanal wählen. Bestätigen Sie das Löschen.

  • 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 die Vorschau - Kanäle unterstützen deploy Ziele , wenn Sie mehrere Hosting - Sites .

Befehl Beschreibung
firebase hosting:channel:create CHANNEL_ID

Erstellt einen neuen Vorschau - Kanal in der Standard - Hosting - Website des angegebenen Verwendung CHANNEL_ID

Dieser Befehl wird nicht für den 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 Ihre Hosting-Inhalte und -Konfigurationen im angegebenen Vorschaukanal bereit

Wenn der Vorschau - Kanal noch nicht vorhanden ist , erstellt dieser Befehl den Kanal in der Standard - Hosting - Website , bevor auf den Kanal bereitstellen.

firebase hosting:channel:list Listet alle Kanäle (einschließlich der „Live“ -Kanal) in der Standard - Hosting - Website
firebase hosting:channel:open CHANNEL_ID Öffnet einen Browser zur 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

Klont die zuletzt bereitgestellte Version auf dem angegebenen "Quellkanal" auf den angegebenen "Zielkanal".

Dieser Befehl wird auch auf dem angegebenen "Ziel"-Kanal bereitgestellt. Wenn der "Ziel"-Kanal noch nicht vorhanden ist, erstellt dieser Befehl einen neuen Vorschaukanal auf der "Ziel"-Hosting-Site, bevor er für den Kanal bereitgestellt wird.

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

Klont die angegebene Version in den angegebenen "Ziel"-Kanal

Dieser Befehl wird auch auf dem angegebenen "Ziel"-Kanal bereitgestellt. Wenn der "Ziel"-Kanal noch nicht vorhanden ist, erstellt dieser Befehl einen neuen Vorschaukanal auf der "Ziel"-Hosting-Site, bevor er im Kanal bereitgestellt wird.

Sie können den finden VERSION_ID im Hosting Armaturenbrett der Firebase - Konsole.