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 verstehen, können Sie die die auf dieser Seite beschrieben werden.

Jedes Firebase-Projekt hat eine standardmäßige Hosting-Website mit Zugriff auf alle die Ressourcen des Projekts (Datenbanken, Authentifizierung, Funktionen usw.). Website enthält einen oder mehrere Channels, wobei jedem Channel eine URL zugeordnet ist. die bestimmte Inhalte und eine Hosting-Konfiguration bereitstellt.

ein Bild von <span class=Firebase Hosting-Hierarchie“

Jede Hosting-Website hat eine "Live"- Kanal mit Inhalten und einer Hosting-Konfiguration auf (1) den über Firebase bereitgestellten Subdomains der Website (SITE_ID.web.app und SITE_ID.firebaseapp.com) und (2) alle verbundenen benutzerdefinierten Domains. Sie können auch optional „preview“ die vorübergehend eigene Inhalte und Konfigurationen zur Verfügung stellen, Vorschau-URLs, die freigegeben werden können (SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app).

Der Inhalt und die Konfiguration, die von jedem Kanal bereitgestellt werden, werden in einer version-Objekt, das eine eindeutige Kennung hat. Bei der Bereitstellung auf Ihrer Website Firebase erstellt ein Release-Objekt, das auf eine bestimmte Version verweist. A Release enthält Metadaten zur Bereitstellung, z. B. wer sie bereitgestellt hat und wann bereitgestellt.

Aus dem Hosting-Dashboard, findest du den vollständigen Veröffentlichungsverlauf für deinen Kanal in einem Tabelle mit Veröffentlichungsverlauf. Wenn Sie mehreren Hosting Websites auf Anzeigen klicken für um den Releaseverlauf anzuzeigen. Wenn Sie Vorschaukanäle haben, Sie werden auch auf dem Hosting-Dashboard angezeigt.

Kanaleinstellungen verwalten

Sie können für jeden Channel Ihrer Website die zugehörigen Einstellungen festlegen. Einige Einstellungen, wie Ablaufzeit des Kanals, gelten nur für Vorschaukanäle.

Anzahl der beizubehaltenden Releases begrenzen

Jedes Mal, wenn Sie die Bereitstellung in einem Kanal vornehmen (und einen Release erstellen), behält Hosting die Version, die mit dem vorherigen Release in der Hosting Ihres Projekts verknüpft ist Speicherplatz. Du kannst die Anzahl der Veröffentlichungen festlegen, die du für jeden Kanal in deinem sowohl auf dem Live- als auch auf dem Vorschaukanal.

  • Warum speichert Hosting frühere Releases?
    Wenn du frühere Veröffentlichungen für deinen Live-Kanal bewahrst, kannst du: Bei Bedarf können Sie ein Rollback auf eine frühere Version Ihrer Website durchführen. Für deiner Vorschaukanäle nicht verfügbar ist, ist ein Rollback noch nicht möglich.

  • Warum sollte die Anzahl der Releases begrenzt werden, die aufbewahrt werden sollen?
    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 Ihre Hosting Speicherplatz von Tab Speicher in der Konsole.

  • Was passiert, wenn du die zu behaltenden Releases einschränkst?
    Wenn du ein Limit für die Beibehaltung von Releases festlegst, werden die Inhalte von Releases über das von Ihnen festgelegte Limit zum Löschen vorgemerkt ist, die mit den ältesten Releases zuerst beginnen.

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

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

    • Für deinen Live-Kanal
      Klicken Sie in der Tabelle Veröffentlichungsverlauf für Ihre Website auf , dann auswählen Release-Speichereinstellungen.

    • Für alle Vorschaukanäle
      Klicken Sie in der Zeile für den Vorschaukanal auf , dann wählen Sie Kanaleinstellungen:

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

Ablaufdatum für einen Vorschaukanal festlegen

Standardmäßig läuft ein Vorschaukanal sieben Tage nach dem Erstellungsdatum ab. läuft nie ab.

Wenn ein Vorschaukanal abläuft, werden der Kanal und die zugehörigen Veröffentlichungen und Versionen verknüpft sind, werden innerhalb von 24 Stunden zum Löschen vorgemerkt. Die zugehörige Vorschau-URL ebenfalls deaktiviert. Eine Ausnahme hiervon Löschung einer Version bedeutet, dass eine Version mit einem anderen Release verknüpft ist (diese z. B. wenn Sie eine Version von einem Kanal in eine andere klonen. auf derselben Website).

Hosting unterstützt zwei verschiedene Möglichkeiten, um den Ablauf 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 bei der Bereitstellung in Ihrem Vorschaukanal den --expires DURATION. Beispiel:

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

    Das Ablaufdatum kann ab dem Datum der Bereitstellung bis zu 30 Tage betragen. h verwenden für Stunden, d für Tage und w für Wochen (z. B. 12h, 7d, 2w, )

Version von einer Version zu einer anderen klonen

Sie können eine bereitgestellte Version von einem Kanal auf einen anderen klonen. Ich kann für Live- oder Vorschaukanäle, Hosting Websites oder sogar in Firebase-Projekten nutzen können.

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 Versions-Tracking oder wenn Sie sicher sein möchten, dass Sie die genauen Inhalte bereitstellen, die Sie sich in einem anderen Kanal angesehen und/oder getestet haben. Hier sind einige Beispiele:

  • Von einem QA-Team klonen Vorschaukanal zum Live-Kanal Ihrer Website (Veröffentlichung erfolgt)

  • 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 den folgenden Befehl aus einem beliebigen Verzeichnis 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 Kanäle 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 für die Channels.

    • Verwende für einen Livekanal live als Kanal-ID.
    • Wenn das angegebene Ziel channel noch nicht vorhanden ist, erstellt dieser Befehl Version vor der Bereitstellung.

Rollback auf eine vorherige Version Ihrer Website durchführen

Du kannst ein Rollback durchführen, um eine frühere Version des Live-Kanals deiner Website bereitzustellen. Dieses Diese Maßnahme ist nützlich, wenn es bei Ihrem aktuellen Release ein Problem gibt und Sie ein Rollback durchführen möchten um eine bekannte Arbeitsversion Ihrer Website bereitzustellen. Oder vielleicht hat Ihre Website temporäre Inhalte für einen Feiertag oder einen besonderen Anlass, aber jetzt möchten Sie um Ihre „normalen“ Inhalte.

Durch ein Rollback erstellen Sie einen neuen Release, der dieselbe Version wie in der vorherigen Veröffentlichung. In der Tabelle Release-Verlauf sind beide Releases wird 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 durchführen.

Release manuell löschen

Möglicherweise musst du eine Veröffentlichung manuell von deinem Live-Kanal löschen, um Speicherplatz freizugeben Hosting Speicherplatz für Ihr Projekt. Ich kann nur frühere Releases löschen, nicht den Release, der aktuell für auf Ihrer Live-Website.

Wenn Sie eine Veröffentlichung löschen, löschen Sie damit den zugehörigen Inhalt. innerhalb von 24 Stunden zum Löschen vorgemerkt. Das Release-Objekt selbst wird beibehalten, damit Sie die Metadaten weiterhin sehen können (wer und wann sie bereitgestellt wurden).

So löschst du eine Version:

  1. Im Firebase-Konsole, Bewegen Sie den Mauszeiger in der Tabelle Veröffentlichungsverlauf 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.

Dateien manuell löschen

Die primäre Methode zum Löschen ausgewählter Dateien in Firebase Hosting von einer bereitgestellten Website besteht darin, die Dateien lokal zu löschen und sie dann noch einmal bereitzustellen.

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 die mit dem jeweiligen Kanal verknüpft sind. Du kannst einen Vorschaukanal Sie können den Live-Kanal Ihrer Website jedoch nicht löschen.

Wenn Sie einen Vorschaukanal löschen, werden der Kanal und die zugehörigen Veröffentlichungen und Versionen verknüpft sind, werden innerhalb von 24 Stunden zum Löschen vorgemerkt. Die zugehörige Vorschau-URL ebenfalls deaktiviert. Eine Ausnahme von der Löschung einer Version bedeutet, dass eine Version mit einem anderen Release verknüpft ist (diese z. B. wenn Sie eine Version von einem Kanal in eine andere klonen. auf derselben Website).

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

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

  • Firebase Befehlszeile
    Führen Sie den folgenden Befehl in 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 Bereitstellungsziele, wenn Sie mehrere Hosting-Websites haben.

Befehl Beschreibung
firebase hosting:channel:create CHANNEL_ID

Erstellt einen neuen Vorschaukanal auf der Standardwebsite Hosting mit der angegebenen 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 Website nicht löschen.

firebase hosting:channel:deploy CHANNEL_ID

Stellt den Inhalt und die Konfiguration von Hosting auf der angegebenen Vorschaukanal

Wenn der Vorschaukanal noch nicht vorhanden ist, wird mit diesem Befehl die Methode Channel auf der standardmäßigen Hosting-Website bevor sie im Kanal bereitgestellt werden.

firebase hosting:channel:list Listet alle Kanäle auf (einschließlich des "Live"-Kanals) im default 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 im 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 das angegebene „Ziel“ bereitgestellt Kanal. Wenn die "Ziel" channel noch nicht vorhanden ist, wird mit diesem Befehl ein neuer Vorschaukanal im Bereich „Ziel“ Hosting Website vor der Bereitstellung auf für den Kanal.

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

Klont die angegebene Version in das angegebene „Ziel“ Kanal

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

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