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

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

Ü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 Standard-Hosting-Website mit Zugriff auf alle Ressourcen des Projekts (Datenbanken, Authentifizierung, Funktionen usw.). Eine Website enthält einen oder mehrere Channels. Jeder Channel ist mit einer URL verknüpft, über die bestimmte Inhalte und eine Hosting-Konfiguration bereitgestellt werden.

Firebase Hosting-Hierarchie" />

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

Die Inhalte und die Konfiguration, die von jedem Channel bereitgestellt werden, sind in einem version-Objekt mit einer eindeutigen Kennung enthalten. Wenn Sie die Bereitstellung auf Ihrer Website vornehmen, erstellt Firebase ein Release-Objekt, das auf eine bestimmte Version verweist. Eine Release enthält Metadaten zur Bereitstellung, z. B. wer und wann die Bereitstellung vorgenommen hat.

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

Kanaleinstellungen verwalten

Sie können die Einstellungen für jeden Channel Ihrer Website anpassen. Einige Einstellungen, z. B. der Ablauf von Channels, gelten nur für Vorschau-Channels.

Anzahl der zu behaltenden Releases begrenzen

Bei jeder Bereitstellung in einem Channel (und jedem Release) behält Hosting die Version bei, die mit dem vorherigen Release im Hosting-Speicher Ihres Projekts verknüpft ist. 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 frühere Releases bei?
  Wenn Sie frühere Releases für Ihren Live-Channel beibehalten, können Sie bei Bedarf ein Rollback auf eine frühere Version Ihrer Website durchführen. Für Ihre Vorschaukanäle ist das Zurücksetzen noch nicht verfügbar.

• Warum sollte die Anzahl der zu behaltenden Releases begrenzt werden?
  Mit dieser Funktion können Sie die Nutzung des Speichers Ihres Hosting-Projekts steuern, da die Inhalte für frühere Releases in diesem Speicher aufbewahrt werden. Sie können den Speicherplatz von Hosting auf dem Tab „Speicher“ in der Console überwachen.

• Was passiert, wenn Sie die Anzahl der zu behaltenden Releases begrenzen?
  Wenn Sie ein Limit für die Anzahl der Releases festlegen, die beibehalten werden sollen, werden die Inhalte aller Releases, die über Ihrem festgelegten Limit liegen, zum Löschen vorgesehen, beginnend mit den ältesten Releases.

So legen Sie das Speicherlimit für Releases für einen Channel fest:

1. Rufen Sie in der Firebase-Konsole das Dialogfeld für die Einstellung des Release-Speichers auf:

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

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

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

Ablauf eines Vorschaukanals festlegen

Ein Vorschaukanal läuft standardmäßig 7 Tage nach dem Erstellungsdatum ab. Der Live-Kanal Ihrer Website läuft jedoch nie ab.

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

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

• Firebase-Konsole
  Klicken Sie in der Zeile für den Vorschaukanal auf more_vert und wählen Sie dann Kanaleinstellungen aus. Geben Sie das Ablaufdatum und die Ablaufzeit ein.

• Firebase-Befehlszeile
  Wenn Sie die Bereitstellung auf Ihrem Vorschaukanal vornehmen, übergeben Sie das Flag --expires DURATION, z. B.:

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

  Das Ablaufdatum kann bis zu 30 Tage nach dem Bereitstellungsdatum liegen. Verwenden Sie h für Stunden, d für Tage und w für Wochen (z. B. 12h, 7d bzw. 2w).

Version von einem Channel in einen anderen klonen

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

Mit dem Klonbefehl wird auch bereitgestellt, sodass die geklonten Hosting-Inhalte und die Konfiguration automatisch über die zugehörige URL des Zielkanals bereitgestellt werden.

Diese Funktion ist nützlich, wenn Sie Versionen nachverfolgen oder sicher sein möchten, dass Sie genau den Inhalt bereitstellen, den Sie auf einem anderen Channel 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 den Live-Channel Ihrer Website in einen Vorschaukanal für das Debugging (z. B. vor einem Rollback).

• Aus einem Channel in Ihrem Firebase-„Staging“-Projekt in einen Vorschauchannel in Ihrem Firebase-„Produktions“-Projekt klonen

Führen Sie den folgenden Befehl in 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 Channels enthalten.

  • Verwenden Sie für Ihre Standardwebsite Hosting 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: Das sind die Kennungen für die Channels.

  • Verwende für einen Live-Kanal live als Kanal-ID.
  • Wenn der angegebene Zielchannel noch nicht vorhanden ist, wird er mit diesem Befehl erstellt, bevor die Bereitstellung erfolgt.

Rollback zu einer vorherigen Version Ihrer Website durchführen

Sie können ein Rollback durchführen, um eine frühere Version des Live-Channels Ihrer Website bereitzustellen. Diese Aktion ist nützlich, wenn es in Ihrer aktuellen Version ein Problem gibt und Sie zu einer bekannten funktionierenden Version Ihrer Website zurückkehren möchten. Vielleicht wurden auf Ihrer Website vorübergehend Inhalte für einen Feiertag oder ein besonderes Ereignis bereitgestellt, aber jetzt möchten Sie wieder Ihre „regulären“ Inhalte präsentieren.

Durch das Rollback wird ein neuer Release erstellt, der dieselbe Version von Inhalten wie ein vorheriger Release enthält. In der Tabelle Release-Verlauf wird für beide Releases dieselbe Versions-ID aufgeführt.

So führen Sie ein Rollback durch:

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

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

Release 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 vorherige Releases löschen, nicht den Release, der derzeit auf Ihrer Live-Website bereitgestellt wird.

Wenn Sie einen Release löschen, werden seine Inhalte gelöscht. Das Löschen wird innerhalb von 24 Stunden ausgeführt. Das Release-Objekt selbst wird beibehalten, damit Sie weiterhin seine Metadaten sehen können (wer und wann es bereitgestellt wurde).

So löschst du eine Veröffentlichung:

1. Fahren Sie in der Firebase-Konsole in der Tabelle Releaseverlauf für Ihre Website mit dem Mauszeiger auf den Eintrag des vorherigen Release, den Sie löschen möchten.

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

Dateien manuell löschen

In Firebase Hosting werden ausgewählte Dateien auf einer bereitgestellten Website in erster Linie gelöscht, indem Sie die Dateien lokal löschen und dann neu bereitstellen.

Vorschaukanal manuell löschen

Wenn Sie sich eine Vorschau Ihrer Channels ansehen möchten, klicken Sie auf den gewünschten Channel. In dieser Ansicht können Sie die neuesten Bereitstellungen und Releases, die mit dem jeweiligen Channel verknüpft sind, ansehen, löschen und rückgängig machen. Sie können einen Vorschaukanal löschen, aber nicht den Live-Kanal Ihrer Website.

Wenn Sie einen Vorschaukanal löschen, werden der Kanal sowie seine Releases und zugehörigen Versionen zum Löschen innerhalb von 24 Stunden 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 von einem Channel auf einen anderen innerhalb derselben Website klonen.

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

• Firebase-Konsole
  Klicken Sie in der Zeile für den Vorschauchannel auf more_vert 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

Befehlszeilenbefehle für Vorschaukanäle und das Klonen

Befehle für Vorschaukanäle

Alle Befehle für Preview-Channels unterstützen Bereitstellungsziele, wenn Sie mehrere Hosting-Websites haben.

Befehle zum Klonen von Versionen