Firebase CLI-Referenz

Die Firebase-Befehlszeile (GitHub) bietet eine Vielzahl von Tools zum Verwalten, Aufrufen und Bereitstellen von Firebase-Projekten.

Bevor Sie die Firebase-Befehlszeile verwenden, richten Sie ein Firebase-Projekt ein.

Befehlszeile einrichten oder aktualisieren

Firebase CLI installieren

Sie können die Firebase-Befehlszeile mit einer Methode installieren, die zu Ihrem Betriebssystem, Ihrem Kenntnisstand und/oder Ihrem Anwendungsfall passt. Unabhängig davon, wie Sie die CLI installieren, haben Sie Zugriff auf dieselben Funktionen und den Befehl firebase.

Windows macOS Linux

Windows

Sie können die Firebase-Befehlszeile für Windows mit einer der folgenden Optionen installieren:

Option Beschreibung Empfohlen für...
eigenständige Binärdatei Laden Sie die eigenständige Binärdatei für die Befehlszeile herunter. Anschließend können Sie auf die ausführbare Datei zugreifen, um eine Shell zu öffnen, in der Sie den Befehl firebase ausführen können. Neue Entwickler

Entwickler, die Node.js nicht verwenden oder damit nicht vertraut sind
npm Verwenden Sie npm (den Node Package Manager), um die CLI zu installieren und den global verfügbaren Befehl firebase zu aktivieren. Entwickler, die Node.js verwenden

Eigenständige Binärdatei

So laden Sie das Binärprogramm für die Firebase CLI herunter und führen es aus:

  1. Laden Sie die Firebase-CLI-Binärdatei für Windows herunter.

  2. Greifen Sie auf die Binärdatei zu, um eine Shell zu öffnen, in der Sie den Befehl firebase ausführen können.

  3. Melden Sie sich an und testen Sie die CLI.

npm

So installieren Sie die Firebase-CLI mit npm (dem Node Package Manager):

  1. Installieren Sie Node.js mit nvm-windows (dem Node Version Manager). Bei der Installation von Node.js werden die npm-Befehlszeilentools automatisch installiert.

  2. Installieren Sie die Firebase-Befehlszeile über npm mit dem folgenden Befehl:

    npm install -g firebase-tools

    Mit diesem Befehl wird der weltweit verfügbare Befehl firebase aktiviert.

  3. Melden Sie sich an und testen Sie die CLI.

macOS oder Linux

Sie können die Firebase CLI für macOS oder Linux mit einer der folgenden Optionen installieren:

Option Beschreibung Empfohlen für...
automatisches Installationsskript Führen Sie einen einzelnen Befehl aus, der Ihr Betriebssystem automatisch erkennt, die neueste CLI-Version herunterlädt und dann den global verfügbaren firebase-Befehl aktiviert. Neue Entwickler

Entwickler, die Node.js nicht verwenden oder damit nicht vertraut sind

Automatisierte Bereitstellungen in einer CI/CD-Umgebung
eigenständige Binärdatei Laden Sie die eigenständige Binärdatei für die Befehlszeile herunter. Anschließend können Sie das Binärprogramm konfigurieren und ausführen, um es an Ihren Workflow anzupassen. Vollständig anpassbare Workflows über die CLI
npm Verwenden Sie npm (den Node Package Manager), um die CLI zu installieren und den global verfügbaren Befehl firebase zu aktivieren. Entwickler, die Node.js verwenden

Skript für die automatische Installation

So installieren Sie die Firebase CLI mit dem automatischen Installationsskript:

  1. Führen Sie den folgenden cURL-Befehl aus:

    curl -sL https://firebase.tools | bash

    Dieses Skript erkennt automatisch Ihr Betriebssystem, lädt die aktuelle Firebase-Befehlszeilenversion herunter und aktiviert dann den global verfügbaren firebase-Befehl.

  2. Melden Sie sich an und testen Sie die CLI.

Weitere Beispiele und Details zum automatischen Installationsskript finden Sie im Quellcode des Skripts unter firebase.tools.

Eigenständige Binärdatei

So laden Sie die Binärdatei für die Firebase CLI herunter und führen sie aus, die speziell für Ihr Betriebssystem entwickelt wurde:

  1. Laden Sie die Firebase-CLI-Binärdatei für Ihr Betriebssystem herunter: macOS | Linux

  2. (Optional) Richten Sie den global verfügbaren firebase-Befehl ein.

    1. Machen Sie die Binärdatei mit dem Befehl chmod +x ./firebase_tools ausführbar.
    2. Fügen Sie den Pfad der Binärdatei zu Ihrer PATH-Umgebungsvariablen hinzu.
  3. Melden Sie sich an und testen Sie die CLI.

npm

So installieren Sie die Firebase CLI mit npm (dem Node Package Manager):

  1. Installieren Sie Node.js mit nvm (dem Node Version Manager).
    Bei der Installation von Node.js werden die npm-Befehlszeilentools automatisch installiert.

  2. Installieren Sie die Firebase-Befehlszeile über npm mit dem folgenden Befehl:

    npm install -g firebase-tools

    Mit diesem Befehl wird der weltweit verfügbare Befehl firebase aktiviert.

  3. Melden Sie sich an und testen Sie die CLI.

Anmelden und Firebase-CLI testen

Nach der Installation der CLI müssen Sie sich authentifizieren. Anschließend können Sie die Authentifizierung bestätigen, indem Sie Ihre Firebase-Projekte auflisten.

  1. Melden Sie sich mit folgendem Befehl mit Ihrem Google-Konto in Firebase an:

    firebase login

    Mit diesem Befehl wird Ihr lokaler Computer mit Firebase verbunden und Sie erhalten Zugriff auf Ihre Firebase-Projekte.

  2. Prüfen Sie, ob die CLI richtig installiert ist und auf Ihr Konto zugreift, indem Sie Ihre Firebase-Projekte auflisten. Führen Sie dazu diesen Befehl aus:

    firebase projects:list

    Die angezeigte Liste sollte mit den Firebase-Projekten übereinstimmen, die in der Firebase Console aufgeführt sind.

Auf die neueste CLI-Version aktualisieren

Im Allgemeinen sollten Sie die aktuelle Version der Firebase-CLI verwenden.

Wie Sie die CLI-Version aktualisieren, hängt von Ihrem Betriebssystem und der Art der Installation der CLI ab.

Windows

macOS

  • Automatisches Installationsskript: Führen Sie curl -sL https://firebase.tools | upgrade=true bash aus.

  • Eigenständige Binärdatei: Laden Sie die neue Version herunter und ersetzen Sie sie dann auf Ihrem System.

  • npm: npm install -g firebase-tools ausführen

Linux

  • Automatisches Installationsskript: Führen Sie curl -sL https://firebase.tools | upgrade=true bash aus.

  • Eigenständige Binärdatei: Laden Sie die neue Version herunter und ersetzen Sie sie dann auf Ihrem System.

  • npm: npm install -g firebase-tools ausführen

Befehlszeile mit CI-Systemen verwenden

Wir empfehlen, sich mit Standardanmeldedaten für Anwendungen zu authentifizieren, wenn Sie die CLI mit CI-Systemen verwenden.

(Empfohlen) Standardanmeldedaten für Anwendungen verwenden

Die Firebase-Befehlszeile erkennt und verwendet Standardanmeldedaten für Anwendungen, sofern sie festgelegt sind. Die einfachste Möglichkeit, die CLI in CI- und anderen Headless-Umgebungen zu authentifizieren, ist das Einrichten von Standardanmeldedaten für Anwendungen.

(Legacy) Verwenden Sie FIREBASE_TOKEN

Alternativ können Sie sich mit FIREBASE_TOKEN authentifizieren. Diese Methode ist weniger sicher als Standardanmeldedaten für Anwendungen und wird nicht mehr empfohlen.

  1. Installieren Sie die Firebase CLI auf einem Computer mit einem Browser.

  2. Starten Sie den Anmeldevorgang mit dem folgenden Befehl:

    firebase login:ci
  3. Rufen Sie die angegebene URL auf und melden Sie sich mit einem Google-Konto an.

  4. Drucken Sie ein neues Aktualisierungstoken. Die aktuelle CLI-Sitzung ist davon nicht betroffen.

  5. Speichern Sie das Ausgabetoken auf sichere, aber zugängliche Weise in Ihrem CI-System.

  6. Verwenden Sie dieses Token, wenn Sie firebase-Befehle ausführen. Sie haben dazu zwei Möglichkeiten:

    • Option 1:Speichern Sie das Token als Umgebungsvariable FIREBASE_TOKEN. Ihr System verwendet das Token automatisch.

    • Option 2:Führen Sie alle firebase-Befehle mit dem Flag --token TOKEN in Ihrem CI-System aus.
      Dies ist die Prioritätsreihenfolge für das Laden von Tokens: Flag, Umgebungsvariable, gewünschtes Firebase-Projekt.

Firebase-Projekt initialisieren

Für viele gängige Aufgaben, die mit der CLI ausgeführt werden, z. B. die Bereitstellung in einem Firebase-Projekt, ist ein Projektverzeichnis erforderlich. Sie erstellen ein Projektverzeichnis mit dem Befehl firebase init. Ein Projektverzeichnis ist in der Regel dasselbe Verzeichnis wie Ihr Quellcodeverwaltungsstammverzeichnis. Nach dem Ausführen von firebase init enthält das Verzeichnis eine firebase.json-Konfigurationsdatei.

Führen Sie zum Initialisieren eines neuen Firebase-Projekts den folgenden Befehl im Verzeichnis Ihrer App aus:

firebase init

Mit dem Befehl firebase init werden Sie durch die Einrichtung des Projektverzeichnisses und einiger Firebase-Produkte geführt. Während der Projektinitialisierung werden Sie von der Firebase-Befehlszeile aufgefordert, die folgenden Aufgaben auszuführen:

  • Wählen Sie ein Standard-Firebase-Projekt aus.

    In diesem Schritt wird das aktuelle Projektverzeichnis mit einem Firebase-Projekt verknüpft, sodass projektspezifische Befehle (z. B. firebase deploy) für das entsprechende Firebase-Projekt ausgeführt werden.

    Es ist auch möglich, mehrere Firebase-Projekte (z. B. ein Staging-Projekt und ein Produktionsprojekt) mit demselben Projektverzeichnis zu verknüpfen.

  • Wählen Sie die gewünschten Firebase-Produkte aus, die Sie in Ihrem Firebase-Projekt einrichten möchten.

    In diesem Schritt werden Sie aufgefordert, Konfigurationen für bestimmte Dateien für die ausgewählten Produkte festzulegen. Weitere Informationen zu diesen Konfigurationen finden Sie in der Dokumentation des jeweiligen Produkts (z. B. Hosting). Sie können firebase init jederzeit später ausführen, um weitere Firebase-Produkte einzurichten.

Am Ende der Initialisierung erstellt Firebase automatisch die folgenden beiden Dateien im Stammverzeichnis Ihrer lokalen App:

  • Eine firebase.json-Konfigurationsdatei, in der Ihre Projektkonfiguration aufgeführt ist.

  • Eine .firebaserc-Datei, in der die Aliasse Ihres Projekts gespeichert sind.

Datei firebase.json

Mit dem Befehl firebase init wird eine firebase.json-Konfigurationsdatei im Stammverzeichnis Ihres Projektverzeichnisses erstellt.

Die Datei firebase.json ist erforderlich, um Assets mit der Firebase-CLI bereitzustellen, da sie angibt, welche Dateien und Einstellungen aus Ihrem Projektverzeichnis in Ihrem Firebase-Projekt bereitgestellt werden. Da einige Einstellungen entweder in Ihrem Projektverzeichnis oder in der Firebase-Konsole definiert werden können, müssen Sie alle potenziellen Bereitstellungskonflikte beheben.

Die meisten Firebase Hosting-Optionen können Sie direkt in der Datei firebase.json konfigurieren. Für andere Firebase-Dienste, die mit der Firebase-CLI bereitgestellt werden können, werden mit dem Befehl firebase init jedoch bestimmte Dateien erstellt, in denen Sie Einstellungen für diese Dienste definieren können, z. B. eine index.js-Datei für Cloud Functions. Sie können auch Hooks für die Vor- oder Nachbereitstellung in der Datei firebase.json einrichten.

Das Folgende ist ein Beispiel für eine firebase.json-Datei mit Standardeinstellungen, wenn Sie bei der Initialisierung Firebase Hosting, Cloud Firestore und Cloud Functions for Firebase auswählen (mit ausgewählten TypeScript-Quell- und Lint-Optionen).

{
  "hosting": {
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ]
  },
  "firestore": {
      "rules": "firestore.rules",
      "indexes": "firestore.indexes.json"
  },
  "functions": {
    "predeploy": [
      "npm --prefix \"$RESOURCE_DIR\" run lint",
      "npm --prefix \"$RESOURCE_DIR\" run build"
    ]
  }
}

firebase.json wird standardmäßig verwendet. Sie können jedoch das Flag --config PATH übergeben, um eine alternative Konfigurationsdatei anzugeben.

Konfiguration für mehrere Cloud Firestore-Datenbanken

Wenn Sie firebase init ausführen, enthält Ihre firebase.json-Datei einen einzelnen firestore-Schlüssel, der der Standarddatenbank Ihres Projekts entspricht, wie oben gezeigt.

Wenn Ihr Projekt mehrere Cloud Firestore-Datenbanken enthält, bearbeiten Sie die Datei firebase.json, um jeder Datenbank verschiedene Cloud Firestore Security Rules- und Datenbankindex-Quelldateien zuzuweisen. Ändern Sie die Datei mit einem JSON-Array mit einem Eintrag für jede Datenbank.

      "firestore": [
        {
          "database": "(default)",
          "rules": "firestore.default.rules",
          "indexes": "firestore.default.indexes.json"
        },
        {
          "database": "ecommerce",
          "rules": "firestore.ecommerce.rules",
          "indexes": "firestore.ecommerce.indexes.json"
        }
      ],

Cloud Functions-Dateien, die bei der Bereitstellung ignoriert werden sollen

Bei der Bereitstellung der Funktion gibt die CLI automatisch eine Liste von Dateien im Verzeichnis functions an, die ignoriert werden sollen. So wird verhindert, dass unnötige Dateien im Backend bereitgestellt werden, die die Datengröße Ihrer Bereitstellung erhöhen könnten.

Die Liste der Dateien, die standardmäßig ignoriert werden, wird im JSON-Format angezeigt:

"ignore": [
  ".git",
  ".runtimeconfig.json",
  "firebase-debug.log",
  "firebase-debug.*.log",
  "node_modules"
]

Wenn Sie in firebase.json eigene benutzerdefinierte Werte für ignore hinzufügen, achten Sie darauf, dass Sie die oben gezeigte Liste der Dateien beibehalten (oder hinzufügen, falls sie fehlt).

Projektaliasse verwalten

Sie können mehrere Firebase-Projekte mit demselben Projektverzeichnis verknüpfen. Sie können beispielsweise ein Firebase-Projekt für das Staging und ein anderes für die Produktion verwenden. Wenn Sie verschiedene Projektumgebungen verwenden, können Sie Änderungen überprüfen, bevor Sie sie in der Produktion bereitstellen. Mit dem Befehl firebase use können Sie zwischen Aliasen wechseln und neue Aliase erstellen.

Projektalias hinzufügen

Wenn Sie bei der Projektinitialisierung ein Firebase-Projekt auswählen, wird dem Projekt automatisch der Alias default zugewiesen. Wenn Sie jedoch zulassen möchten, dass projektspezifische Befehle für ein anderes Firebase-Projekt ausgeführt werden, aber weiterhin das selbe Projektverzeichnis verwendet wird, führen Sie den folgenden Befehl im Projektverzeichnis aus:

firebase use --add

Mit diesem Befehl werden Sie aufgefordert, ein anderes Firebase-Projekt auszuwählen und dem Projekt einen Alias zuzuweisen. Aliaszuweisungen werden in eine .firebaserc-Datei in Ihrem Projektverzeichnis geschrieben.

Projektaliasse verwenden

Wenn Sie zugewiesene Firebase-Projektaliase verwenden möchten, führen Sie einen der folgenden Befehle im Projektverzeichnis aus.

Befehl Beschreibung
firebase use Liste der derzeit definierten Aliase für Ihr Projektverzeichnis ansehen
firebase use \
PROJECT_ID|ALIAS
Alle Befehle werden für das angegebene Firebase-Projekt ausgeführt.
Die CLI verwendet dieses Projekt als das derzeit „aktive Projekt“.
firebase use --clear Löscht das aktive Projekt.

Führen Sie firebase use PROJECT_ID|ALIAS aus, um ein neues aktives Projekt festzulegen, bevor Sie andere CLI-Befehle ausführen.

firebase use \
--unalias PROJECT_ALIAS
Entfernt einen Alias aus Ihrem Projektverzeichnis.

Sie können das aktuell aktive Projekt überschreiben, indem Sie das Flag --project mit einem beliebigen CLI-Befehl übergeben. Beispiel: Sie können die CLI so einrichten, dass sie für ein Firebase-Projekt ausgeführt wird, dem Sie den Alias staging zugewiesen haben. Wenn Sie einen einzelnen Befehl für das Firebase-Projekt ausführen möchten, dem Sie den Alias prod zugewiesen haben, können Sie beispielsweise firebase deploy --project=prod ausführen.

Quellcodeverwaltung und Projektaliase

Im Allgemeinen sollten Sie Ihre .firebaserc-Datei in die Versionsverwaltung einchecken, damit Ihr Team Projektaliase freigeben kann. Bei Open-Source-Projekten oder Startvorlagen sollten Sie die Datei .firebaserc jedoch in der Regel nicht einchecken.

Wenn Sie ein Entwicklungsprojekt haben, das nur für Sie bestimmt ist, können Sie entweder das Flag --project mit jedem Befehl übergeben oder firebase use PROJECT_ID ausführen, ohne dem Firebase-Projekt einen Alias zuzuweisen.

Firebase-Projekt lokal bereitstellen und testen

Sie können Ihr Firebase-Projekt auf lokal gehosteten URLs ansehen und testen, bevor Sie es in der Produktion bereitstellen. Wenn Sie nur bestimmte Funktionen testen möchten, können Sie eine durch Kommas getrennte Liste in einem Flag für den Befehl firebase serve verwenden.

Führen Sie den folgenden Befehl im Stammverzeichnis Ihres lokalen Projektverzeichnisses aus, wenn Sie eine der folgenden Aufgaben ausführen möchten:

  • Statische Inhalte für Ihre auf Firebase gehostete App ansehen
  • Sie verwenden Cloud Functions, um dynamische Inhalte für Firebase Hosting zu generieren, und möchten Ihre Produktions-HTTP-Funktionen (bereitgestellt) verwenden, um Hosting auf einer lokalen URL zu emulieren.
firebase serve --only hosting

Projekt mit lokalen HTTP-Funktionen emulieren

Führen Sie einen der folgenden Befehle in Ihrem Projektverzeichnis aus, um Ihr Projekt mit lokalen HTTP-Funktionen zu emulieren.

  • Verwenden Sie einen der folgenden Befehle, um HTTP-Funktionen und Hosting für Tests auf lokalen URLs zu emulieren:

    firebase serve
    firebase serve --only functions,hosting // uses a flag
  • Verwenden Sie den folgenden Befehl, um nur HTTP-Funktionen zu emulieren:

    firebase serve --only functions

Von anderen lokalen Geräten testen

Standardmäßig antwortet firebase serve nur auf Anfragen von localhost. Das bedeutet, dass Sie über den Webbrowser Ihres Computers auf Ihre gehosteten Inhalte zugreifen können, nicht aber über andere Geräte in Ihrem Netzwerk. Wenn Sie auf anderen lokalen Geräten testen möchten, verwenden Sie das Flag --host:

firebase serve --host 0.0.0.0  // accepts requests to any host

In einem Firebase-Projekt bereitstellen

Mit der Firebase-CLI können Sie die Bereitstellung von Code und Assets in Ihrem Firebase-Projekt verwalten, einschließlich:

  • Neuerscheinungen auf Ihren Firebase Hosting-Websites
  • Neue, aktualisierte oder vorhandene Cloud Functions for Firebase
  • Neue oder aktualisierte Schemas und Connectors für Firebase Data Connect
  • Regeln für Firebase Realtime Database
  • Regeln für Cloud Storage for Firebase
  • Regeln für Cloud Firestore
  • Indexe für Cloud Firestore

Führen Sie zum Bereitstellen in einem Firebase-Projekt den folgenden Befehl aus dem Projektverzeichnis aus:

firebase deploy

Sie können optional jeder Bereitstellung einen Kommentar hinzufügen. Dieser Kommentar wird zusammen mit den anderen Bereitstellungsinformationen auf der Firebase Hosting-Seite Ihres Projekts angezeigt. Beispiel:

firebase deploy -m "Deploying the best new feature ever."

Beachten Sie Folgendes, wenn Sie den firebase deploy-Befehl verwenden:

  • Wenn Sie Ressourcen aus einem Projektverzeichnis bereitstellen möchten, muss das Projektverzeichnis eine firebase.json-Datei enthalten. Diese Datei wird automatisch vom Befehl firebase init erstellt.

  • Standardmäßig erstellt firebase deploy eine Release für alle bereitstellbaren Ressourcen in Ihrem Projektverzeichnis. Wenn Sie bestimmte Firebase-Dienste oder ‑Funktionen bereitstellen möchten, verwenden Sie die teilweise Bereitstellung.

Bereitstellungskonflikte für Sicherheitsregeln

Für Firebase Realtime Database, Cloud Storage for Firebase und Cloud Firestore können Sie Sicherheitsregeln entweder in Ihrem lokalen Projektverzeichnis oder in der Firebase-Konsole definieren.

Eine weitere Möglichkeit, Bereitstellungskonflikte zu vermeiden, ist die Verwendung der teilweisen Bereitstellung und die Definition von Regeln nur in der Firebase-Konsole.

Bereitstellungskontingente

Es ist möglich (wenn auch unwahrscheinlich), dass Sie ein Kontingent überschreiten, das die Rate oder das Volumen Ihrer Firebase-Bereitstellungsvorgänge begrenzt. Wenn Sie beispielsweise eine sehr große Anzahl von Funktionen bereitstellen, erhalten Sie möglicherweise eine Fehlermeldung HTTP 429 Quota. Um solche Probleme zu beheben, können Sie die teilweise Bereitstellung verwenden.

Deployment rückgängig machen

Sie können ein Firebase Hosting-Deployment über die Seite Firebase Hosting Ihres Projekts rückgängig machen, indem Sie für das gewünschte Release die Aktion Rollback auswählen.

Derzeit ist es nicht möglich, Releases von Sicherheitsregeln für Firebase Realtime Database, Cloud Storage for Firebase oder Cloud Firestore zurückzusetzen.

Bestimmte Firebase-Dienste bereitstellen

Wenn Sie nur bestimmte Firebase-Dienste oder ‑Funktionen bereitstellen möchten, können Sie eine kommagetrennte Liste in einem Flag für den firebase deploy-Befehl verwenden. Mit dem folgenden Befehl werden beispielsweise Firebase Hosting-Inhalte und Cloud Storage-Sicherheitsregeln bereitgestellt.

firebase deploy --only hosting,storage

In der folgenden Tabelle sind die Dienste und Funktionen aufgeführt, die für die teilweise Bereitstellung verfügbar sind. Die Namen in den Flags entsprechen den Schlüsseln in Ihrer Konfigurationsdatei firebase.json.

Syntax für Flags Dienst oder Funktion bereitgestellt
--only hosting Inhalt auf Firebase Hosting
--only database Firebase Realtime Database Regeln
--only dataconnect Firebase Data Connect Schemas und Connectors
--only storage Cloud Storage for Firebase Regeln
--only firestore Cloud Firestore-Regeln und Indexe für alle konfigurierten Datenbanken
--only functions Cloud Functions for Firebase (genauere Versionen dieses Flags sind möglich)

Bestimmte Funktionen bereitstellen

Beim Bereitstellen von Funktionen können Sie bestimmte Funktionen als Ziel festlegen. Beispiel:

firebase deploy --only functions:function1
firebase deploy --only functions:function1,functions:function2

Eine weitere Option besteht darin, Funktionen in Ihrem /functions/index.js-Dokument in Exportgruppen zu gruppieren. Durch das Gruppieren von Funktionen können Sie mehrere Funktionen mit einem einzigen Befehl bereitstellen.

Sie können beispielsweise die folgenden Funktionen schreiben, um eine groupA und eine groupB zu definieren:

var functions = require('firebase-functions/v1');

exports.groupA = {
  function1: functions.https.onRequest(...),
  function2: functions.database.ref('\path').onWrite(...)
}
exports.groupB = require('./groupB');

In diesem Beispiel enthält eine separate Datei functions/groupB.js zusätzliche Funktionen, die die Funktionen in groupB definieren. Beispiel:

var functions = require('firebase-functions/v1');

exports.function3 = functions.storage.object().onChange(...);
exports.function4 = functions.analytics.event('in_app_purchase').onLog(...);

In diesem Beispiel können Sie alle groupA-Funktionen bereitstellen, indem Sie den folgenden Befehl in Ihrem Projektverzeichnis ausführen:

firebase deploy --only functions:groupA

Alternativ können Sie mit dem folgenden Befehl eine bestimmte Funktion in einer Gruppe ansprechen:

firebase deploy --only functions:groupA.function1,groupB.function4

Funktionen löschen

Die Firebase-CLI unterstützt die folgenden Befehle und Optionen zum Löschen zuvor bereitgestellter Funktionen:

  • Löscht alle Funktionen, die dem angegebenen Namen in allen Regionen entsprechen:

    firebase functions:delete FUNCTION-1_NAME

  • Löscht eine angegebene Funktion, die in einer nicht standardmäßigen Region ausgeführt wird:

    firebase functions:delete FUNCTION-1_NAME --region REGION_NAME

  • Mehr als eine Funktion löschen:

    firebase functions:delete FUNCTION-1_NAME FUNCTION-2_NAME

  • Löscht eine angegebene Funktionsgruppe:

    firebase functions:delete GROUP_NAME

  • Die Bestätigungsaufforderung wird umgangen:

    firebase functions:delete FUNCTION-1_NAME --force

Scripted Tasks vor und nach der Bereitstellung einrichten

Sie können Shell-Skripts mit dem Befehl firebase deploy verbinden, um Aufgaben vor oder nach der Bereitstellung auszuführen. Ein Pre-Deploy-Skript könnte beispielsweise TypeScript-Code in JavaScript transpilieren und ein Post-Deploy-Hook könnte Administratoren über neue Bereitstellungen von Websiteinhalten für Firebase Hosting benachrichtigen.

Wenn Sie Pre-Deploy- oder Post-Deploy-Hooks einrichten möchten, fügen Sie Ihrer Konfigurationsdatei firebase.json Bash-Skripts hinzu. Sie können kurze Skripts direkt in der Datei firebase.json definieren oder auf andere Dateien in Ihrem Projektverzeichnis verweisen.

Das folgende Skript ist beispielsweise der firebase.json-Ausdruck für eine Post-Deployment-Aufgabe, die bei erfolgreichem Deployment eine Slack-Nachricht an Firebase Hosting sendet.

"hosting": {
  // ...

  "postdeploy": "./messageSlack.sh 'Just deployed to Firebase Hosting'",
  "public": "public"
}

Die Skriptdatei messageSlack.sh befindet sich im Projektverzeichnis und sieht so aus:

curl -X POST -H 'Content-type: application/json' --data '{"text":"$1"}'
     \https://SLACK_WEBHOOK_URL

Sie können predeploy- und postdeploy-Hooks für alle bereitstellbaren Assets einrichten. Wenn Sie firebase deploy ausführen, werden alle Pre-Deploy- und Post-Deploy-Aufgaben ausgelöst, die in Ihrer firebase.json-Datei definiert sind. Wenn Sie nur die Aufgaben ausführen möchten, die mit einem bestimmten Firebase-Dienst verknüpft sind, verwenden Sie Befehle für das partielle Deployment.

Sowohl predeploy- als auch postdeploy-Hooks geben die Standardausgabe- und Fehlerstreams der Skripts im Terminal aus. Beachten Sie bei Fehlerfällen Folgendes:

  • Wenn ein Pre-Deploy-Hook nicht wie erwartet abgeschlossen wird, wird die Bereitstellung abgebrochen.
  • Wenn die Bereitstellung aus irgendeinem Grund fehlschlägt, werden die Post-Deploy-Hooks nicht ausgelöst.

Umgebungsvariablen

In Skripts, die in den Pre-Deploy- und Post-Deploy-Hooks ausgeführt werden, sind die folgenden Umgebungsvariablen verfügbar:

  • $GCLOUD_PROJECT: Die Projekt-ID des aktiven Projekts.
  • $PROJECT_DIR: Das Stammverzeichnis, das die Datei firebase.json enthält
  • $RESOURCE_DIR: (Nur für hosting- und functions-Scripts) Der Speicherort des Verzeichnisses, das die bereitzustellenden Hosting- oder Cloud Functions-Ressourcen enthält.

Mehrere Realtime Database-Instanzen verwalten

Ein Firebase-Projekt kann mehrere Firebase Realtime Database-Instanzen haben. Standardmäßig interagieren CLI-Befehle mit Ihrer Standard-Datenbankinstanz.

Sie können jedoch mit einer nicht standardmäßigen Datenbankinstanz interagieren, indem Sie das Flag --instance DATABASE_NAME verwenden. Die folgenden Befehle unterstützen das Flag --instance:

  • firebase database:get
  • firebase database:profile
  • firebase database:push
  • firebase database:remove
  • firebase database:set
  • firebase database:update

Befehlsreferenz

Administrative Befehle für die Befehlszeile

Befehl Beschreibung
help Zeigt Hilfeinformationen zur CLI oder zu bestimmten Befehlen an.
init Verknüpft und richtet ein neues Firebase-Projekt im aktuellen Verzeichnis ein. Mit diesem Befehl wird im aktuellen Verzeichnis eine Konfigurationsdatei firebase.json erstellt.
login Authentifiziert die CLI mit Ihrem Google-Konto. Erfordert den Zugriff auf einen Webbrowser.
Verwenden Sie das Flag --no-localhost, um sich in der CLI in Remoteumgebungen anzumelden, die keinen Zugriff auf localhost zulassen.
login:ci Generiert ein Authentifizierungstoken für die Verwendung in nicht interaktiven Umgebungen.
logout Meldet Ihr Google-Konto über die CLI ab.
offen Öffnet einen Browser mit relevanten Projektressourcen.
projects:list Listet alle Firebase-Projekte auf, auf die Sie Zugriff haben.
Verwendung Legt das aktive Firebase-Projekt für die CLI fest.
Verwaltet Projektaliasse.

Befehle für das Projektmanagement

Befehl Beschreibung
Firebase-Projekte verwalten
projects:addfirebase Fügt einem vorhandenen Google Cloud-Projekt Firebase-Ressourcen hinzu.
projects:create Erstellt ein neues Google Cloud-Projekt und fügt dem neuen Projekt dann Firebase-Ressourcen hinzu.
projects:list Listet alle Firebase-Projekte auf, auf die Sie Zugriff haben.
Firebase-Apps verwalten (iOS, Android, Web)
apps:create Erstellt eine neue Firebase-App im aktiven Projekt.
apps:list Listet die registrierten Firebase-Apps im aktiven Projekt auf.
apps:sdkconfig Gibt die Konfiguration der Google-Dienste einer Firebase-App aus.
setup:web Eingestellt. Verwenden Sie stattdessen apps:sdkconfig und geben Sie web als Plattformargument an.
Gibt die Konfiguration der Google-Dienste einer Firebase-Web-App aus.
Verwaltung von SHA-Zertifikats-Hashes (nur Android)
apps:android:sha:create \
FIREBASE_APP_ID SHA_HASH
Fügt den angegebenen SHA-Zertifikathash zur angegebenen Firebase-Android-App hinzu.
apps:android:sha:delete \
FIREBASE_APP_ID SHA_HASH
Löscht den angegebenen SHA-Zertifikathash aus der angegebenen Firebase-Android-App.
apps:android:sha:list \
FIREBASE_APP_ID
Listet die SHA-Zertifikathashes für die angegebene Firebase-Android-App auf.

Bereitstellung und lokale Entwicklung

Mit diesen Befehlen können Sie Ihre Firebase Hosting-Website bereitstellen und mit ihr interagieren.

Befehl Beschreibung
bereitstellen Stellt Code und Assets aus Ihrem Projektverzeichnis im aktiven Projekt bereit. Für Firebase Hosting ist eine Konfigurationsdatei firebase.json erforderlich.
bereitstellen Startet einen lokalen Webserver mit Ihrer Firebase Hosting-Konfiguration. Für Firebase Hosting ist eine Konfigurationsdatei firebase.json erforderlich.

App Distribution-Befehle

Befehl Beschreibung
appdistribution:distribute \
--app FIREBASE_APP_ID
Der Build wird für Tester verfügbar gemacht.
appdistribution:testers:add Fügt dem Projekt Tester hinzu.
appdistribution:testers:remove Entfernt Tester aus dem Projekt.

App Hosting-Befehle

Befehl Beschreibung
apphosting:backends:create \
--project PROJECT_ID \
--location REGION --app APP_ID
Erstellt die Sammlung verwalteter Ressourcen, die mit einer einzelnen Codebasis verknüpft sind, aus der ein App Hosting-Backend besteht. Optional können Sie eine vorhandene Firebase Web-App anhand ihrer Firebase-App-ID angeben.
apphosting:backends:get \
BACKEND_ID \
--project PROJECT_ID \
--location REGION
Ruft bestimmte Details, einschließlich der öffentlichen URL, eines Back-Ends ab.
apphosting:backends:list \
--project PROJECT_ID
Ruft eine Liste aller aktiven Back-Ends ab, die einem Projekt zugeordnet sind.
firebase apphosting:backends:delete \
BACKEND_ID \
--project PROJECT_ID \
--location REGION
Löscht ein Back-End aus dem Projekt.
firebase apphosting:config:export \
--project PROJECT_ID \
--secrets ENVIRONMENT_NAME
Exportiert Secrets zur Verwendung in der App-Emulation.
Standardmäßig werden Secrets verwendet, die in apphosting.yaml gespeichert sind. Alternativ kann --secrets verwendet werden, um eine Umgebung anzugeben, für die eine entsprechende apphosting.ENVIRONMENT_NAME.yaml-Datei vorhanden ist.
firebase apphosting:rollouts:create \
BACKEND_ID \
--git_branch BRANCH_NAME \
--git_commit COMMIT_ID
Erstellt einen manuell ausgelösten Roll-out.
Optional können Sie den letzten Commit für einen Branch oder einen bestimmten Commit angeben. Wenn keine Optionen angegeben sind, wird eine Liste mit Zweigen zur Auswahl angezeigt.
apphosting:secrets:set KEY --project PROJECT_ID \
--location REGION \
--data-file DATA_FILE_PATH
Speichert geheime Informationen in Secret Manager.
Optional: Geben Sie einen Dateipfad an, aus dem geheime Daten gelesen werden sollen. Legen Sie _ fest, um geheime Daten aus der Standardeingabe zu lesen.
apphosting:secrets:grantaccess KEY BACKEND_ID \
--project PROJECT_ID \
--location REGION
Gewährt dem Backend-Dienstkonto Zugriff auf das bereitgestellte Secret, damit App Hosting zur Build- oder Laufzeit darauf zugreifen kann.
apphosting:secrets:describe KEY \
--project PROJECT_ID
Ruft die Metadaten für ein Secret und seine Versionen ab.
firebase apphosting:secrets:access \
KEY[@version] \
--project PROJECT_ID
Greift auf einen Secret-Wert zu, wenn das Secret und seine Version angegeben sind. Standardmäßig wird auf die neueste Version zugegriffen.

Authentication-Befehle (Nutzerverwaltung)

Befehl Beschreibung
auth:export Exportiert die Nutzerkonten des aktiven Projekts in eine JSON- oder CSV-Datei. Weitere Informationen finden Sie auf der Seite auth:import und auth:export.
auth:import Importiert die Nutzerkonten aus einer JSON- oder CSV-Datei in das aktive Projekt. Weitere Informationen finden Sie auf der Seite auth:import und auth:export.

Cloud Firestore-Befehle

Befehl Beschreibung
firestore:locations

Liste der verfügbaren Standorte für Ihre Cloud Firestore-Datenbank.

firestore:databases:create DATABASE_ID

Erstellen Sie eine Datenbankinstanz im nativen Modus in Ihrem Firebase-Projekt.

Der Befehl akzeptiert die folgenden Flags:

  • --location <region name>, um den Bereitstellungsort für die Datenbank anzugeben. Mit firebase firestore:locations können Sie eine Liste der verfügbaren Standorte aufrufen. Erforderlich.
  • --delete-protection <deleteProtectionState> zum Zulassen oder Verhindern des Löschens der angegebenen Datenbank. Gültige Werte sind ENABLED und DISABLED. Die Standardeinstellung ist DISABLED.
  • --point-in-time-recovery <PITRState>, um festzulegen, ob die Wiederherstellung zu einem bestimmten Zeitpunkt aktiviert ist. Gültige Werte sind ENABLED und DISABLED. Die Standardeinstellung ist DISABLED. Optional.
firestore:databases:list

Datenbanken in Ihrem Firebase-Projekt auflisten

firestore:databases:get DATABASE_ID

Ruft die Datenbankkonfiguration für eine bestimmte Datenbank in Ihrem Firebase-Projekt ab.

firestore:databases:update DATABASE_ID

Aktualisiert die Datenbankkonfiguration einer angegebenen Datenbank in Ihrem Firebase-Projekt.

Mindestens ein Flag ist erforderlich. Der Befehl akzeptiert die folgenden Flags:

  • --delete-protection <deleteProtectionState> zum Zulassen oder Verhindern des Löschens der angegebenen Datenbank. Gültige Werte sind ENABLED und DISABLED. Die Standardeinstellung ist DISABLED.
  • --point-in-time-recovery <PITRState>, um festzulegen, ob die Wiederherstellung zu einem bestimmten Zeitpunkt aktiviert ist. Gültige Werte sind ENABLED und DISABLED. Die Standardeinstellung ist DISABLED. Optional.
firestore:databases:delete DATABASE_ID

Löschen Sie eine Datenbank in Ihrem Firebase-Projekt.

firestore:indexes

Indexe für eine Datenbank in Ihrem Firebase-Projekt auflisten.

Der Befehl akzeptiert das folgende Flag:

  • --database DATABASE_ID, um den Namen der Datenbank anzugeben, für die Indexe aufgeführt werden sollen. Wenn nicht angegeben, werden die Indexe für die Standarddatenbank aufgeführt.
firestore:delete

Löscht Dokumente in der Datenbank des aktiven Projekts. Mit der CLI können Sie alle Dokumente in einer Sammlung rekursiv löschen.

Das Löschen von Cloud Firestore-Daten über die Befehlszeile verursacht Lese- und Löschkosten. Weitere Informationen finden Sie unter Abrechnung für Cloud Firestore.

Der Befehl akzeptiert das folgende Flag:

  • --database DATABASE_ID zum Angeben des Namens der Datenbank, aus der Dokumente gelöscht werden. Wenn nicht angegeben, werden Dokumente aus der Standarddatenbank gelöscht. Optional.

Cloud Functions for Firebase-Befehle

Befehl Beschreibung
functions:config:clone Klonen der Umgebung eines anderen Projekts in das aktive Firebase-Projekt.
functions:config:get Ruft vorhandene Konfigurationswerte der Cloud Functions des aktiven Projekts ab.
functions:config:set Speichert Laufzeitkonfigurationswerte der Cloud Functions des aktiven Projekts.
functions:config:unset Entfernt Werte aus der Laufzeitkonfiguration des aktiven Projekts.
functions:log Liest Logs aus bereitgestellten Cloud Functions.

Weitere Informationen finden Sie in der Dokumentation zur Umgebungskonfiguration.

Crashlytics-Befehle

Befehl Beschreibung
crashlytics:mappingfile:generateid \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML
Generiert eine eindeutige ID für die Zuordnungsdatei in der angegebenen Android-Ressourcendatei (XML).
crashlytics:mappingfile:upload \
--app=FIREBASE_APP_ID \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML \
PATH/TO/MAPPING_FILE.TXT
Lädt eine ProGuard-kompatible Zuordnungsdatei (TXT) für diese App hoch und verknüpft sie mit der Zuordnungsdatei-ID, die in der angegebenen Android-Ressourcendatei (XML) deklariert ist.
crashlytics:symbols:upload \
--app=FIREBASE_APP_ID \
PATH/TO/SYMBOLS
Generiert eine Crashlytics-kompatible Symboldatei für Abstürze nativer Bibliotheken unter Android und lädt sie auf Firebase-Server hoch.

Data Connect-Befehle

Diese Befehle und ihre Anwendungsfälle werden im Data Connect-CLI-Referenzhandbuch ausführlicher beschrieben.

Befehl Beschreibung
dataconnect:services:list Listet alle bereitgestellten Data Connect-Dienste in Ihrem Firebase-Projekt auf.
dataconnect:sql:diff \
SERVICE_ID
Zeigt für den angegebenen Dienst die Unterschiede zwischen einem lokalen Data Connect-Schema und Ihrem Cloud SQL-Datenbankschema an.
dataconnect:sql:migrate \
--force \
SERVICE_ID
Migriert das Schema Ihrer Cloud SQL-Datenbank, damit es mit Ihrem lokalen Data Connect-Schema übereinstimmt.
dataconnect:sql:grant\
--role=ROLE \
--email=EMAIL \
SERVICE_ID
Weist die SQL-Rolle der angegebenen E-Mail-Adresse des Nutzers oder Dienstkontos zu.
Für das Flag --role ist die zu gewährende SQL-Rolle eine der folgenden: owner, writer oder reader.
Geben Sie für das Flag --email die E-Mail-Adresse des Nutzers oder Dienstkontos an, dem Sie die Rolle zuweisen möchten.
dataconnect:sdk:generate Generiert typisierte SDKs für Ihre Data Connect-Connectors.

Extensions-Befehle

Befehl Beschreibung
ext Zeigt Informationen zur Verwendung von Firebase Extensions-Befehlen an.
Listet die im aktiven Projekt installierten Erweiterungsinstanzen auf.
ext:configure \
EXTENSION_INSTANCE_ID
Konfiguriert die Parameterwerte einer Erweiterungsinstanz in Ihrem Erweiterungsmanifest neu.
ext:info \
PUBLISHER_ID/EXTENSION_ID
Gibt detaillierte Informationen zu einer Erweiterung aus.
ext:install \
PUBLISHER_ID/EXTENSION_ID
Fügt dem Erweiterungsmanifest eine neue Instanz einer Erweiterung hinzu.
ext:list Listet alle in einem Firebase-Projekt installierten Erweiterungsinstanzen auf.
Gibt die Instanz-ID für jede Erweiterung aus.
ext:uninstall \
EXTENSION_INSTANCE_ID
Entfernt eine Erweiterungsinstanz aus Ihrem Erweiterungsmanifest.
ext:update \
EXTENSION_INSTANCE_ID
Aktualisiert eine Erweiterungsinstanz auf die neueste Version in Ihrem Erweiterungsmanifest.
ext:export Exportiert alle installierten Erweiterungsinstanzen aus Ihrem Projekt in Ihr Erweiterungsmanifest.

Extensions Publisher-Befehle

Befehl Beschreibung
ext:dev:init Initialisiert eine Skelett-Codebasis für eine neue Erweiterung im aktuellen Verzeichnis.
ext:dev:list \
PUBLISHER_ID
Gibt eine Liste aller von einem Verlag oder Webpublisher hochgeladenen Erweiterungen aus.
ext:dev:register Registriert ein Firebase-Projekt als Extensions-Publisher-Projekt.
ext:dev:deprecate \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE
Stellt Erweiterungsversionen ein, die dem Versionsprädikat entsprechen.
Ein Versionsprädikat kann eine einzelne Version (z. B. 1.0.0) oder ein Versionsbereich (z. B. >1.0.0) sein.
Wenn kein Versionsprädikat angegeben wird, werden alle Versionen dieser Erweiterung verworfen.
ext:dev:undeprecate \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE
Hebt die Einstellung von Erweiterungsversionen auf, die dem Versionsprädikat entsprechen.
Ein Versionsprädikat kann eine einzelne Version (z. B. 1.0.0) oder ein Versionsbereich (z. B. >1.0.0) sein.
Wenn kein Versionsprädikat angegeben wird, wird die Einstellung „Verworfen“ für alle Versionen dieser Erweiterung aufgehoben.
ext:dev:upload \
PUBLISHER_ID/EXTENSION_ID
Lädt eine neue Version einer Erweiterung hoch.
ext:dev:usage \
PUBLISHER_ID
Hier werden die Installationszahlen und Nutzungsmesswerte für Erweiterungen angezeigt, die von einem Publisher hochgeladen wurden.

Hosting-Befehle

Befehl Beschreibung
hosting:disable

Die Bereitstellung von Firebase Hosting-Traffic für das aktive Firebase-Projekt wird beendet.

In der Hosting-URL Ihres Projekts wird nach Ausführung dieses Befehls die Meldung „Site Not Found“ (Website nicht gefunden) angezeigt.

Verwaltung von Hosting Websites
firebase hosting:sites:create \
SITE_ID

Erstellt eine neue Hosting-Website im aktiven Firebase-Projekt mit dem angegebenen SITE_ID.

(Optional) Geben Sie eine vorhandene Firebase-Web-App an, die mit der neuen Website verknüpft werden soll, indem Sie das folgende Flag übergeben: --app FIREBASE_APP_ID

firebase hosting:sites:delete \
SITE_ID

Löscht die angegebene Hosting-Website.

In der CLI wird vor dem Löschen der Website eine Bestätigungsaufforderung angezeigt.

(Optional) Überspringen Sie die Bestätigungsaufforderung, indem Sie die folgenden Flags übergeben: -f oder --force.

firebase hosting:sites:get \
SITE_ID

Ruft Informationen zur angegebenen Hosting-Website ab.

firebase hosting:sites:list

Listet alle Hosting-Websites für das aktive Firebase-Projekt auf

Vorschaukanäle verwalten
firebase hosting:channel:create \
CHANNEL_ID

Erstellt einen neuen Vorschaukanal auf der Standardwebsite Hosting mit dem angegebenen CHANNEL_ID.

Mit diesem Befehl wird die App nicht auf dem Channel bereitgestellt.

firebase hosting:channel:delete \
CHANNEL_ID

Löscht den angegebenen Vorschaukanal.

Der Live-Kanal einer Website kann nicht gelöscht werden.

firebase hosting:channel:deploy \
CHANNEL_ID

Stellt die Hosting-Inhalte und -Konfiguration im angegebenen Vorschaukanal bereit

Wenn der Vorschaukanal noch nicht vorhanden ist, wird er mit diesem Befehl auf der Standardwebsite Hosting erstellt, bevor die Bereitstellung auf dem Kanal erfolgt.

firebase hosting:channel:list Listet alle Channels (einschließlich des „Live“-Channels) auf der default-Website Hosting auf.
firebase hosting:channel:open \
CHANNEL_ID
Öffnet einen Browser mit der URL des angegebenen Channels oder gibt die URL zurück, wenn das Öffnen in einem Browser nicht möglich ist.
Version klonen
firebase hosting:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

Klonen der zuletzt bereitgestellten Version auf dem angegebenen „Quellkanal“ in den angegebenen „Zielkanal“

Mit diesem Befehl wird auch im angegebenen Zielchannel bereitgestellt. Wenn der Zielkanal noch nicht vorhanden ist, wird mit diesem Befehl ein neuer Vorschaukanal auf der Hosting-Website des Ziels erstellt, bevor die Bereitstellung für den Kanal erfolgt.

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

Klonen der angegebenen Version in den angegebenen Zielkanal

Mit diesem Befehl wird auch im angegebenen Zielchannel bereitgestellt. Wenn der Zielkanal noch nicht vorhanden ist, wird mit diesem Befehl ein neuer Vorschaukanal auf der Hosting-Website des Ziels erstellt, bevor die Bereitstellung für den Kanal erfolgt.

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

Realtime Database-Befehle

Sie können Ihre erste Standardinstanz Realtime Database in der Firebase-Konsole oder mit dem allgemeinen firebase init-Workflow oder dem spezifischen firebase init database-Ablauf erstellen.

Nachdem Sie Instanzen erstellt haben, können Sie sie wie unter Mehrere Realtime Database-Instanzen verwalten beschrieben verwalten.

Befehl Beschreibung
database:get Ruft Daten aus der Datenbank des aktiven Projekts ab und zeigt sie als JSON an. Unterstützt das Abfragen von indexierten Daten.
database:instances:create Erstellt eine Datenbankinstanz mit einem angegebenen Instanznamen. Akzeptiert die Option --location zum Erstellen einer Datenbank in einer bestimmten Region. Informationen zu Regionsnamen, die mit dieser Option verwendet werden können, finden Sie unter Standorte für Ihr Projekt auswählen. Wenn für das aktuelle Projekt keine Datenbankinstanz vorhanden ist, werden Sie aufgefordert, den firebase init-Ablauf auszuführen, um eine Instanz zu erstellen.
database:instances:list Alle Datenbankinstanzen für dieses Projekt auflisten. Akzeptiert die Option --location zum Auflisten von Datenbanken in einer bestimmten Region. Informationen zu Regionsnamen, die mit dieser Option verwendet werden können, finden Sie unter Standorte für Ihr Projekt auswählen.
database:profile Erstellt ein Profil der Vorgänge in der Datenbank des aktiven Projekts. Weitere Informationen finden Sie unter Realtime Database-Vorgangstypen.
database:push Fügt einer Liste an einem bestimmten Ort in der Datenbank des aktiven Projekts neue Daten hinzu. Akzeptiert Eingaben aus einer Datei, von STDIN oder über ein Befehlszeilenargument.
database:remove Löscht alle Daten an einem angegebenen Speicherort in der Datenbank des aktiven Projekts.
database:set Ersetzt alle Daten an einem angegebenen Speicherort in der Datenbank des aktiven Projekts. Akzeptiert Eingaben aus einer Datei, von STDIN oder aus einem Befehlszeilenargument.
database:update Führt eine Teilaktualisierung an einem angegebenen Ort in der Datenbank des aktiven Projekts durch. Akzeptiert Eingaben aus einer Datei, von STDIN oder über ein Befehlszeilenargument.

Remote Config-Befehle

Befehl Beschreibung
remoteconfig:versions:list \
--limit NUMBER_OF_VERSIONS
Hier werden die zehn neuesten Versionen der Vorlage aufgeführt. Geben Sie 0 an, um alle vorhandenen Versionen zurückzugeben, oder übergeben Sie optional die Option --limit, um die Anzahl der zurückgegebenen Versionen zu begrenzen.
remoteconfig:get \
--v, version_number VERSION_NUMBER
--o, output FILENAME
Ruft die Vorlage nach Version ab (standardmäßig die neueste Version) und gibt die Parametergruppen, Parameter, Bedingungsnamen und die Version in einer Tabelle aus. Optional können Sie die Ausgabe mit -o, FILENAME in eine bestimmte Datei schreiben.
remoteconfig:rollback \
--v, version_number VERSION_NUMBER
--force
Führt ein Rollback der Vorlage Remote Config auf eine angegebene vorherige Versionsnummer durch. Standardmäßig wird die unmittelbar vorherige Version verwendet (aktuelle Version – 1). Sofern --force nicht übergeben wird, werden vor dem Rollback die Aufforderungen Y/N angezeigt.