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 kennen, können Sie die auf dieser Seite beschriebenen Verwaltungsoptionen besser nachvollziehen.

Jedes Firebase-Projekt hat eine standardmäßige Hosting Website mit Zugriff auf alle Ressourcen des Projekts (Datenbanken, Authentifizierung, Funktionen usw.). Eine Website enthält einen oder mehrere Kanäle. Jeder Kanal ist mit einer URL verknüpft, über die bestimmte Inhalte bereitgestellt werden, und einer Hosting-Konfiguration.

Firebase Hosting-Hierarchie“ />

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

Die Inhalte und die Konfiguration, die über jeden Kanal bereitgestellt werden, werden in einem Version-Objekt mit einer eindeutigen Kennung verpackt. Wenn Sie die App auf Ihrer Website bereitstellen, wird in Firebase ein Release-Objekt erstellt, das auf eine bestimmte Version verweist. Ein Release enthält Metadaten zur Bereitstellung, z. B. wer die Bereitstellung vorgenommen hat und wann.

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

Einstellungen eines Kanals verwalten

Sie können die Einstellungen für jeden Kanal Ihrer Website verwalten. Einige Einstellungen wie die Kanalaktivierungsdauer gelten nur für Vorschaukanäle.

Anzahl der zu behaltenden Releases begrenzen

Jedes Mal, wenn Sie eine Bereitstellung auf einem Kanal vornehmen und einen Release erstellen, speichert Hosting die Version, die dem vorherigen Release zugeordnet ist, im Hosting-Speicher Ihres Projekts. Sie können die Anzahl der Releases 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 vorherige Releases bei?
  Wenn Sie vorherige Releases für Ihren Live-Kanal aufbewahren, 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 möglich.

• Warum sollte die Anzahl der zu behaltenden Releases begrenzt werden?
  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 Ihren Hosting-Speicherplatz auf dem Tab Speicher in der Console überwachen.

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

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

1. Rufen Sie in der Firebase-Konsole das Dialogfeld für die Speichereinstellungen für die Release-Version auf:

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

   • Für einen 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.

Ablaufdatum für einen Vorschaukanal festlegen

Ein Vorschaukanal läuft standardmäßig sieben Tage nach dem Erstellungsdatum ab. Der Livekanal Ihrer Website läuft jedoch nie ab.

Wenn ein Vorabversionskanal 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 dieser Versionslöschung besteht, wenn eine Version mit einem anderen Release verknüpft ist. Das ist beispielsweise der Fall, wenn Sie eine Version innerhalb derselben Website von einem Kanal in einen anderen klonen.

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

• Firebase Console
   Klicke in der Zeile für den Vorschaukanal auf more_vert und wähle Kanaleinstellungen aus. Geben Sie das Ablaufdatum und die Ablaufzeit ein.

• Firebase Befehlszeile
  Wenn Sie die Bereitstellung auf Ihrem Vorschaukanal vornehmen, geben Sie das Flag --expires DURATION an, 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 und 2w).

  Hosting

Versionen von einem Kanal in einen anderen klonen

Sie können eine bereitgestellte Version von einem Kanal in einen anderen klonen. Du kannst zwischen Live- oder Vorschaukanälen, Hosting-Websites oder sogar Firebase-Projekten klonen.

Mit dem Befehl „clone“ wird der Inhalt auch auf dem Zielkanal bereitgestellt, sodass die geklonten Hosting-Inhalte und ‑Konfigurationen 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:

• Klonen Sie den Kanal aus der Vorschau mit den Fragen und Antworten in den Livekanal Ihrer Website.

• 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 in einem beliebigen Verzeichnis den folgenden Befehl 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 Standard-Hosting-Website 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 der Kanäle.

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

Rollback auf eine vorherige Version Ihrer Website durchführen

Sie können ein Rollback durchführen, um eine frühere Version des Live-Kanals Ihrer Website auszuliefern. Diese Aktion ist nützlich, wenn bei Ihrer aktuellen Version ein Problem auftritt und Sie zu einer bekannten funktionierenden Version Ihrer Website zurückkehren möchten. Vielleicht wurden auf Ihrer Website auch vorübergehende Inhalte für einen Feiertag oder ein besonderes Ereignis ausgeliefert, Sie möchten aber jetzt wieder Ihre „normalen“ Inhalte präsentieren.

Wenn Sie ein Rollback durchführen, erstellen Sie einen neuen Release, bei dem dieselben Inhalte wie bei einem vorherigen Release ausgeliefert werden. 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 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 more_vert und wählen Sie Rollback ausführen aus.

Release manuell löschen

Möglicherweise musst du eine Version manuell aus deinem Live-Kanal löschen, um Hosting Speicherplatz für dein Projekt freizugeben. Sie können nur vorherige Releases löschen, nicht den Release, der derzeit auf Ihrer Live-Website ausgeliefert wird.

Wenn Sie einen Release löschen, werden die zugehörigen Inhalte gelöscht, die innerhalb von 24 Stunden gelöscht werden. Das Release-Objekt selbst wird aufbewahrt, damit Sie die Metadaten (wer und wann es bereitgestellt wurde) weiterhin sehen können.

So löschst du eine Version:

1. Bewegen Sie in der Firebase Console den Mauszeiger in der Tabelle Release-Verlauf für Ihre Website auf den vorherigen Release-Eintrag, den Sie löschen möchten.

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

Dateien manuell löschen

In Firebase Hosting können ausgewählte Dateien von einer bereitgestellten Website hauptsächlich lokal gelöscht und dann neu bereitgestellt werden.

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 Releases aufrufen, löschen und rückgängig machen, die mit dem jeweiligen Channel verknüpft sind. Sie können einen Vorschaukanal löschen, den Livekanal Ihrer Website jedoch nicht.

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 innerhalb derselben Website von einem Kanal in einen anderen klonen.

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

• Firebase Console
  Klicken Sie in der Zeile für den Vorschaukanal auf more_vert und wählen Sie 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

Befehle für die Befehlszeile 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.

Befehle zum Klonen von Versionen