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-Befehlszeile, mit denen Sie die Channels, Releases und Versionen für Ihre Hosting-Website verwalten können.

Übersicht über die Hosting-Infrastruktur

Wenn Sie die Hosting-Infrastruktur verstehen, 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 bereitgestellt werden, sowie mit einer Hosting-Konfiguration.

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 „Vorschau“-Channels erstellen, die eigene Inhalte und Konfigurationen über temporäre, freigabefähige „Vorschau-URLs“ (SITE_ID--CHANNEL_ID-RANDOM_HASH.web.app) bereitstellen.

Der Inhalt 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 die Bereitstellung vorgenommen hat und wann.

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 Ansehen, um den Releaseverlauf aufzurufen. Wenn 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

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

• Warum behält Hosting frühere Releases bei?
  Wenn Sie für Ihren Live-Channel frühere Releases 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 ist die Anzahl der Releases, die beibehalten werden, begrenzt?
  Mit dieser Funktion können Sie die Nutzung des Speichers Hosting Ihres Projekts steuern, da die Inhalte für frühere Releases in diesem Speicher aufbewahrt werden. Sie können den Hosting-Speicherplatz in der Console auf dem Tab „Speicher“ überwachen.

• Was passiert, wenn Sie die Anzahl der zu behaltenden Releases begrenzen?
  Wenn Sie ein Limit für die Anzahl der aufzubewahrenden Releases festlegen, werden die Inhalte aller Releases, die dieses Limit überschreiten, beginnend mit den ältesten Releases zur Löschung geplant.

So legen Sie das Speicherlimit für die Release-Version eines Kanals fest:

1. Rufen Sie in der Firebase-Konsole Hosting & Serverless > Hosting auf, um auf das Dialogfeld für die Einstellung des Release-Speichers zuzugreifen:

   • 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 dann Kanaleinstellungen aus.

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

Ablaufdatum für einen Vorschaukanal festlegen

Standardmäßig läuft ein Vorschaukanal 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 innerhalb von 24 Stunden zum Löschen vorgemerkt. Die zugehörige Vorschau-URL wird ebenfalls deaktiviert. Eine Ausnahme von diesem 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 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 Vorschau-Channel auf more_vert und wählen Sie dann Channeleinstellungen aus. Geben Sie das Ablaufdatum und die Ablaufzeit ein.

• Firebase CLI
  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 Channel in 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 einige Beispiele:

• Klonen Sie von einem QA-Vorschaukanal auf den Live-Kanal Ihrer Website (Going Live!).

• Klonen Sie den Live-Channel Ihrer Website in einen Vorschau-Channel für das Debugging (z. B. vor einem Rollback).

• Aus einem Channel in Ihrem Firebase-„Staging“-Projekt in einen Vorschauchannel in Ihrem Firebase-„Prod“-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: Das 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.

  • Verwenden Sie für einen Live-Kanal live als Kanal-ID.
  • Wenn der angegebene Zielkanal noch nicht vorhanden ist, wird er durch diesen 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 Ihre aktuelle Version ein Problem aufweist 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 zu Ihren „regulären“ Inhalten zurückkehren.

Durch das Rollback wird eine Neuveröffentlichung erstellt, die 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 machen Sie ein Rollback:

1. Rufen Sie in der Firebase-Konsole Hosting & Serverless > Hosting auf.

2. Bewegen Sie den Mauszeiger in der Tabelle Releaseverlauf für Ihre Website auf den Eintrag des vorherigen Releases, zu dem Sie ein Rollback durchführen möchten.

3. Klicken Sie auf more_vert und wählen Sie Rollback durchführen 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 frühere Releases löschen, nicht den Release, der derzeit auf Ihrer Live-Website bereitgestellt wird.

Wenn Sie einen Release löschen, werden die Inhalte des Releases 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 es wann bereitgestellt hat).

So löschst du eine Veröffentlichung:

1. Rufen Sie in der Firebase-Konsole Hosting & Serverless > Hosting auf.

2. Bewegen Sie den Mauszeiger in der Tabelle Release-Verlauf für Ihre Website auf den Eintrag für die vorherige Version, den Sie löschen möchten.

3. 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.

Vorschaubereich manuell löschen

Sie können sich eine Vorschau Ihrer Channels ansehen, indem Sie auf den gewünschten Channel klicken. 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 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 von einem Channel auf einen anderen innerhalb derselben Website klonen.

Hosting bietet zwei Möglichkeiten, einen Vorschaukanal zu löschen:

• Firebase Console
  Klicke in der Zeile für den Vorschauchannel auf more_vert und wähle dann Channel löschen aus. 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

Befehlszeilenbefehle für Vorschaukanäle und das Klonen

Befehle für Vorschaukanäle

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

Befehle zum Klonen von Versionen