Dokumentacja interfejsu wiersza poleceń Firebase

Interfejs wiersza poleceń Firebase (GitHub) udostępnia różne narzędzia do zarządzania projektami w Firebase, wyświetlania ich i wdrażania.

Zanim zaczniesz korzystać z interfejsu wiersza poleceń Firebase, skonfiguruj projekt w Firebase.

Konfigurowanie i aktualizowanie interfejsu wiersza poleceń

Instalowanie interfejsu wiersza poleceń Firebase

Interfejs wiersza poleceń Firebase możesz zainstalować za pomocą metody, która odpowiada Twojemu systemowi operacyjnemu, poziomowi doświadczenia lub przypadkowi użycia. Niezależnie od sposobu instalacji interfejsu wiersza poleceń masz dostęp do tych samych funkcji i polecenia firebase.

Uwaga: polecenia interfejsu wiersza poleceń Firebase możesz też uruchamiać w Cloud Shell. Cloud Shell to działające w przeglądarce, wstępnie uwierzytelnione środowisko wiersza poleceń, które jest dostępne z konsoli Firebase i ma fabrycznie zainstalowany interfejs wiersza poleceń Firebase. Dzięki temu jest to wygodna opcja na szybkie rozpoczęcie pracy, pod warunkiem że dodasz pliki projektu do środowiska Cloud Shell.

Windows macOS Linux

Windows

Interfejs wiersza poleceń Firebase dla systemu Windows możesz zainstalować na jeden z tych sposobów:

Opcja	Opis	Polecane dla…
samodzielny plik binarny	Pobierz samodzielny plik binarny interfejsu wiersza poleceń. Następnie możesz uzyskać dostęp do pliku wykonywalnego, aby otworzyć powłokę, w której możesz uruchomić polecenie firebase.	Nowi deweloperzy Deweloperzy, którzy nie używają Node.js lub nie znają tego środowiska
npm	Użyj npm (Node Package Manager), aby zainstalować interfejs wiersza poleceń i włączyć globalnie dostępne polecenie firebase.	Programiści korzystający z Node.js

samodzielny plik binarny

Aby pobrać i uruchomić plik binarny interfejsu wiersza poleceń Firebase, wykonaj te czynności:

1. Pobierz plik binarny interfejsu wiersza poleceń Firebase dla systemu Windows.

2. Uzyskaj dostęp do pliku binarnego, aby otworzyć powłokę, w której możesz uruchomić polecenie firebase.

3. Przejdź do sekcji logowania się i testowania interfejsu wiersza poleceń.

npm

Aby zainstalować interfejs wiersza poleceń Firebase za pomocą npm (menedżera pakietów Node), wykonaj te czynności:

1. Zainstaluj Node.js za pomocą nvm-windows (menedżera wersji Node). Instalacja Node.js automatycznie instaluje narzędzia poleceń npm.

   Uwaga: interfejs wiersza poleceń Firebase wymaga Node.js w wersji 18.0.0 lub nowszej. Niektóre funkcje Firebase mogą wymagać określonych wersji Node.js, dlatego sprawdź na stronie Pierwsze kroki każdego produktu Firebase, czy nie ma on określonych wymagań dotyczących Node.js.

2. Zainstaluj interfejs wiersza poleceń Firebase za pomocą npm, uruchamiając to polecenie:

   npm install -g firebase-tools

   To polecenie włącza polecenie firebase, które jest dostępne globalnie.

   Uwaga: jeśli polecenie npm install -g firebase-tools nie powiedzie się, może być konieczna zmiana uprawnień npm.

3. Przejdź do sekcji logowania się i testowania interfejsu wiersza poleceń.

macOS lub Linux

Interfejs wiersza poleceń Firebase w systemie macOS lub Linux możesz zainstalować, korzystając z jednej z tych opcji:

Opcja	Opis	Polecane dla…
skrypt automatycznej instalacji	Uruchom jedno polecenie, które automatycznie wykryje system operacyjny, pobierze najnowszą wersję interfejsu wiersza poleceń, a następnie włączy ogólnodostępne polecenie firebase.	Nowi deweloperzy Deweloperzy, którzy nie używają lub nie znają Node.js Automatyczne wdrożenia w środowisku CI/CD
samodzielny plik binarny	Pobierz samodzielny plik binarny interfejsu wiersza poleceń. Następnie możesz skonfigurować i uruchomić plik binarny zgodnie z Twoim przepływem pracy.	W pełni konfigurowalne przepływy pracy za pomocą interfejsu wiersza poleceń
npm	Użyj npm (Node Package Manager), aby zainstalować interfejs wiersza poleceń i włączyć globalnie dostępne polecenie firebase.	Programiści korzystający z Node.js

skrypt automatycznej instalacji

Aby zainstalować interfejs wiersza poleceń Firebase za pomocą skryptu automatycznej instalacji, wykonaj te czynności:

1. Uruchom to polecenie cURL:

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

   Ten skrypt automatycznie wykrywa system operacyjny, pobiera najnowszą wersję interfejsu wiersza poleceń Firebase, a następnie włącza ogólnodostępne polecenie firebase.

   Uwaga: jeśli podczas instalacji w systemie macOS lub Linux wystąpią problemy z uprawnieniami, może być konieczne użycie polecenia sudo, aby przyznać skryptowi wymagane uprawnienia: sudo curl -sL https://firebase.tools | bash

2. Przejdź do sekcji logowania się i testowania interfejsu wiersza poleceń.

Więcej przykładów i szczegółowych informacji o skrypcie automatycznej instalacji znajdziesz w kodzie źródłowym skryptu na stronie firebase.tools.

samodzielny plik binarny

Aby pobrać i uruchomić plik binarny interfejsu wiersza poleceń Firebase dla Twojego systemu operacyjnego, wykonaj te czynności:

1. Pobierz plik binarny interfejsu wiersza poleceń Firebase dla swojego systemu operacyjnego: macOS | Linux

2. (Opcjonalnie) Skonfiguruj polecenie firebase dostępne globalnie.

   1. Uruchom chmod +x ./firebase_tools, aby plik binarny był wykonywalny.
   2. Dodaj ścieżkę pliku binarnego do zmiennej PATH.
   Uwaga: jeśli nie skonfigurujesz polecenia firebase, za każdym razem, gdy będziesz chcieć uruchomić polecenie interfejsu wiersza poleceń Firebase, musisz uzyskać dostęp do pliku binarnego.

3. Przejdź do sekcji logowania się i testowania interfejsu wiersza poleceń.

npm

Aby użyć npm (menedżera pakietów Node) do zainstalowania interfejsu wiersza poleceń Firebase, wykonaj te czynności:

1. Zainstaluj Node.js za pomocą nvm (menedżera wersji Node).
   Zainstalowanie Node.js powoduje automatyczne zainstalowanie narzędzi wiersza poleceń npm.

   Uwaga: interfejs wiersza poleceń Firebase wymaga Node.js w wersji 18.0.0 lub nowszej. Niektóre funkcje Firebase mogą wymagać określonych wersji Node.js, dlatego sprawdź na stronie Pierwsze kroki każdego produktu Firebase, czy nie ma on określonych wymagań dotyczących Node.js.

2. Zainstaluj interfejs wiersza poleceń Firebase za pomocą npm, uruchamiając to polecenie:

   npm install -g firebase-tools

   To polecenie włącza polecenie firebase, które jest dostępne globalnie.

   Uwaga: jeśli polecenie npm install -g firebase-tools nie powiedzie się, może być konieczna zmiana uprawnień npm.

3. Przejdź do sekcji logowania się i testowania interfejsu wiersza poleceń.

Logowanie się i testowanie interfejsu wiersza poleceń Firebase

Po zainstalowaniu interfejsu wiersza poleceń musisz się uwierzytelnić. Następnie możesz potwierdzić uwierzytelnienie, wyświetlając listę projektów w Firebase.

1. Zaloguj się w Firebase za pomocą konta Google, uruchamiając to polecenie:

   firebase login

   To polecenie łączy komputer lokalny z Firebase i przyznaje dostęp do projektów w Firebase.

   Uwaga: polecenie firebase login otwiera stronę internetową, która łączy się z localhost na Twoim komputerze. Jeśli używasz komputera zdalnego i nie masz dostępu do localhost, uruchom polecenie z flagą --no-localhost.
   Uwaga: możesz też używać interfejsu wiersza poleceń Firebase z systemami CI.

2. Sprawdź, czy interfejs wiersza poleceń jest prawidłowo zainstalowany i ma dostęp do Twojego konta, wyświetlając listę projektów w Firebase. Uruchom to polecenie:

   firebase projects:list

   Wyświetlana lista powinna być taka sama jak lista projektów w Firebase w konsoli Firebase.

Aktualizowanie do najnowszej wersji interfejsu wiersza poleceń

Zasadniczo zalecamy korzystanie z najnowszej wersji interfejsu wiersza poleceń Firebase.

W wielu przypadkach nowe funkcje i poprawki błędów są dostępne tylko w najnowszej wersji interfejsu wiersza poleceń Firebase. Dobrą praktyką jest częste aktualizowanie interfejsu wiersza poleceń do najnowszej wersji.

Sposób aktualizacji wersji interfejsu wiersza poleceń zależy od systemu operacyjnego i sposobu instalacji interfejsu wiersza poleceń.

Windows

• samodzielny plik binarny: pobierz nową wersję, a następnie zastąp nią plik w systemie;
• npm: uruchom npm install -g firebase-tools

macOS

• skrypt automatycznej instalacji: uruchom curl -sL https://firebase.tools | upgrade=true bash

  Uwaga: jeśli podczas instalacji w systemie macOS lub Linux wystąpią problemy z uprawnieniami, może być konieczne użycie polecenia sudo, aby przyznać skryptowi wymagane uprawnienia: sudo curl -sL https://firebase.tools | upgrade=true bash

• samodzielny plik binarny: pobierz nową wersję, a następnie zastąp nią plik w systemie;

• npm: uruchom npm install -g firebase-tools

Linux

• skrypt automatycznej instalacji: uruchom curl -sL https://firebase.tools | upgrade=true bash

  Uwaga: jeśli podczas instalacji w systemie macOS lub Linux wystąpią problemy z uprawnieniami, może być konieczne użycie polecenia sudo, aby przyznać skryptowi wymagane uprawnienia: sudo curl -sL https://firebase.tools | upgrade=true bash

• samodzielny plik binarny: pobierz nową wersję, a następnie zastąp nią plik w systemie;

• npm: uruchom npm install -g firebase-tools

Odinstalowywanie interfejsu wiersza poleceń Firebase

Sposób odinstalowania interfejsu wiersza poleceń zależy od systemu operacyjnego i sposobu instalacji interfejsu wiersza poleceń.

Windows

• samodzielny plik binarny: usuń pobrany plik binarny firebase.exe.
• npm: uruchom npm uninstall -g firebase-tools

macOS

• skrypt automatycznej instalacji: uruchom curl -sL https://firebase.tools | uninstall=true bash

  Uwaga: jeśli podczas odinstalowywania w systemie macOS lub Linux wystąpią problemy z uprawnieniami, może być konieczne użycie polecenia sudo, aby przyznać skryptowi wymagane uprawnienia: sudo curl -sL https://firebase.tools | uninstall=true bash

• samodzielny plik binarny: usuń pobrany plik binarny firebase. Jeśli lokalizacja została dodana do zmiennej środowiskowej PATH, usuń ją.

• npm: uruchom npm uninstall -g firebase-tools

Linux

• skrypt automatycznej instalacji: uruchom curl -sL https://firebase.tools | uninstall=true bash

  Uwaga: jeśli podczas odinstalowywania w systemie macOS lub Linux wystąpią problemy z uprawnieniami, może być konieczne użycie polecenia sudo, aby przyznać skryptowi wymagane uprawnienia: sudo curl -sL https://firebase.tools | uninstall=true bash

• samodzielny plik binarny: usuń pobrany plik binarny firebase. Jeśli lokalizacja została dodana do zmiennej środowiskowej PATH, usuń ją.

• npm: uruchom npm uninstall -g firebase-tools

Korzystanie z interfejsu wiersza poleceń w systemach CI

Zalecamy uwierzytelnianie za pomocą domyślnego uwierzytelniania aplikacji, gdy używasz interfejsu wiersza poleceń z systemami CI.

(Zalecane) Użyj domyślnego uwierzytelniania aplikacji

Interfejs wiersza poleceń Firebase wykryje i użyje domyślnego uwierzytelniania aplikacji, jeśli jest ono skonfigurowane. Najprostszym sposobem uwierzytelniania interfejsu wiersza poleceń w CI i innych środowiskach bez interfejsu graficznego jest skonfigurowanie domyślnego uwierzytelniania aplikacji.

(Starsza wersja) Użyj FIREBASE_TOKEN

Możesz też uwierzytelnić się za pomocą FIREBASE_TOKEN. Jest to mniej bezpieczne niż domyślne uwierzytelnianie aplikacji i nie jest już zalecane.

1. Na komputerze z przeglądarką zainstaluj interfejs wiersza poleceń Firebase.

2. Rozpocznij proces logowania, uruchamiając to polecenie:

   firebase login:ci

3. Wejdź na podany adres URL i zaloguj się za pomocą konta Google.

4. Wydrukuj nowy token odświeżania. Nie będzie to miało wpływu na bieżącą sesję CLI.

5. Zapisz token wyjściowy w bezpieczny, ale dostępny sposób w systemie CI.

6. Używaj tego tokena podczas uruchamiania poleceń firebase. Możesz użyć jednej z tych 2 opcji:

   • Opcja 1. Zapisz token jako zmienną środowiskową FIREBASE_TOKEN. System automatycznie użyje tokena.

   • Opcja 2. Uruchom wszystkie polecenia firebase z flagą --token TOKEN w systemie CI.
     Kolejność pierwszeństwa wczytywania tokena: flaga, zmienna środowiskowa, żądany projekt w Firebase.

Uwaga: na dowolnym komputerze z zainstalowanym interfejsem wiersza poleceń Firebase możesz natychmiast unieważnić dostęp dla określonego tokena, uruchamiając to polecenie: firebase logout --token TOKEN

Inicjowanie projektu w Firebase

Wiele typowych zadań wykonywanych za pomocą interfejsu wiersza poleceń, takich jak wdrażanie w projekcie Firebase, wymaga katalogu projektu. Katalog projektu tworzysz za pomocą polecenia firebase init. Katalog projektu jest zwykle taki sam jak katalog główny kontroli źródła, a po uruchomieniu polecenia firebase init zawiera plik konfiguracji firebase.json.

Aby zainicjować nowy projekt w Firebase, uruchom to polecenie w katalogu aplikacji:

firebase init

Uwaga: polecenie firebase init nie tworzy nowego katalogu. Jeśli tworzysz nową aplikację, musisz najpierw utworzyć katalog, a następnie uruchomić w nim polecenie firebase init.

Polecenie firebase init przeprowadzi Cię przez proces konfigurowania katalogu projektu i niektórych usług Firebase. Podczas inicjowania projektu interfejs wiersza poleceń Firebase prosi o wykonanie tych zadań:

• Wybierz domyślny projekt w Firebase.

  Ten krok wiąże bieżący katalog projektu z projektem w Firebase, dzięki czemu polecenia dotyczące projektu (takie jak firebase deploy) są wykonywane w odpowiednim projekcie w Firebase.

  Możesz też powiązać wiele projektów w Firebase (np. projekt testowy i produkcyjny) z tym samym katalogiem projektu.

• Wybierz usługi Firebase, które chcesz skonfigurować w projekcie w Firebase.

  W tym kroku musisz skonfigurować ustawienia konkretnych plików dla wybranych usług lub funkcji. Więcej informacji o tych konfiguracjach znajdziesz w dokumentacji konkretnych produktów (np. Hosting lub Authentication). Pamiętaj, że zawsze możesz później uruchomić firebase init, aby skonfigurować więcej produktów Firebase.

Po zakończeniu inicjowania Firebase automatycznie tworzy te 2 pliki w katalogu głównym lokalnego katalogu aplikacji:

• Plik konfiguracji firebase.json, który zawiera konfigurację projektu.

• Plik .firebaserc, w którym przechowywane są aliasy projektu.

Plik firebase.json

Polecenie firebase init tworzy plik konfiguracji firebase.json w katalogu głównym projektu.

Plik firebase.json jest wymagany do wdrażania zasobów za pomocą interfejsu wiersza poleceń Firebase, ponieważ określa, które pliki i ustawienia z katalogu projektu są wdrażane w projekcie w Firebase (np. ustawienia Hosting, konfiguracje dostawców Authentication, reguły zabezpieczeń i konfiguracja Cloud Functions). Niektóre ustawienia można zdefiniować w katalogu projektu lub w konsoli Firebase, dlatego upewnij się, że rozwiążesz wszystkie potencjalne konflikty wdrażania.

Możesz skonfigurować większość opcji Firebase Hosting bezpośrednio w pliku firebase.json. Jednak w przypadku innych usług Firebase, które można wdrożyć za pomocą interfejsu wiersza poleceń Firebase, polecenie firebase init tworzy określone pliki, w których można zdefiniować ustawienia tych usług, np. plik index.js dla Cloud Functions. W pliku firebase.json możesz też skonfigurować hooki przed wdrożeniem lub po wdrożeniu.

Uwaga: jeśli ponownie uruchomisz polecenie firebase init dla dowolnej usługi Firebase, polecenie zastąpi odpowiednią sekcję pliku firebase.json domyślną konfiguracją tej usługi.

Poniższy plik firebase.json to kompleksowy przykład pokazujący opcje konfiguracji wielu usług Firebase. Pokazuje też funkcje takie jak konfiguracja Cloud Functions i Local Emulator Suite z wieloma bazami kodu oraz szablon Remote Config. Pamiętaj, że plik firebase.json dla danego projektu będzie zawierać tylko konfiguracje usług Firebase skonfigurowanych dla tego konkretnego projektu (np. tylko Firebase Hosting i Cloud Functions). Dodanie klucza $schema umożliwia sprawdzanie poprawności i autouzupełnianie w wielu edytorach kodu.

    {
      "$schema": "https://raw.githubusercontent.com/firebase/firebase-tools/master/schema/firebase-config.json",
      "hosting": {
        "public": "public",
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ],
        "cleanUrls": true,
        "trailingSlash": false
      },
      "apphosting": {
        "backendId": "my-app",
        "rootDir": "backend",
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ]
      },
      "firestore": {
        "rules": "firestore.rules",
        "indexes": "firestore.indexes.json"
      },
      "storage": {
        "rules": "storage.rules"
      },
      "database": {
        "rules": "database.rules.json"
      },
      "dataconnect": {
        "source": "dataconnect",
        "location": "us-central1"
      },
      "functions": [
        {
          "source": "functions",
          "codebase": "default",
          "ignore": [
            "**/.*",
            "**/node_modules/**"
          ],
          "predeploy": [
            "npm --prefix \"$RESOURCE_DIR\" run lint",
            "npm --prefix \"$RESOURCE_DIR\" run build"
          ]
        }
      ],
      "emulators": {
        "auth": {
          "port": 9099
        },
        "functions": {
          "port": 5001
        },
        "firestore": {
          "port": 8080
        },
        "hosting": {
          "port": 5000
        },
        "storage": {
          "port": 9199
        },
        "ui": {
          "enabled": true,
          "port": 4000
        },
        "singleProjectMode": true
      },
      "extensions": {
        "my-storage-resizer": "firebase/storage-resize-images@^0.1.0"
      },
      "auth": {
        "providers": {
          "anonymous": true,
          "emailPassword": true,
          "googleSignIn": {
            "oAuthBrandDisplayName": "My App",
            "supportEmail": "[e-mail]"
          }
        }
      },
      "remoteconfig": {
        "template": "remoteconfig.template.json"
      }
    }

Domyślnie używany jest plik firebase.json, ale możesz przekazać flagę --config PATH, aby określić alternatywny plik konfiguracji.

Konfiguracja wielu baz danych Cloud Firestore

Gdy uruchomisz firebase init, plik firebase.json będzie zawierać pojedynczy klucz firestore odpowiadający domyślnej bazie danych projektu, jak pokazano w poprzednim przykładzie.

Jeśli projekt zawiera wiele baz danych Cloud Firestore, zmodyfikuj plik firebase.json, aby powiązać różne pliki źródłowe Cloud Firestore Security Rules i indeksu bazy danych z każdą bazą danych. Zmodyfikuj plik za pomocą tablicy JSON, która zawiera po 1 wpisie dla każdej bazy danych.

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

Pliki, które mają być ignorowane podczas wdrażania: Cloud Functions

Podczas wdrażania funkcji interfejs wiersza poleceń automatycznie określa listę plików w katalogu functions, które mają być ignorowane. Zapobiega to wdrażaniu w backendzie niepotrzebnych plików, które mogłyby zwiększyć rozmiar danych wdrożenia.

Lista plików ignorowanych domyślnie, wyświetlana w formacie JSON:

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

Jeśli dodasz własne wartości niestandardowe dla ignore w firebase.json, pamiętaj, aby zachować (lub dodać, jeśli brakuje) listę plików widoczną na poprzedniej liście.

Zarządzanie aliasami projektów

Z tym samym katalogiem projektu możesz powiązać wiele projektów w Firebase. Możesz na przykład używać jednego projektu w Firebase do testowania, a drugiego do produkcji. Dzięki różnym środowiskom projektów możesz weryfikować zmiany przed wdrożeniem ich w środowisku produkcyjnym. Polecenie firebase use umożliwia przełączanie się między aliasami oraz tworzenie nowych aliasów.

Dodawanie aliasu projektu

Gdy wybierzesz projekt w Firebase podczas inicjowania projektu, zostanie mu automatycznie przypisany alias default. Jeśli jednak chcesz, aby polecenia dotyczące konkretnego projektu były wykonywane w innym projekcie w Firebase, ale nadal używały tego samego katalogu projektu, uruchom w katalogu projektu to polecenie:

firebase use --add

To polecenie wyświetli prośbę o wybranie innego projektu w Firebase i przypisanie go jako aliasu. Przypisania aliasów są zapisywane w pliku .firebaserc w katalogu projektu.

Używanie aliasów projektów

Aby używać przypisanych aliasów projektów w Firebase, uruchom dowolne z tych poleceń w katalogu projektu.

Polecenie	Opis
firebase use	Wyświetlanie listy zdefiniowanych aliasów katalogu projektu
firebase use \ PROJECT_ID|ALIAS	Kieruje wszystkie polecenia do uruchomienia w określonym projekcie w Firebase. Interfejs wiersza poleceń używa tego projektu jako „aktywnego projektu”.
firebase use --clear	Czyści aktywny projekt. Uruchom firebase use PROJECT_ID|ALIAS, aby ustawić nowy aktywny projekt przed uruchomieniem innych poleceń interfejsu wiersza poleceń.
firebase use \ --unalias PROJECT_ALIAS	Usuwa alias z katalogu projektu.

Możesz zastąpić aktywny projekt, przekazując flagę --project z dowolnym poleceniem interfejsu wiersza poleceń. Możesz na przykład ustawić interfejs wiersza poleceń tak, aby działał w projekcie w Firebase, któremu przypisano alias staging. Jeśli chcesz uruchomić pojedyncze polecenie w projekcie w Firebase, do którego przypisano alias prod, możesz uruchomić na przykład firebase deploy --project=prod.

Kontrola źródła i aliasy projektów

Ogólnie rzecz biorąc, plik .firebaserc należy umieścić w systemie kontroli źródła, aby umożliwić zespołowi udostępnianie aliasów projektu. Jednak w przypadku projektów open source lub szablonów startowych nie należy przesyłać pliku .firebaserc.

Jeśli masz projekt programistyczny, który jest przeznaczony tylko do Twojego użytku, możesz przekazać flagę --project z każdym poleceniem lub uruchomić firebase use PROJECT_ID bez przypisywania aliasu do projektu w Firebase.

Obsługiwanie i testowanie projektu w Firebase lokalnie

Przed wdrożeniem projektu w Firebase w środowisku produkcyjnym możesz go wyświetlić i przetestować pod adresami URL hostowanymi lokalnie. Jeśli chcesz przetestować tylko wybrane funkcje, możesz użyć listy rozdzielonej przecinkami we fladze polecenia firebase serve.

Jeśli chcesz wykonać jedno z tych zadań, uruchom to polecenie z katalogu głównego lokalnego projektu:

• Wyświetlanie treści statycznych aplikacji hostowanej w Firebase.
• Używasz Cloud Functions do generowania zawartości dynamicznej dla Firebase Hosting i chcesz używać produkcyjnych (wdrożonych) funkcji HTTP do emulowania Hosting na lokalnym adresie URL.

firebase serve --only hosting

Emulowanie projektu za pomocą lokalnych funkcji HTTP

Uruchom dowolne z tych poleceń w katalogu projektu, aby emulować projekt za pomocą lokalnych funkcji HTTP.

• Aby emulować funkcje HTTP i hosting na potrzeby testowania na lokalnych adresach URL, użyj jednego z tych poleceń:

  firebase serve

  firebase serve --only functions,hosting // uses a flag

• Aby emulować tylko funkcje HTTP, użyj tego polecenia:

  firebase serve --only functions

Testowanie z innych urządzeń lokalnych

Domyślnie firebase serve odpowiada tylko na żądania z localhost. Oznacza to, że będziesz mieć dostęp do hostowanych treści z przeglądarki na komputerze, ale nie z innych urządzeń w sieci. Jeśli chcesz przeprowadzić test z innych urządzeń lokalnych, użyj flagi --host, na przykład:

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

Wdrażanie w projekcie w Firebase

Interfejs wiersza poleceń Firebase zarządza wdrażaniem kodu i zasobów w projekcie Firebase, w tym:

• Nowe wersje Firebase Hosting witryn
• Nowe, zaktualizowane lub istniejące: Cloud Functions for Firebase
• Nowe lub zaktualizowane schematy i konektory dla: Firebase SQL Connect
• Security Rules w Firebase Realtime Database
• Security Rules w Cloud Storage for Firebase
• Security Rules w Cloud Firestore
• Indeksy dla: Cloud Firestore
• Konfiguracja dla trybu Authentication

Aby wdrożyć projekt w Firebase, uruchom to polecenie w katalogu projektu:

firebase deploy

Do każdego wdrożenia możesz opcjonalnie dodać komentarz. Ten komentarz będzie wyświetlany wraz z innymi informacjami o wdrożeniu na stronie Firebase Hosting projektu. Na przykład:

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

Podczas korzystania z polecenia firebase deploy pamiętaj o tych kwestiach:

• Aby wdrożyć zasoby z katalogu projektu, katalog projektu musi zawierać plik firebase.json. Ten plik jest tworzony automatycznie przez polecenie firebase init.

• Domyślnie firebase deploy tworzy wersję dla wszystkich zasobów, które można wdrożyć, w katalogu projektu. Aby wdrożyć określone usługi lub funkcje Firebase, użyj wdrożenia częściowego.

Wdrażanie konkretnych usług Firebase

Jeśli chcesz wdrożyć tylko określone usługi lub funkcje Firebase, możesz użyć listy rozdzielonej przecinkami we fladze polecenia firebase deploy. Na przykład poniższe polecenie wdraża treści Firebase Hosting i Cloud Storage Security Rules.

firebase deploy --only hosting,storage

W tabeli poniżej znajdziesz usługi i funkcje dostępne w przypadku częściowego wdrożenia. Nazwy we flagach odpowiadają kluczom w pliku konfiguracji firebase.json.

Składnia flagi	Wdrożona usługa lub funkcja
--only auth	Konfiguracja dostawcy: Authentication
--only database	Firebase Realtime Database Security Rules
--only dataconnect	Schematy i oprogramowanie sprzęgające: Firebase SQL Connect
--only firestore	Cloud Firestore Security Rules oraz indeksy wszystkich skonfigurowanych baz danych
--only functions	Cloud Functions for Firebase
--only hosting	Treści (Firebase Hosting)
--only storage	Cloud Storage for Firebase Security Rules

Uwaga: składnia --only rules używana we wcześniejszych wersjach interfejsu wiersza poleceń została wycofana.

Konflikty we wdrażaniu: Security Rules

W przypadku Firebase Realtime Database, Cloud Storage for Firebase i Cloud Firestore możesz zdefiniować Security Rules w katalogu projektu lokalnego lub w konsoli Firebase.

Uwaga: gdy wdrażasz reguły zabezpieczeń za pomocą interfejsu wiersza poleceń Firebase, reguły zdefiniowane w katalogu projektu zastępują wszystkie istniejące reguły w konsoli Firebase. Jeśli więc zdecydujesz się zdefiniować lub edytować reguły zabezpieczeń za pomocą konsoli Firebase, pamiętaj, aby zaktualizować również reguły zdefiniowane w katalogu projektu.

Innym sposobem na uniknięcie konfliktów wdrażania jest użycie wdrożenia częściowego i zdefiniowanie tylko Security Rules w konsoli Firebase.

Konfigurowanie zadań skryptowych przed wdrożeniem i po nim

Możesz połączyć skrypty powłoki z poleceniem firebase deploy, aby wykonywać zadania przed wdrożeniem lub po nim. Na przykład skrypt przed wdrożeniem może transpilować kod TypeScript na JavaScript, a hook po wdrożeniu może powiadamiać administratorów o wdrożeniu nowej zawartości witryny w Firebase Hosting.

Aby skonfigurować skrypty predeploy lub postdeploy, dodaj skrypty bash do pliku konfiguracji firebase.json. Możesz zdefiniować krótkie skrypty bezpośrednio w pliku firebase.json lub odwołać się do innych plików w katalogu projektu.

Na przykład ten skrypt jest wyrażeniem firebase.json dla zadania po wdrożeniu, które wysyła wiadomość na Slacku po udanym wdrożeniu w Firebase Hosting.

"hosting": {
  // ...

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

Plik skryptu messageSlack.sh znajduje się w katalogu projektu i wygląda tak:

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

Możesz skonfigurować punkty zaczepienia predeploy i postdeploy dla dowolnych zasobów, które możesz wdrożyć. Pamiętaj, że uruchomienie polecenia firebase deploy aktywuje wszystkie zadania przed wdrożeniem i po jego zakończeniu zdefiniowane w pliku firebase.json. Aby uruchomić tylko te zadania, które są powiązane z konkretną usługą Firebase, użyj poleceń częściowego wdrażania.

Zarówno skrypt predeploy, jak i postdeploy wyświetlają w terminalu standardowe strumienie wyjściowe i strumienie błędów skryptów. W przypadku niepowodzenia pamiętaj o tych kwestiach:

• Jeśli punkt zaczepienia przed wdrożeniem nie zostanie ukończony zgodnie z oczekiwaniami, wdrożenie zostanie anulowane.
• Jeśli wdrożenie nie powiedzie się z jakiegokolwiek powodu, skrypty postdeploy nie zostaną wywołane.

Zmienne środowiskowe

W skryptach uruchamianych w punktach zaczepienia przed wdrożeniem i po wdrożeniu dostępne są te zmienne środowiskowe:

• $GCLOUD_PROJECT: identyfikator projektu aktywnego projektu.
• $PROJECT_DIR: katalog główny zawierający plik firebase.json
• $RESOURCE_DIR: (tylko w przypadku skryptów hosting i functions) lokalizacja katalogu zawierającego zasoby Hosting lub Cloud Functions do wdrożenia.

Limity wdrożeń

Możliwe (choć mało prawdopodobne), że przekroczysz limit, który ogranicza szybkość lub liczbę operacji wdrażania Firebase. Na przykład podczas wdrażania bardzo dużej liczby funkcji może pojawić się komunikat o błędzie HTTP 429 Quota. Aby rozwiązać takie problemy, spróbuj użyć wdrożenia częściowego.

Wycofaj wdrożenie

Możesz wycofać wdrożenie Firebase Hosting na stronie Firebase Hosting projektu, wybierając działanie Wycofaj dla wybranej wersji.

Nie można przywrócić poprzedniej wersji Security Rules w przypadku Firebase Realtime Database, Cloud Storage for Firebase ani Cloud Firestore.

Dokumentacja poleceń

W tej sekcji opisano dostępne polecenia w przypadku tych zastosowań i usług:

• Polecenia administracyjne interfejsu wiersza poleceń
• Polecenia zarządzania projektami
• Wdrażanie i lokalne programowanie
• Polecenia App Distribution
• Polecenia App Hosting
• Polecenia Authentication (zarządzanie użytkownikami)
• Polecenia Cloud Firestore
• Polecenia Cloud Functions for Firebase
• Polecenia Crashlytics
• Polecenia Extensions
• Polecenia wydawcy Extensions
• Polecenia Hosting
• Polecenia Realtime Database
• Polecenia Remote Config
• Polecenia SQL Connect

Uwaga: kolumna „Polecenie” zawiera wymagane lub zalecane argumenty i flagi dla każdego polecenia, przy czym opcjonalne argumenty są podane w nawiasach kwadratowych ([...]). Kolumna „Opis” zawiera szczegółowe informacje o poleceniu oraz dodatkowe opcjonalne flagi.

Uruchom dowolne polecenie z --help, aby zobaczyć wszystkie wymagane i opcjonalne argumenty oraz dostępne flagi (i ich wartości domyślne).

Polecenia administracyjne interfejsu wiersza poleceń

Polecenie	Opis
help	Wyświetl informacje o interfejsie wiersza poleceń lub konkretnych poleceniach.
init	Powiąż i skonfiguruj nowy projekt w Firebase w bieżącym katalogu. To polecenie tworzy plik konfiguracji firebase.json w bieżącym katalogu.
login	Uwierzytelnij interfejs wiersza poleceń za pomocą konta Google. Wymaga dostępu do przeglądarki. Aby zalogować się w interfejsie wiersza poleceń w środowiskach zdalnych, które nie zezwalają na dostęp do localhost, użyj flagi --no-localhost.
login:ci	Wycofano. Zamiast tego użyj domyślnego uwierzytelniania aplikacji z kontem usługi Google Cloud (GOOGLE_APPLICATION_CREDENTIALS). Wygeneruj token uwierzytelniania do użycia w środowiskach nieinteraktywnych.
login:add	Zaloguj się na dodatkowe konto Google.
login:list	Wyświetl listę wszystkich uwierzytelnionych kont Google.
login:use \ EMAIL_ADDRESS	Ustaw aktywne konto Google.
logout	Wyloguj się z konta Google w interfejsie wiersza poleceń.
open	Otwórz przeglądarkę, aby wyświetlić powiązane zasoby projektu.
projects:list	Wyświetl listę wszystkich projektów w Firebase, do których masz dostęp.
use	Ustaw aktywny projekt w Firebase dla interfejsu wiersza poleceń. Dowiedz się więcej o zarządzaniu aliasami projektów.

Polecenia zarządzania projektami

Polecenie	Opis
Zarządzanie projektami w Firebase
projects:addfirebase	Dodaj konfiguracje Firebase i włącz usługi Firebase w istniejącym projekcie Google Cloud.
projects:create	Utwórz nowy projekt Google Cloud, a następnie dodaj do niego konfiguracje Firebase i włącz w nim usługi Firebase.
projects:list	Wyświetl listę wszystkich projektów w Firebase, do których masz dostęp.
Zarządzanie aplikacjami w Firebase (iOS, Android, internet)
apps:create	Utwórz nową aplikację w Firebase.
apps:list	Wyświetl listę wszystkich zarejestrowanych aplikacji w Firebase w aktywnym projekcie w Firebase.
apps:sdkconfig \ [PLATFORM] \ [FIREBASE_APP_ID]	Wydrukuj konfigurację Firebase określonej aplikacji w Firebase. PLATFORM może mieć wartość IOS, ANDROID lub WEB (wielkość liter nie jest rozróżniana). Jeśli go pominiesz, interfejs wiersza poleceń poprosi Cię o wybranie aplikacji z wyświetlonej listy wszystkich aplikacji w Firebase w aktywnym projekcie w Firebase. Jeśli aktywny projekt w Firebase ma tylko jedną aplikację w Firebase, interfejs wiersza poleceń automatycznie wybierze tę aplikację. FIREBASE_APP_ID to identyfikator aplikacji w Firebase (wymaga wcześniejszego określenia PLATFORM). Jeśli go pominiesz, interfejs wiersza poleceń automatycznie wybierze aplikację, jeśli tylko jedna pasuje, lub poprosi Cię o wybranie aplikacji, jeśli pasuje ich więcej. Jeśli interfejs wiersza poleceń działa w trybie nieinteraktywnym: Jeśli aktywny projekt w Firebase ma tylko 1 aplikację w Firebase, możesz pominąć zarówno PLATFORM, jak i FIREBASE_APP_ID. Jeśli aktywny projekt w Firebase zawiera wiele aplikacji w Firebase, musisz określić PLATFORM (oraz FIREBASE_APP_ID, jeśli projekt w Firebase zawiera więcej niż 1 aplikację w Firebase tego typu). To polecenie obsługuje tę opcjonalną flagę: -o lub --out [FILENAME] Zapisz dane wyjściowe konfiguracji w pliku zamiast w standardowym strumieniu wyjścia. Jeśli parametr FILENAME zostanie pominięty, domyślnie zostanie użyta nazwa pliku dla danej platformy (GoogleService-Info.plist w przypadku iOS, google-services.json w przypadku Androida lub firebase-js-config.json w przypadku przeglądarki). Jeśli plik docelowy już istnieje, interfejs wiersza poleceń poprosi o potwierdzenie zastąpienia (lub zakończy się niepowodzeniem w trybie nieinteraktywnym).
zarządzanie skrótami certyfikatów SHA (tylko Android);
apps:android:sha:create \ FIREBASE_ANDROID_APP_ID \ SHA_HASH	Dodaj określony skrót certyfikatu SHA do określonej aplikacji Firebase na Androida.
apps:android:sha:delete \ FIREBASE_ANDROID_APP_ID \ SHA_ID	Usuwa określony certyfikat SHA (identyfikowany przez SHA_ID z apps:android:sha:list) z określonej aplikacji Firebase na Androida.
apps:android:sha:list \ FIREBASE_ANDROID_APP_ID	Wyświetla listę wszystkich skrótów certyfikatów SHA dla określonej aplikacji Firebase na Androida.

Wdrażanie i lokalne środowisko programistyczne

Te polecenia umożliwiają wdrażanie projektu w Firebase i interakcję z nim.

Polecenie	Opis
deploy	Wdróż kod i zasoby z katalogu projektu w aktywnym projekcie w Firebase. To polecenie wymaga pliku konfiguracji firebase.json w katalogu projektu. Dowiedz się więcej o wdrażaniu w projekcie w Firebase.
serve	Uruchom serwer lokalny, aby przetestować konfigurację Firebase Hosting lub lokalny protokół HTTP Cloud Functions (np. za pomocą --only hosting lub --only functions). To polecenie wymaga pliku konfiguracji firebase.json w katalogu projektu. Dowiedz się więcej o wyświetlaniu i testowaniu lokalnym.

Polecenia: App Distribution

Polecenie	Opis
appdistribution:distribute \ RELEASE_BINARY_FILE \ --app FIREBASE_APP_ID	Prześlij określony plik binarny wersji (.apk, .aab lub .ipa) i udostępnij go testerom określonej aplikacji Firebase.
appdistribution:testers:add \ [EMAILS...]	Dodaj do aktywnego projektu Firebase co najmniej 1 testera (rozdzielając ich adresy EMAILS spacjami). Jeśli pominiesz właściwość EMAILS, musisz przekazać właściwość --file FILE. To polecenie tylko dodaje testerów, którzy nie są jeszcze w projekcie. Nie usuwa ani nie zastępuje istniejących testerów. To polecenie obsługuje te opcjonalne flagi: --file FILE Podaj ścieżkę do niepustego pliku, w którym adresy e-mail testerów do dodania są rozdzielone przecinkami lub znakami nowego wiersza. Jeśli przekazywane są zarówno parametry EMAILS, jak i --file, pierwszeństwo ma parametr EMAILS. --group-alias GROUP_ALIAS Dodaj też określonych testerów do grupy testerów o identyfikatorze GROUP_ALIAS.
appdistribution:testers:remove \ [EMAILS...]	Usuń testerów (rozdzielonych spacjami EMAILS) z aktywnego projektu w Firebase. Jeśli pominiesz parametr EMAILS, musisz przekazać parametr --file FILE. To polecenie obsługuje te opcjonalne flagi: --file FILE Podaj ścieżkę do pliku z adresami e-mail testerów, które chcesz usunąć. Adresy powinny być rozdzielone przecinkami lub znakami nowego wiersza. (Jeśli przekazywane są zarówno parametry EMAILS, jak i --file, pierwszeństwo ma parametr EMAILS). --group-alias GROUP_ALIAS Usuń określonych testerów tylko z grupy testerów identyfikowanej przez GROUP_ALIAS, zamiast usuwać ich z aktywnego projektu w Firebase.
appdistribution:testers:list	Wyświetl listę testerów w aktywnym projekcie w Firebase.
appdistribution:groups:create \ DISPLAY_NAME \ [GROUP_ALIAS]	Utwórz grupę testerów z określonymi parametrami DISPLAY_NAME i opcjonalnie GROUP_ALIAS. Jeśli pominiesz GROUP_ALIAS, alias zostanie wygenerowany automatycznie na podstawie DISPLAY_NAME.
appdistribution:groups:delete \ GROUP_ALIAS	Usuń grupę testerów o określonym aliasie.
appdistribution:groups:list	Wyświetl listę wszystkich grup testerów w aktywnym projekcie w Firebase.

Polecenia: App Hosting

Polecenie	Opis
apphosting:backends:create \ --backend BACKEND_ID \ --primary-region REGION_NAME \ --app FIREBASE_WEB_APP_ID	Utwórz kolekcję zasobów zarządzanych połączonych z jedną bazą kodu, która obejmuje backend App Hosting. To polecenie obsługuje te opcjonalne (ale zalecane) flagi: --backend BACKEND_ID Podaj identyfikator nowego backendu App Hosting. Jeśli pominiesz tę opcję w trybie interaktywnym, interfejs wiersza poleceń poprosi Cię o podanie identyfikatora backendu. --primary-region REGION_NAME Określ region główny, w którym chcesz utworzyć backend App Hosting. Jeśli pominiesz tę opcję w trybie interaktywnym, interfejs wiersza poleceń poprosi Cię o wybranie lokalizacji. Dowiedz się więcej o lokalizacjach obsługiwanych przez App Hosting. -a lub --app FIREBASE_WEB_APP_ID Określ identyfikator aplikacji istniejącej aplikacji internetowej w Firebase. Jeśli go pominiesz, interfejs wiersza poleceń automatycznie utworzy i powiąże nową aplikację internetową w Firebase o nazwie BACKEND_ID (chyba że projekt osiągnął limit aplikacji w Firebase). To polecenie obsługuje też te opcjonalne flagi: --root-dir ROOT_DIR Określ katalog główny aplikacji względem repozytorium. Jeśli pominiesz tę opcję w trybie interaktywnym, interfejs wiersza poleceń poprosi o podanie katalogu (domyślnie /). -s lub --service-account SERVICE_ACCOUNT Określ konto usługi używane do uruchamiania serwera. Jeśli zostanie pominięte, domyślnie używane jest domyślne konto usługi Compute App Hosting. Jeśli interfejs wiersza poleceń działa w trybie nieinteraktywnym, wymagane są zarówno --backend, jak i --primary-region.
apphosting:backends:get \ BACKEND_ID	Pobierz szczegóły, w tym publiczny adres URL, określonego backendu App Hosting. Jeśli wiele regionów zawiera backend z określonym BACKEND_ID, interfejs wiersza poleceń rejestruje ostrzeżenie i wyświetla pierwszy pasujący backend (pamiętaj, że to polecenie nie obsługuje flagi --location).
apphosting:backends:list	Wyświetl listę wszystkich aktywnych backendów App Hosting w aktywnym projekcie w Firebase.
apphosting:backends:delete \ BACKEND_ID	Usuń określony backend App Hosting. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force. Jeśli wiele regionów zawiera backend z określonym BACKEND_ID, interfejs wiersza poleceń wyświetli w trybie interaktywnym prośbę o wybranie backendów do usunięcia i zakończy się niepowodzeniem, jeśli przekazano -f lub --force (pamiętaj, że to polecenie nie obsługuje flagi --location).
apphosting:rollouts:create \ BACKEND_ID	Utwórz ręcznie uruchamiane wdrażanie dla określonego backendu App Hosting. To polecenie obsługuje te opcjonalne, wykluczające się wzajemnie flagi. Jeśli nie podasz żadnej z tych wartości, interfejs wiersza poleceń poprosi Cię o wybranie gałęzi z listy. W trybie nieinteraktywnym musisz podać jedną z tych flag. -b lub --git-branch BRANCH_NAME Wdróż najnowszy commit w określonej gałęzi Git. -g lub --git-commit COMMIT_ID Wdróż określone zatwierdzenie Git. Jeśli wiele regionów zawiera backend z określonym BACKEND_ID, to polecenie nie powiedzie się zarówno w trybie interaktywnym, jak i nieinteraktywnym (pamiętaj, że to polecenie nie obsługuje flagi --location).
apphosting:secrets:set \ SECRET_NAME \ --data-file DATA_FILE_PATH	Utwórz lub zaktualizuj obiekt tajny w Google Cloud Secret Manager za pomocą określonego SECRET_NAME. To polecenie obsługuje tę opcjonalną (ale zalecaną) flagę: --data-file DATA_FILE_PATH Określ ścieżkę, z której mają być odczytywane dane obiektu tajnego, lub ustaw -, aby odczytywać dane obiektu tajnego ze standardowego strumienia wejścia. Jeśli go pominiesz, interfejs wiersza poleceń poprosi Cię o podanie wartości obiektu tajnego (z zamaskowanymi danymi wejściowymi) lub odczyta ją ze standardowego strumienia wejścia, jeśli jest on przekazywany. To polecenie obsługuje też tę opcjonalną flagę: -l lub --location REGION_NAME Podczas tworzenia nowego obiektu tajnego ogranicz jego replikację do określonego regionu Google Cloud Secret Manager. Jeśli zostanie pominięty, Google Cloud Secret Manager używa automatycznej replikacji globalnej. (Zasad replikacji nie można zmienić w przypadku istniejących obiektów tajnych). Jeśli interfejs wiersza poleceń działa w trybie nieinteraktywnym, przekaż --data-file DATA_FILE_PATH (lub prześlij wartość obiektu tajnego do standardowego strumienia wejścia).
apphosting:secrets:grantaccess \ SECRET_NAME	Przyznaj uprawnienia do określonych obiektów tajnych zestawowi adresów e-mail użytkowników lub grup albo kontu usługi backendu. Następnie App Hosting może uzyskać dostęp do obiektów tajnych podczas kompilacji lub działania. Możesz przekazać co najmniej 1 wartość SECRET_NAME, rozdzielając je przecinkami. Musisz określić --emails lub --backend (te 2 flagi wykluczają się wzajemnie). Przyznaj dostęp do zbioru adresów e-mail użytkowników lub grup: -e lub --emails EMAILS Podaj rozdzieloną przecinkami listę adresów e-mail użytkowników lub grup, którym należy przyznać dostęp do określonych obiektów tajnych. Przyznaj dostęp do konta usługi backendu: -b lub --backend BACKEND_ID Określ backend App Hosting, którego konto usługi powinno mieć dostęp do określonych obiektów tajnych. -l lub --location REGION_NAME Określ region backendu App Hosting. Jeśli go pominiesz, interfejs wiersza poleceń wyszuka pasującą usługę BACKEND_ID we wszystkich regionach. Jeśli wiele regionów zawiera backend o tym identyfikatorze, interfejs wiersza poleceń poprosi Cię o wybranie jednego z nich w trybie interaktywnym (w trybie nieinteraktywnym parametr --location jest wymagany).
apphosting:secrets:revokeaccess \ SECRET_NAME	Anuluj uprawnienia do określonych obiektów tajnych dla zestawu adresów e-mail użytkowników lub grup albo dla konta usługi backendu. Możesz przekazać co najmniej 1 wartość SECRET_NAME, rozdzielając je przecinkami. Musisz określić --emails lub --backend (te 2 flagi wykluczają się wzajemnie). Anulowanie dostępu dla zbioru adresów e-mail użytkowników lub grup: -e lub --emails EMAILS Podaj rozdzieloną przecinkami listę adresów e-mail użytkowników lub grup, którym chcesz odebrać dostęp do określonych obiektów tajnych. Anuluj dostęp do konta usługi backendu: -b lub --backend BACKEND_ID Określ backend App Hosting, którego konto usługi powinno mieć odebrany dostęp do określonych obiektów tajnych. -l lub --location REGION_NAME Określ region backendu App Hosting. Jeśli go pominiesz, interfejs wiersza poleceń wyszuka pasującą usługę BACKEND_ID we wszystkich regionach. Jeśli wiele regionów zawiera backend o tym identyfikatorze, interfejs wiersza poleceń poprosi Cię o wybranie jednego z nich w trybie interaktywnym (w trybie nieinteraktywnym parametr --location jest wymagany).
apphosting:secrets:describe \ SECRET_NAME	Pobierz metadane i wersje dla określonej nazwy obiektu tajnego.
apphosting:secrets:access \ SECRET_NAME[@VERSION]	Uzyskiwanie dostępu do wartości obiektu tajnego o określonej nazwie i wersji. Jeśli pominiesz [@VERSION], domyślnie uzyskasz dostęp do najnowszej wersji.

Polecenia Authentication (zarządzanie użytkownikami)

Polecenie	Opis
auth:export \ DATA_FILE	Eksportuj konta użytkowników aktywnego projektu w Firebase do pliku JSON lub CSV. Więcej informacji znajdziesz na stronie „auth:import i auth:export”.
auth:import \ DATA_FILE	Zaimportuj konta użytkowników z pliku JSON lub CSV do aktywnego projektu w Firebase. Więcej informacji znajdziesz na stronie „auth:import i auth:export”.

Polecenia: Cloud Firestore

Polecenie	Opis
firestore:locations	Wyświetl listę dostępnych lokalizacji instancji bazy danych Cloud Firestore w aktywnym projekcie w Firebase. Dowiedz się więcej o dostępnych lokalizacjach w przypadku wersji Standard, Enterprise i zgodności z MongoDB.
firestore:databases:create \ DATABASE_ID \ --location REGION_NAME	Utwórz określoną instancję bazy danych Cloud Firestore (w trybie natywnym) w określonej lokalizacji. Uruchom firebase firestore:locations, aby wyświetlić listę dostępnych lokalizacji dla REGION_NAME. To polecenie obsługuje te opcjonalne flagi: --delete-protection DELETION_PROTECTION_STATE Zezwalaj na usunięcie określonej instancji bazy danych Cloud Firestore lub je uniemożliwiaj. Prawidłowe wartości to ENABLED i DISABLED. Jeśli zostanie pominięty, domyślnie używana jest wartość DISABLED. --point-in-time-recovery PITR_STATE Określ, czy odzyskiwanie do określonego momentu jest włączone dla określonej instancji bazy danych Cloud Firestore. Prawidłowe wartości to ENABLED i DISABLED. Jeśli zostanie pominięty, domyślnie używana jest wartość DISABLED. --edition EDITION Ustaw wersję określonej instancji bazy danych Cloud Firestore. Prawidłowe wartości to standard i enterprise. Jeśli zostanie pominięty, domyślnie używana jest wartość standard. --firestore-data-access ENABLEMENT_STATE (Tylko wersja Enterprise) Kontroluj dostępność interfejsu API Cloud Firestore. Prawidłowe wartości to ENABLED i DISABLED. Jeśli zostanie pominięty, domyślnie używana jest wartość ENABLED (jednak gdy --mongodb-compatible-data-access to ENABLED, domyślnie używana jest wartość DISABLED). --mongodb-compatible-data-access ENABLEMENT_STATE (tylko wersja Enterprise) Kontroluj dostępność interfejsu API zgodnego z MongoDB. Prawidłowe wartości to ENABLED i DISABLED. Jeśli zostanie pominięty, domyślnie używana jest wartość DISABLED. --realtime-updates ENABLEMENT_STATE (Tylko wersja Enterprise) Włącz lub wyłącz funkcję „Obserwuj” (w czasie rzeczywistym). Prawidłowe wartości to ENABLED i DISABLED. Jeśli zostanie pominięty, domyślnie używana jest wartość ENABLED, gdy --firestore-data-access to ENABLED (w przeciwnym razie używana jest wartość domyślna serwera). Ustawienie tej flagi wymaga, aby --firestore-data-access miało wartość ENABLED.
firestore:databases:list	Wyświetl listę wszystkich instancji bazy danych Cloud Firestore w aktywnym projekcie w Firebase.
firestore:databases:get \ [DATABASE_ID]	Pobierz konfigurację bazy danych dla określonej instancji bazy danych Cloud Firestore. Jeśli parametr DATABASE_ID zostanie pominięty, domyślnie używana jest domyślna instancja bazy danych Cloud Firestore aktywnego projektu Firebase. Tabela zawiera Edition wszystkich baz danych. Pola stanu dostępu do danych przedsiębiorstwa i aktualizacji w czasie rzeczywistym są uwzględniane w nieprzetworzonych danych wyjściowych JSON tylko wtedy, gdy przekazywany jest parametr --json.
firestore:databases:update \ DATABASE_ID	Zaktualizuj konfigurację bazy danych określonej instancji bazy danych Cloud Firestore. Wymagana jest co najmniej 1 flaga (pominięte flagi zachowują bieżące ustawienia). To polecenie obsługuje te flagi: --delete-protection DELETION_PROTECTION_STATE Zezwalaj na usunięcie określonej instancji bazy danych Cloud Firestore lub je uniemożliwiaj. Prawidłowe wartości to ENABLED i DISABLED. --point-in-time-recovery PITR_STATE Określ, czy odzyskiwanie do określonego momentu jest włączone dla określonej instancji bazy danych Cloud Firestore. Prawidłowe wartości to ENABLED i DISABLED.
firestore:databases:delete \ DATABASE_ID	Usuń określoną instancję bazy danych Cloud Firestore. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż flagę --force. (W przeciwieństwie do innych poleceń firestore:databases:delete nie obsługuje skrótu -f).
firestore:indexes	Wyświetl listę wszystkich indeksów instancji bazy danych Cloud Firestore. To polecenie obsługuje tę opcjonalną flagę: --database DATABASE_ID Określ instancję bazy danych Cloud Firestore, dla której chcesz wyświetlić listę indeksów. Jeśli go pominiesz, zostaną wyświetlone indeksy domyślnej instancji bazy danych Cloud Firestore aktywnego projektu w Firebase.
firestore:delete \ [PATH]	Usuń dokumenty w określonej ścieżce bazy danych (PATH) z instancji bazy danych Cloud Firestore. Właściwość PATH jest wymagana, chyba że przekazano --all-collections. Usunięcie kolekcji lub dokumentu, który ma podkolekcje, nie powiedzie się, chyba że zostanie przekazany parametr -r/--recursive lub --shallow. Pamiętaj, że usuwanie danych Cloud Firestore za pomocą interfejsu wiersza poleceń wiąże się z kosztami odczytu i usunięcia. Więcej informacji znajdziesz w artykule Informacje o płatnościach za Cloud Firestore. To polecenie obsługuje te opcjonalne flagi: --database DATABASE_ID Określ bazę danych Cloud Firestore, z której mają zostać usunięte dokumenty. Jeśli zostanie pominięty, dokumenty zostaną usunięte z domyślnej instancji bazy danych Cloud Firestore aktywnego projektu w Firebase. --all-collections Usuń wszystkie kolekcje w bazie danych. (Nie przekazuj PATH, gdy używasz tej flagi). -r lub --recursive Rekurencyjnie usuń wszystkie dokumenty i podkolekcje w określonej ścieżce. (Nie można przekazać z parametrem --shallow). --shallow Usuń tylko dokumenty na określonym poziomie i zignoruj dokumenty w podkolekcjach. Pamiętaj, że może to spowodować osierocenie dokumentów zagnieżdżonych. (Nie można przekazać z parametrem -r ani --recursive). Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.

Polecenia: Cloud Functions for Firebase

Więcej informacji znajdziesz w dokumentacji konfiguracji środowiska.

Polecenie	Opis
functions:config:export	Wyeksportuj starszą konfigurację środowiska wykonawczego functions.config() aktywnego projektu w Firebase jako pojedynczy obiekt tajny JSON w Google Cloud Secret Manager (do użycia z defineJsonSecret). To polecenie obsługuje te opcjonalne flagi: --secret SECRET_NAME Podaj nazwę obiektu tajnego, który chcesz utworzyć lub zaktualizować w Google Cloud Secret Manager. Jeśli pominiesz tę opcję, interfejs wiersza poleceń poprosi Cię o podanie nazwy (domyślnie FUNCTIONS_CONFIG_EXPORT). -f lub --force Użyj domyślnej nazwy obiektu tajnego (FUNCTIONS_CONFIG_EXPORT) bez wyświetlania prośby i dodaj nową wersję obiektu tajnego bez potwierdzenia, jeśli obiekt tajny już istnieje. (wymagane do dodania nowej wersji do istniejącego obiektu tajnego w trybie nieinteraktywnym).
functions:delete \ FUNCTION_NAME...	Usuń co najmniej 1 określoną funkcję z aktywnego projektu w Firebase. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.
functions:list	Wyświetl listę wszystkich wdrożonych funkcji w aktywnym projekcie w Firebase.
functions:log	Odczytywanie logów ze wszystkich wdrożonych Cloud Functions w aktywnym projekcie w Firebase.
functions:secrets:access \ SECRET_NAME[@VERSION]	Uzyskiwanie dostępu do wartości obiektu tajnego o określonej nazwie i wersji. Jeśli pominiesz [@VERSION], domyślnie uzyskasz dostęp do najnowszej wersji.
functions:secrets:destroy \ SECRET_NAME[@VERSION]	Zniszcz określony obiekt tajny w określonej wersji. Jeśli pominiesz parametr [@VERSION], domyślnie zostanie zniszczona najnowsza wersja. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie, która jest automatycznie potwierdzana w trybie nieinteraktywnym bez -f ani --force. Jeśli jednak obiekt tajny jest nadal powiązany z aktywnymi punktami końcowymi funkcji, musisz przekazać -f lub --force, aby go zniszczyć.
functions:secrets:get \ SECRET_NAME	Pobierz metadane i wersje dla określonej nazwy obiektu tajnego.
functions:secrets:prune	Zniszcz wszystkie nieużywane obiekty tajne w aktywnym projekcie w Firebase.
functions:secrets:set \ SECRET_NAME	Utwórz lub zaktualizuj określony obiekt tajny.
functions:shell	Uruchom lokalną interaktywną powłokę do testowania funkcji.
functions:config:clone \ --from PROJECT_ID	Wycofano. Sklonuj środowisko innego projektu do aktywnego projektu w Firebase. Domyślnie jest wyłączona. Aby użyć tego polecenia, najpierw uruchom firebase experiments:enable legacyRuntimeConfigCommands.
functions:config:get	Wycofano. Pobierz istniejące wartości konfiguracji aktywnego projektu w Firebase Cloud Functions.
functions:config:set \ KEY=VALUE...	Wycofano. Przechowuj wartości konfiguracji środowiska wykonawczego aktywnego projektu Cloud Functions w Firebase. Domyślnie jest wyłączona. Aby użyć tego polecenia, najpierw uruchom firebase experiments:enable legacyRuntimeConfigCommands.
functions:config:unset \ KEY...	Wycofano. Usuń wartości z konfiguracji środowiska wykonawczego aktywnego projektu w Firebase. Domyślnie jest wyłączona. Aby użyć tego polecenia, najpierw uruchom firebase experiments:enable legacyRuntimeConfigCommands.

Polecenia: Crashlytics

Polecenie	Opis
crashlytics:mappingfile:generateid \ --resource-file PATH/TO/ANDROID_RESOURCE.XML	Wygeneruj unikalny identyfikator pliku mapowania w określonym pliku zasobów Androida (XML).
crashlytics:mappingfile:upload \ --app FIREBASE_APP_ID \ --resource-file PATH/TO/ANDROID_RESOURCE.XML \ PATH/TO/MAPPING_FILE.TXT	Prześlij plik mapowania (TXT) zgodny z ProGuard dla określonej aplikacji Firebase i powiąż go z identyfikatorem pliku mapowania zadeklarowanym w określonym pliku zasobów Androida (XML).
crashlytics:symbols:upload \ --app FIREBASE_APP_ID \ PATH/TO/SYMBOLS...	Wygeneruj plik symboli zgodny z Crashlytics na potrzeby awarii biblioteki natywnej na Androida (np. Android NDK lub kompilacji Unity lub Flutter na Androida) i prześlij go na serwery Firebase. To polecenie obsługuje tylko Androida. W przypadku plików dSYM na iOS użyj skryptu upload-symbols z pakietu SDK Apple.

Polecenia: Extensions

Polecenie	Opis
ext	Wyświetl informacje o tym, jak używać poleceń Firebase Extensions. Wyświetl listę instancji rozszerzeń zainstalowanych w aktywnym projekcie.
ext:configure \ EXTENSION_INSTANCE_ID	Ponownie skonfiguruj wartości parametrów instancji rozszerzenia w pliku manifestu rozszerzenia.
ext:info \ PUBLISHER_ID/EXTENSION_ID	Wydrukuj szczegółowe informacje o rozszerzeniu.
ext:install \ PUBLISHER_ID/EXTENSION_ID	Dodaj nowe wystąpienie rozszerzenia do pliku manifestu rozszerzenia.
ext:sdk:install \ EXTENSION_NAME	Zainstaluj pakiety SDK do definiowania rozszerzeń w funkcjach.
ext:list	Wyświetl listę wszystkich instancji rozszerzeń zainstalowanych w projekcie w Firebase. Wydrukuj identyfikator instancji dla każdego rozszerzenia.
ext:uninstall \ EXTENSION_INSTANCE_ID	Usuń instancję rozszerzenia z pliku manifestu rozszerzenia.
ext:update \ EXTENSION_INSTANCE_ID \ [UPDATE_SOURCE]	Zaktualizuj instancję rozszerzenia do najnowszej wersji (lub do określonej opublikowanej wersji UPDATE_SOURCE) w pliku manifestu rozszerzenia. Pamiętaj, że w przypadku UPDATE_SOURCE ścieżki lokalne i adresy URL nie są obsługiwane. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Możesz przekazać -f lub --force, aby pominąć ten komunikat w trybie interaktywnym. Jednak ext:update to polecenie tylko interaktywne i nie jest obsługiwane w trybie nieinteraktywnym, nawet z -f lub --force.
ext:export	Wyeksportuj wszystkie zainstalowane instancje rozszerzeń z projektu do pliku manifestu rozszerzenia.

Extensions polecenia wydawcy

Polecenie	Opis
ext:dev:init	Zainicjuj szkielet bazy kodu dla nowego rozszerzenia w bieżącym katalogu.
ext:dev:list \ PUBLISHER_ID	Wydrukuj listę wszystkich rozszerzeń przesłanych przez wydawcę.
ext:dev:register	Wyłączono. Rejestrowanie nowych identyfikatorów profili wydawców nie jest już obsługiwane.
ext:dev:deprecate \ PUBLISHER_ID/EXTENSION_ID \ [VERSION_PREDICATE]	Wycofaj wersje rozszerzenia, które pasują do predykatu wersji. Predykat wersji może być pojedynczą wersją (np. 1.0.0) lub zakresem wersji (np. >1.0.0). Jeśli nie podano predykatu wersji, wycofywane są wszystkie wersje tego rozszerzenia.
ext:dev:undeprecate \ PUBLISHER_ID/EXTENSION_ID \ VERSION_PREDICATE	Cofnij wycofanie wersji rozszerzenia, które pasują do predykatu wersji. Predykat wersji może być pojedynczą wersją (np. 1.0.0) lub zakresem wersji (np. >1.0.0).
ext:dev:upload \ PUBLISHER_ID/EXTENSION_ID	Prześlij nową wersję rozszerzenia.
ext:dev:usage \ PUBLISHER_ID	Wyświetlaj liczbę instalacji i wskaźniki wykorzystania rozszerzeń przesłanych przez wydawcę.

Polecenia: Hosting

Polecenie	Opis
hosting:disable	Zatrzymaj obsługę ruchu Firebase Hosting w witrynie Hosting. Po uruchomieniu tego polecenia adres URL Hosting witryny będzie wyświetlać komunikat „Nie znaleziono witryny”. To polecenie obsługuje tę opcjonalną flagę: --site SITE_ID Określ witrynę Hosting, którą chcesz wyłączyć. Jeśli zostanie pominięty, domyślnie używana jest domyślna witryna Hosting aktywnego projektu Firebase. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.
Zarządzanie witrynami Hosting
hosting:sites:create \ [SITE_ID]	Utwórz nową witrynę Hosting, używając określonego SITE_ID. Jeśli interfejs wiersza poleceń działa w trybie nieinteraktywnym, wymagany jest parametr SITE_ID. To polecenie obsługuje tę opcjonalną flagę: --app FIREBASE_APP_ID Określ istniejącą aplikację internetową Firebase, którą chcesz powiązać z nową witryną Hosting.
hosting:sites:delete \ SITE_ID	Usuń określoną witrynę Hosting. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.
hosting:sites:get \ SITE_ID	Pobierz szczegółowe informacje o określonej witrynie Hosting. Tabela wyjściowa zawiera identyfikator witryny, domyślny adres URL i identyfikator aplikacji internetowej Firebase (jeśli jest połączona). Dodatkowe metadane (np. czy witryna jest DEFAULT_SITE czy USER_SITE) są uwzględniane w nieprzetworzonych danych wyjściowych JSON tylko wtedy, gdy przekazywany jest parametr --json.
hosting:sites:list	Wyświetl listę wszystkich witryn Hosting w aktywnym projekcie w Firebase.
Zarządzanie kanałami podglądu
hosting:channel:create \ [CHANNEL_ID]	Utwórz nowy kanał podglądu dla witryny Hosting, używając określonego CHANNEL_ID. To polecenie nie powoduje wdrożenia na kanale. Jeśli interfejs wiersza poleceń działa w trybie nieinteraktywnym, wymagany jest parametr CHANNEL_ID. To polecenie obsługuje tę opcjonalną flagę: --site SITE_ID Określ witrynę Hosting, w której chcesz utworzyć kanał podglądu. Jeśli zostanie pominięty, domyślnie używana jest domyślna witryna Hosting aktywnego projektu Firebase.
hosting:channel:delete \ CHANNEL_ID	Usuń określony kanał podglądu. Nie możesz usunąć kanału na żywo witryny. To polecenie obsługuje tę opcjonalną flagę: --site SITE_ID Określ witrynę Hosting, z której chcesz usunąć kanał podglądu. Jeśli zostanie pominięty, domyślnie używana jest domyślna witryna Hosting aktywnego projektu Firebase. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.
hosting:channel:deploy \ CHANNEL_ID	Wdróż treści i konfigurację Hosting na określonym kanale podglądu. Jeśli kanał podglądu jeszcze nie istnieje, to polecenie utworzy go w witrynie Hosting przed wdrożeniem. To polecenie obsługuje tę opcjonalną flagę: --only TARGETS Podaj rozdzieloną przecinkami listę celów Hosting skonfigurowanych w firebase.json, które mają zostać wdrożone w kanale podglądu. Jeśli pominiesz tę opcję, wdrożenie nastąpi we wszystkich witrynach Hosting skonfigurowanych w firebase.json.
hosting:channel:list	Wyświetl listę wszystkich kanałów (w tym kanału „live”) w witrynie Hosting. To polecenie obsługuje tę opcjonalną flagę: --site SITE_ID Określ witrynę Hosting, dla której chcesz wyświetlić listę kanałów. Jeśli zostanie pominięty, domyślnie używana jest domyślna witryna Hosting aktywnego projektu Firebase.
hosting:channel:open \ [CHANNEL_ID]	Otwórz w przeglądarce adres URL określonego kanału lub zwróć adres URL, jeśli otwarcie w przeglądarce nie jest możliwe. Jeśli interfejs wiersza poleceń działa w trybie nieinteraktywnym, wymagany jest parametr CHANNEL_ID. To polecenie obsługuje tę opcjonalną flagę: --site SITE_ID Określ witrynę Hosting dla kanału podglądu. Jeśli zostanie pominięty, domyślnie używana jest domyślna witryna Hosting aktywnego projektu Firebase.
Klonowanie wersji
hosting:clone \ SOURCE_SITE_ID:SOURCE_CHANNEL_ID \ TARGET_SITE_ID:TARGET_CHANNEL_ID	Sklonuj ostatnio wdrożoną wersję z określonego kanału „źródłowego” do określonego kanału „docelowego”. To polecenie wdraża też aplikację w określonym kanale „docelowym”. Jeśli kanał „target” jeszcze nie istnieje, to polecenie utworzy nowy kanał podglądu w witrynie „target” Hosting przed wdrożeniem w kanale.
hosting:clone \ SOURCE_SITE_ID@VERSION_ID \ TARGET_SITE_ID:TARGET_CHANNEL_ID	Sklonuj określoną wersję do określonego kanału „docelowego”. To polecenie wdraża też aplikację na określonym kanale „docelowym”. Jeśli kanał „target” jeszcze nie istnieje, to polecenie utworzy nowy kanał podglądu w witrynie „target” Hosting przed wdrożeniem w kanale. VERSION_ID znajdziesz w panelu Hosting w konsoli Firebase.

Polecenia: Realtime Database

Pamiętaj, że początkową, domyślną instancję Realtime Database możesz utworzyć w konsoli Firebase lub za pomocą ogólnego przepływu pracy firebase init albo konkretnego przepływu firebase init database.

Po utworzeniu instancji możesz nimi zarządzać zgodnie z opisem w artykule Zarządzanie konkretnymi instancjami i interakcja z nimi za pomocą interfejsu wiersza poleceń.

Polecenie	Opis
database:get \ PATH	Pobierz dane z określonej lokalizacji bazy danych (PATH) dla instancji Realtime Database i wyświetl je w formacie JSON. Obsługuje zapytania dotyczące zindeksowanych danych. To polecenie obsługuje tę opcjonalną flagę: --instance DATABASE_NAME Określ instancję Realtime Database dla działania. Jeśli zostanie pominięty, domyślnie używana jest domyślna instancja Realtime Database aktywnego projektu w Firebase.
database:instances:create \ DATABASE_NAME \ --location REGION_NAME	Utwórz instancję Realtime Database z określonym DATABASE_NAME w określonej lokalizacji. To polecenie obsługuje tę opcjonalną (ale zalecaną) flagę: --location REGION_NAME Lokalizacja instancji Realtime Database. Dowiedz się więcej o lokalizacjach obsługiwanych przez Realtime Database. Jeśli zostanie pominięty, domyślnie używana jest wartość us-central1. Nie możesz użyć tego polecenia, aby utworzyć domyślną instancję Realtime Database w aktywnym projekcie w Firebase. Jeśli projekt nie zawiera żadnych instancji Realtime Database, pojawi się prośba o uruchomienie procesu firebase init, aby utworzyć pierwszą instancję Realtime Database projektu (instancję domyślną).
database:instances:list	Wyświetl listę wszystkich instancji Realtime Database w aktywnym projekcie w Firebase. To polecenie obsługuje tę opcjonalną flagę: --location REGION_NAME Aby wyświetlić listę instancji Realtime Database, podaj konkretną lokalizację. Dostępne nazwy regionów znajdziesz w artykule na temat lokalizacji Realtime Database.
database:profile	Utwórz profil operacji dla instancji Realtime Database. Więcej informacji znajdziesz w artykule o typach operacji Realtime Database. To polecenie obsługuje tę opcjonalną flagę: --instance DATABASE_NAME Określ instancję Realtime Database dla działania. Jeśli zostanie pominięty, domyślnie używana jest domyślna instancja Realtime Database aktywnego projektu w Firebase.
database:push \ PATH \ [INFILE]	Przekaż nowe dane do listy w określonej lokalizacji bazy danych (PATH) w instancji Realtime Database. Pobiera dane wejściowe z pliku (INFILE), STDIN lub flagi -d (--data). To polecenie obsługuje tę opcjonalną flagę: --instance DATABASE_NAME Określ instancję Realtime Database dla działania. Jeśli zostanie pominięty, domyślnie używana jest domyślna instancja Realtime Database aktywnego projektu w Firebase.
database:remove \ PATH	Usuń wszystkie dane w określonej lokalizacji bazy danych (PATH) w instancji Realtime Database. To polecenie obsługuje tę opcjonalną flagę: --instance DATABASE_NAME Określ instancję Realtime Database dla działania. Jeśli zostanie pominięty, domyślnie używana jest domyślna instancja Realtime Database aktywnego projektu w Firebase. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.
database:set \ PATH \ [INFILE]	Zastąp wszystkie dane w określonej lokalizacji bazy danych (PATH) w instancji Realtime Database. Pobiera dane wejściowe z pliku (INFILE), STDIN lub flagi -d (--data). To polecenie obsługuje tę opcjonalną flagę: --instance DATABASE_NAME Określ instancję Realtime Database dla działania. Jeśli zostanie pominięty, domyślnie używana jest domyślna instancja Realtime Database aktywnego projektu w Firebase. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.
database:update \ PATH \ [INFILE]	Wykonaj częściową aktualizację w określonej lokalizacji bazy danych (PATH) w instancji Realtime Database. Pobiera dane wejściowe z pliku (INFILE), STDIN lub flagi -d (--data). To polecenie obsługuje tę opcjonalną flagę: --instance DATABASE_NAME Określ instancję Realtime Database dla działania. Jeśli zostanie pominięty, domyślnie używana jest domyślna instancja Realtime Database aktywnego projektu w Firebase. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.

Polecenia: Remote Config

Te polecenia i ich zastosowania zostały szczegółowo opisane w artykule Modyfikowanie Remote Config za pomocą kodu.

Polecenie	Opis
remoteconfig:versions:list	Wyświetl listę wszystkich wersji szablonu Remote Config. To polecenie obsługuje tę opcjonalną flagę: --limit NUMBER_OF_VERSIONS Określ maksymalną liczbę wersji do zwrócenia. Podaj 0, aby zwrócić wszystkie istniejące wersje. Jeśli zostanie pominięty, domyślnie używana jest wartość 10.
remoteconfig:get \ --version-number VERSION_NUMBER	Pobierz szczegóły szablonu Remote Config w określonej wersji. To polecenie obsługuje te opcjonalne (ale zalecane) flagi: -v lub --version-number VERSION_NUMBER Określ wersję szablonu Remote Config, którą chcesz pobrać. Jeśli go pominiesz, domyślnie zostanie użyta najnowsza wersja. -o lub --output FILENAME Zapisuje dane wyjściowe w pliku JSON o określonej nazwie zamiast wyświetlać je w tabeli.
remoteconfig:rollback \ --version-number VERSION_NUMBER	Przywróć szablon Remote Config do określonej poprzedniej wersji. To polecenie obsługuje tę opcjonalną (ale zalecaną) flagę: -v lub --version-number VERSION_NUMBER Określ wersję szablonu Remote Config, do której chcesz przywrócić. Jeśli zostanie pominięty, domyślnie używana jest poprzednia wersja (bieżąca wersja – 1). Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie. Aby pominąć prośbę o potwierdzenie (wymaganą w trybie nieinteraktywnym), przekaż te flagi: -f lub --force.
remoteconfig:experiments:list	Wyświetl listę wszystkich eksperymentów Remote Config w aktywnym projekcie w Firebase. To polecenie obsługuje te opcjonalne flagi: --filter EXPRESSION Określ wyrażenie, aby filtrować eksperymenty. --pageSize NUMBER Określ liczbę eksperymentów do zwrócenia na stronę. Jeśli go pominiesz, domyślnie zostanie użyta wartość 10. --pageToken TOKEN Określ przesunięcie początkowe listy.
remoteconfig:experiments:get \ EXPERIMENT_ID	Pobierz szczegóły określonego eksperymentu Remote Config. Tabela wyjściowa zawiera nazwę zasobu eksperymentu, wyświetlaną nazwę, stan (PENDING, RUNNING, DONE lub EXPIRED), czas rozpoczęcia i zakończenia, warianty (nazwy i wagi przydzielania ruchu) oraz skonfigurowane cele/dane. Opis eksperymentu jest uwzględniany w nieprzetworzonych danych wyjściowych JSON tylko wtedy, gdy przekazywany jest parametr --json.
remoteconfig:experiments:delete \ EXPERIMENT_ID	Usuń określony eksperyment Remote Config. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie i nie obsługuje flagi -f ani --force. W trybie nieinteraktywnym domyślnie potwierdzenie jest ustawione na „nie”, a polecenie kończy działanie bez usuwania eksperymentu.
remoteconfig:rollouts:list	Wyświetl listę wszystkich wdrożeń Remote Config w aktywnym projekcie w Firebase. To polecenie obsługuje te opcjonalne flagi: --filter EXPRESSION Określ wyrażenie do filtrowania wdrożeń. --pageSize NUMBER Określ liczbę wdrożeń do zwrócenia na stronę. Jeśli go pominiesz, domyślnie zostanie użyta wartość 10. --pageToken TOKEN Określ przesunięcie początkowe listy.
remoteconfig:rollouts:get \ ROLLOUT_ID	Pobierz szczegóły określonego wdrożenia Remote Config.
remoteconfig:rollouts:delete \ ROLLOUT_ID	Usuń określone wdrożenie Remote Config. Przed podjęciem działania interfejs wiersza poleceń wyświetla prośbę o potwierdzenie i nie obsługuje flagi -f ani --force. (W trybie nieinteraktywnym domyślnie nie jest wymagane potwierdzenie, a polecenie kończy działanie bez usuwania wdrożenia).

Polecenia: SQL Connect

Te polecenia i ich zastosowania są szczegółowo opisane w przewodniku po interfejsie wiersza poleceń SQL Connect.

Polecenie	Opis
dataconnect:services:list	Wyświetl listę wszystkich wdrożonych usług SQL Connect w aktywnym projekcie Firebase.
dataconnect:sql:diff	Wyświetl różnice między lokalnym schematem SQL Connect a schematem bazy danych Cloud SQL. To polecenie obsługuje te opcjonalne flagi: --service SERVICE_ID Podaj identyfikator usługi SQL Connect. Jeśli zostanie pominięty, używana jest pojedyncza usługa skonfigurowana w firebase.json. Jeśli skonfigurowanych jest wiele usług, polecenie nie powiedzie się, chyba że określisz --service i, w razie potrzeby, --location. --location LOCATION Określ lokalizację usługi SQL Connect. Wymagany tylko wtedy, gdy identyfikator usługi jest używany w wielu lokalizacjach.
dataconnect:sql:migrate	Przenieś schemat bazy danych Cloud SQL, aby pasował do lokalnego schematu SQL Connect. To polecenie obsługuje te opcjonalne flagi: --service SERVICE_ID Podaj identyfikator usługi SQL Connect. Jeśli zostanie pominięty, używana jest pojedyncza usługa skonfigurowana w firebase.json (jeśli skonfigurowano wiele usług, polecenie nie powiedzie się, chyba że określisz --service i, w razie potrzeby, --location). --location LOCATION Określ lokalizację usługi SQL Connect. Wymagany tylko wtedy, gdy identyfikator usługi jest używany w wielu lokalizacjach. W trybie interaktywnym interfejs wiersza poleceń wyświetla prośbę o potwierdzenie przed podjęciem działania. W trybie nieinteraktywnym migracje nieniszczące są uruchamiane automatycznie, a zmiany niszczące są przerywane, chyba że przekażesz -f lub --force (co powoduje też pominięcie próśb o potwierdzenie w trybie interaktywnym).
dataconnect:sql:grant \ --role SQL_ROLE \ --email EMAIL_ADDRESS	Przyznaj określone uprawnienie SQL_ROLE (owner, writer lub reader) określonemu użytkownikowi lub kontu usługi (EMAIL_ADDRESS). To polecenie obsługuje te opcjonalne flagi: --service SERVICE_ID Podaj identyfikator usługi SQL Connect. Jeśli zostanie pominięty, używana jest pojedyncza usługa skonfigurowana w firebase.json (jeśli skonfigurowano wiele usług, polecenie nie powiedzie się, chyba że określisz --service i, w razie potrzeby, --location). --location LOCATION Określ lokalizację usługi SQL Connect. Wymagany tylko wtedy, gdy identyfikator usługi jest używany w wielu lokalizacjach.
dataconnect:sdk:generate	Wygeneruj pakiety SDK z typami dla oprogramowania sprzęgającego SQL Connect. To polecenie obsługuje te opcjonalne flagi: --service SERVICE_ID Podaj identyfikator usługi SQL Connect. Jeśli zostanie pominięty, pakiety SDK zostaną wygenerowane dla wszystkich skonfigurowanych usług. --location LOCATION Określ lokalizację usługi SQL Connect. Wymagany tylko wtedy, gdy identyfikator usługi jest używany w wielu lokalizacjach. --watch Obserwuj zmiany w plikach GQL oprogramowania sprzęgającego i ponownie generuj pakiety SDK, gdy pojawią się aktualizacje.