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
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 zu einer früheren Version Ihrer Website zurückkehren. 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:
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 und wähle Release-Speichereinstellungen aus.Für einen Vorschaukanal
Klicken Sie in der Zeile für den Vorschaukanal auf und wählen Sie Kanaleinstellungen aus.
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 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 DURATIONan, z. B.:firebase hosting:channel:deploy new-awesome-feature --expires 7d
Das Ablaufdatum kann bis zu 30 Tage nach dem Bereitstellungsdatum liegen. Verwenden Sie
Hostinghfür Stunden,dfür Tage undwfür Wochen (z. B.12h,7dund2w).
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
liveals Kanal-ID. - Wenn der angegebene Ziel-Channel noch nicht vorhanden ist, wird er mit diesem Befehl erstellt, bevor die Bereitstellung darauf erfolgt.
- Verwende für einen Livekanal
Rollback auf eine vorherige Version Ihrer Website durchführen
Sie können zu einer früheren Version des Live-Kanals Ihrer Website zurückkehren. 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 dieselbe Inhaltsversion wie bei einem vorherigen Release ausgeliefert wird. In der Tabelle Release-Verlauf wird für beide Releases dieselbe Versions-ID aufgeführt.
So führen Sie ein Rollback durch:
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.
Klicken Sie auf 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:
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.
Klicken Sie auf 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 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.
| Befehl | Beschreibung |
|---|---|
firebase hosting:channel:create CHANNEL_ID
|
Erstellt einen neuen Vorschaukanal auf der Standardwebsite Hosting mit der angegebenen Dieser Befehl führt keine Bereitstellung auf dem Kanal aus. |
firebase hosting:channel:delete CHANNEL_ID
|
Löscht den angegebenen Vorschaukanal. Der Livekanal einer Website kann nicht gelöscht werden. |
firebase hosting:channel:deploy CHANNEL_ID
|
Deine Hosting-Inhalte und -Konfiguration werden auf dem angegebenen Vorschaukanal bereitgestellt. Wenn der Vorschaukanal noch nicht vorhanden ist, wird er mit diesem Befehl auf der Standardwebsite von Hosting erstellt, bevor er auf dem Kanal bereitgestellt wird. |
firebase hosting:channel:list
|
Listet alle Kanäle (einschließlich des „Live“-Kanals) auf der Standardseite von Hosting auf. |
firebase hosting:channel:open CHANNEL_ID
|
Öffnet einen Browser mit der 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 \
|
Die zuletzt bereitgestellte Version auf dem angegebenen Quellkanal wird auf dem angegebenen Zielkanal geklont. Mit diesem Befehl wird die Bereitstellung auch auf dem angegebenen Zielkanal durchgeführt. Wenn der Kanal „target“ noch nicht vorhanden ist, wird mit diesem Befehl ein neuer Vorschaukanal auf der Hosting-Website „target“ erstellt, bevor die Bereitstellung auf dem Kanal erfolgt. |
firebase hosting:clone \
|
Die angegebene Version wird auf den angegebenen Zielkanal geklont. Mit diesem Befehl wird die Bereitstellung auch auf dem angegebenen „target“-Kanal durchgeführt. Wenn der Kanal „target“ noch nicht vorhanden ist, wird mit diesem Befehl ein neuer Vorschaukanal auf der Ziel-Hosting-Website erstellt, bevor die Bereitstellung auf dem Kanal erfolgt. Sie finden die |