Riferimento per l'interfaccia a riga di comando di Firebase

Interfaccia a riga di comando Firebase (GitHub) offre una gamma di strumenti per la gestione, la visualizzazione e il deployment nei progetti Firebase.

Prima di utilizzare l'interfaccia a riga di comando di Firebase, configura un progetto Firebase.

Configura o aggiorna l'interfaccia a riga di comando

Installa l'interfaccia a riga di comando Firebase

Puoi installare l'interfaccia a riga di comando Firebase utilizzando un metodo corrispondente alle tue sistema, livello di esperienza e/o caso d'uso. Indipendentemente da come installi interfaccia a riga di comando, puoi accedere alle stesse funzionalità e al comando firebase.

Windows macOS Linux

Windows

Puoi installare l'interfaccia a riga di comando Firebase per Windows utilizzando uno dei seguenti metodi opzioni:

Opzione Descrizione Consigliato per...
programma binario autonomo Scarica il programma binario autonomo per l'interfaccia a riga di comando. Dopodiché potrai accedere l'eseguibile per aprire una shell in cui puoi eseguire Comando firebase. Nuovi sviluppatori

Sviluppatori che non utilizzano o non hanno familiarità con Node.js
npm Utilizza npm (il gestore di pacchetti dei nodi) per installare l'interfaccia a riga di comando e abilitare il comando firebase disponibile a livello globale. Gli sviluppatori che utilizzano Node.js

binario autonomo

Per scaricare ed eseguire il file binario per l'interfaccia a riga di comando di Firebase, segui questi passaggi:

  1. Scarica Programma binario dell'interfaccia a riga di comando Firebase per Windows.

  2. Accedi al file binario per aprire una shell in cui potrai eseguire firebase .

  3. Continua ad accedere e testare l'interfaccia a riga di comando.

npm

Per utilizzare npm (il gestore di pacchetti di nodi) per installare il interfaccia a riga di comando Firebase, segui questi passaggi:

  1. Installa Node.js utilizzando nvm-windows (il gestore della versione dei nodi). L'installazione di Node.js si installa automaticamente gli strumenti di comando npm.

  2. Installa l'interfaccia a riga di comando Firebase tramite npm eseguendo questo comando:

    npm install -g firebase-tools

    Questo comando abilita il comando firebase disponibile a livello globale.

  3. Continua per accedere e testare l'interfaccia a riga di comando.

macOS o Linux

Puoi installare l'interfaccia a riga di comando di Firebase per macOS o Linux utilizzando una delle seguenti opzioni:

Opzione Descrizione Consigliato per...
script di installazione automatica Esegui un singolo comando che rileva automaticamente il tuo sistema operativo, scarica l'ultima release dell'interfaccia a riga di comando, quindi abilita le Comando firebase. Nuovi sviluppatori

Sviluppatori che non utilizzano o non hanno familiarità con Node.js

I deployment automatici in un ambiente CI/CD ambiente
File binario autonomo Scarica il programma binario autonomo per l'interfaccia a riga di comando. Poi potrai configurare ed eseguire il programma binario in base al tuo flusso di lavoro. Flussi di lavoro completamente personalizzabili utilizzando l'interfaccia a riga di comando
npm Utilizza npm (Node Package Manager) per installare l'interfaccia a riga di comando e attivare il comando firebase disponibile a livello globale. Sviluppatori che utilizzano Node.js

script di installazione automatica

Per installare l'interfaccia a riga di comando Firebase utilizzando lo script di installazione automatica, segui questi passaggi:

  1. Esegui questo comando cURL:

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

    Questo script rileva automaticamente il sistema operativo, scarica l'ultima release dell'interfaccia a riga di comando di Firebase, quindi abilita le funzionalità disponibili a livello globale Comando firebase.

  2. Continua ad accedere e testare l'interfaccia a riga di comando.

Per ulteriori esempi e dettagli sullo script di installazione automatica, consulta al codice sorgente dello script firebase.tools

binario autonomo

Per scaricare ed eseguire il file binario per l'interfaccia a riga di comando Firebase specifico per il tuo sistema operativo, segui questi passaggi:

  1. Scarica il file binario dell'interfaccia a riga di comando Firebase per il tuo sistema operativo: macOS | Linux

  2. (Facoltativo) Configura il comando firebase disponibile a livello globale.

    1. Rendi eseguibile il file binario eseguendo chmod +x ./firebase_tools.
    2. Aggiungi il percorso del file binario al tuo PERCORSO.
    di Gemini Advanced.

  3. Continua per accedere e testare l'interfaccia a riga di comando.

npm

Per utilizzare npm (il gestore dei pacchetti Node) per installare l'interfaccia a riga di comando Firebase, segui questi passaggi:

  1. Installa Node.js utilizzando nvm (Node Version Manager).
    L'installazione di Node.js installa automaticamente gli strumenti a riga di comando npm.

  2. Installa l'interfaccia a riga di comando Firebase tramite npm eseguendo questo comando:

    npm install -g firebase-tools

    Questo comando attiva il comando firebase disponibile a livello globale.

  3. Continua per accedere e testare l'interfaccia a riga di comando.

Accedi e testa l'interfaccia a riga di comando Firebase

Dopo aver installato la CLI, devi autenticarti. Dopodiché puoi confermare autenticazione mediante l'elenco dei progetti Firebase.

  1. Accedi a Firebase utilizzando il tuo Account Google eseguendo quanto segue :

    firebase login

    Questo comando connette la tua macchina locale a Firebase e ti garantisce ai progetti Firebase.

  2. Verifica che l'interfaccia a riga di comando sia installata correttamente e che acceda al tuo account l'elenco dei tuoi progetti Firebase. Esegui questo comando:

    firebase projects:list

    L'elenco visualizzato deve corrispondere ai progetti Firebase elencati in la console Firebase.

Esegui l'aggiornamento alla versione più recente del CLI

In genere, è consigliabile utilizzare la versione più aggiornata dell'interfaccia a riga di comando Firebase.

La modalità di aggiornamento della versione dell'interfaccia a riga di comando dipende dal sistema operativo e da come installato l'interfaccia a riga di comando.

Windows

  • standalone binario: scarica il nuovo file , e poi sostituiscilo sul tuo sistema
  • npm: esegui npm install -g firebase-tools

macOS

  • script di installazione automatica: esegui curl -sL https://firebase.tools | upgrade=true bash
  • standalone binario: scarica il nuovo file versione, quindi sostituirlo sul tuo sistema
  • npm: esegui npm install -g firebase-tools

Linux

  • script di installazione automatica: esegui curl -sL https://firebase.tools | upgrade=true bash
  • file binario autonomo: scarica la nuova versione, quindi sostituiscila sul tuo sistema
  • npm: esegui npm install -g firebase-tools

Usa l'interfaccia a riga di comando con sistemi CI

La CLI Firebase richiede un browser per completare l'autenticazione, ma è completamente compatibile con CI e altri ambienti headless.

  1. Su un computer con un browser, installa l'interfaccia a riga di comando Firebase.

  2. Avvia la procedura di accesso eseguendo il seguente comando:

    firebase login:ci

  3. Visita l'URL fornito, quindi accedi con un Account Google.

  4. Stampane una nuova token di aggiornamento. La sessione dell'interfaccia a riga di comando corrente non sarà interessata.

  5. Archivia il token di output in modo sicuro ma accessibile nel tuo sistema CI.

  6. Utilizza questo token quando esegui i comandi firebase. Puoi utilizzare uno dei due le due opzioni seguenti:

    • Opzione 1: archivia il token come variabile di ambiente FIREBASE_TOKEN. Il sistema utilizzerà automaticamente il token.

    • Opzione 2: esegui tutti i comandi firebase con --token TOKEN nel tuo sistema CI.
      Questo è l'ordine di precedenza per il caricamento dei token: flag, ambiente del progetto Firebase desiderato.

di Gemini Advanced.

Inizializzare un progetto Firebase

Molte attività comuni eseguite utilizzando l'interfaccia a riga di comando, come il deployment in un progetto Firebase, richiedono una directory del progetto. Devi creare una directory di progetto usando il comando firebase init. Una directory di un progetto è di solito la stessa come root di controllo del codice sorgente e, dopo aver eseguito firebase init, contiene una configurazione firebase.json .

Per inizializzare un nuovo progetto Firebase, esegui il seguente comando dalla directory dell'app:

firebase init

Il comando firebase init ti guida nella configurazione della directory del tuo progetto e alcuni prodotti Firebase. Durante l'inizializzazione del progetto, l'interfaccia a riga di comando Firebase che ti chiede di completare le attività seguenti:

  • Seleziona i prodotti Firebase che vuoi configurare nel progetto Firebase.

    Questo passaggio richiede di impostare le configurazioni di file specifici per prodotti selezionati. Per ulteriori dettagli su queste configurazioni, consulta documentazione specifica del prodotto (ad esempio, Hosting). Tieni presente che puoi sempre eseguire firebase init in un secondo momento per configurare altri prodotti Firebase.

  • Seleziona un progetto Firebase predefinito.

    Questo passaggio associa la directory del progetto corrente a un progetto Firebase in modo che i comandi specifici del progetto (come firebase deploy) vengono eseguiti progetto Firebase appropriato.

    È inoltre possibile associare più progetti Firebase (ad esempio un progetto di gestione temporanea e un progetto di produzione) con lo stesso progetto .

Al termine dell'inizializzazione, Firebase crea automaticamente i due seguenti elementi nella directory principale della directory dell'app locale:

  • Un file di configurazione firebase.json che elenca la configurazione del tuo progetto.

  • Un file .firebaserc in cui è archiviato il progetto alias.

Il file firebase.json

Il comando firebase init crea un'istanza di configurazione firebase.json nella radice della directory del progetto.

Il file firebase.json è obbligatorio per eseguire il deployment di asset con l'interfaccia a riga di comando Firebase perché specifica i file e le impostazioni della directory del progetto di cui viene eseguito il deployment progetto Firebase. Poiché alcune impostazioni possono essere definite nella directory del progetto o nella console Firebase, assicurati di risolvere eventuali conflitti di deployment.

Puoi configurare la maggior parte delle opzioni di Firebase Hosting direttamente nel file firebase.json. Tuttavia, per altri servizi Firebase che possono essere implementati con l'interfaccia a riga di comando Firebase, il comando firebase init crea file specifici in cui puoi definire le impostazioni per questi servizi, ad esempio un file index.js per Cloud Functions. Puoi configura anche gli hook di pre-deployment o post-deployment nel file firebase.json.

Di seguito è riportato un file firebase.json di esempio con impostazioni predefinite se seleziona Firebase Hosting, Cloud Firestore e Cloud Functions for Firebase (con le opzioni lint e origine TypeScript selezionate) durante l'inizializzazione.

{
  "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"
    ]
  }
}

Anche se viene utilizzato firebase.json per impostazione predefinita, puoi trasmettere il parametro --config PATH per specificare un'alternativa di configurazione del deployment.

Configurazione per più database Cloud Firestore

Quando esegui firebase init, il file firebase.json conterrà una singola Chiave firestore corrispondente al database predefinito del progetto, come mostrato in alto.

Se il progetto contiene più database Cloud Firestore, modifica firebase.json file per associare Cloud Firestore Security Rules e dei file di origine degli indici dei database. Modifica il file con un Array JSON, con una voce per ogni database.

      "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 file da ignorare al momento del deployment

Al momento del deployment della funzione, l'interfaccia a riga di comando specifica automaticamente un elenco di file nella directory functions da ignorare. Questo impedisce il deployment nel backend di file estranei che aumenta la dimensione dei dati del deployment.

L'elenco dei file ignorati per impostazione predefinita, mostrato in formato JSON, è:

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

Se aggiungi i tuoi valori personalizzati per ignore in firebase.json, assicurati di conservare (o aggiungere, se mancante) l'elenco di file mostrato sopra.

Gestire gli alias dei progetti

Puoi associare più progetti Firebase alla stessa directory di progetto. Ad esempio, potresti voler utilizzare un progetto Firebase per la gestione temporanea e un altro per la produzione. Utilizzando ambienti di progetto diversi, puoi verificare le modifiche prima di eseguire il deployment in produzione. Il comando firebase use ti consente di passare da un alias all'altro e di crearne di nuovi.

Aggiungi un alias di progetto

Quando selezioni un progetto Firebase durante il progetto di inizializzazione, il progetto viene automaticamente ha assegnato l'alias di default. Tuttavia, per consentire ai comandi specifici di un progetto viene eseguita in un progetto Firebase diverso, ma utilizza comunque lo stesso progetto esegui questo comando dalla directory del progetto:

firebase use --add

Questo comando ti chiede di selezionare un altro progetto Firebase e di assegnarlo come alias. Le assegnazioni di alias vengono scritte in un file .firebaserc all'interno della directory del progetto.

Utilizza alias di progetto

Per utilizzare gli alias di progetto Firebase assegnati, esegui uno dei seguenti comandi all'interno della directory del progetto.

Comando Descrizione
firebase use Visualizza un elenco di alias attualmente definiti per la directory del progetto
firebase use \
PROJECT_ID|ALIAS		 Indica l'esecuzione di tutti i comandi in base al progetto Firebase specificato.
L'interfaccia a riga di comando utilizza questo progetto come "progetto attivo" al momento.
firebase use --clear Cancella il progetto attivo.

Esegui firebase use PROJECT_ID|ALIAS per impostare un nuovo progetto attivo prima di eseguire altri comandi dell'interfaccia a riga di comando.
firebase use \
--unalias PROJECT_ALIAS		 Rimuove un alias dalla directory del progetto.

Puoi sostituire ciò che viene utilizzato come progetto attualmente attivo passando il flag --project con qualsiasi comando dell'interfaccia a riga di comando. Ad esempio, puoi impostare Interfaccia a riga di comando da eseguire su un progetto Firebase a cui hai assegnato staging alias. Se vuoi eseguire un singolo comando sul progetto Firebase che che hai assegnato all'alias prod, puoi eseguire, ad esempio, firebase deploy --project=prod.

Controllo del codice sorgente e alias di progetto

In generale, devi controllare il file .firebaserc nel controllo del codice sorgente per consentire al tuo team di condividere alias di progetto. Tuttavia, per i progetti open source o modelli iniziali, in genere non dovresti controllare il file .firebaserc.

Se hai un progetto di sviluppo apposito, puoi passare il flag --project a ogni comando oppure esegui firebase use PROJECT_ID senza assegnare un alias a il progetto Firebase.

Pubblica e testa il progetto Firebase localmente

Puoi visualizzare e testare il tuo progetto Firebase su URL ospitati localmente prima il deployment in produzione. Se vuoi testare solo determinate funzionalità, puoi utilizzare un elenco separato da virgole in un flag nel comando firebase serve.

Esegui questo comando dalla directory radice della directory locale del progetto se vuoi eseguire una delle seguenti attività:

  • Visualizza i contenuti statici per l'app ospitata su Firebase.
  • Utilizzi Cloud Functions per generare contenuti dinamici per Firebase Hosting e vuoi utilizzare le tue funzioni HTTP di produzione (di cui è stato eseguito il deployment) per emulare Hosting su un URL locale.
firebase serve --only hosting

Emula il progetto utilizzando funzioni HTTP locali

Esegui uno dei seguenti comandi dalla directory del progetto per emulare il progetto utilizzando funzioni HTTP locali.

  • Per emulare funzioni HTTP e hosting per i test su URL locali, utilizza uno dei seguenti comandi:

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

  • Per emulare solo le funzioni HTTP, utilizza il seguente comando:

    firebase serve --only functions

Esegui test da altri dispositivi locali

Per impostazione predefinita, firebase serve risponde solo alle richieste provenienti da localhost. Questo significa che potrai accedere ai contenuti ospitati dal sito web del tuo computer ma non da altri dispositivi collegati alla tua rete. Se vuoi eseguire il test da altri dispositivi locali, utilizza il flag --host, in questo modo:

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

Esegui il deployment in un progetto Firebase

L'interfaccia a riga di comando Firebase gestisce il deployment di codice e asset nel progetto Firebase, tra cui:

  • Nuove release dei tuoi siti Firebase Hosting
  • Cloud Functions for Firebase nuovo, aggiornato o esistente
  • Regole per Firebase Realtime Database
  • Regole per Cloud Storage for Firebase
  • Regole per Cloud Firestore
  • Indici di Cloud Firestore

Per eseguire il deployment in un progetto Firebase, esegui questo comando dal progetto directory:

firebase deploy

Facoltativamente, puoi aggiungere un commento a ciascun deployment. Questo commento: visualizzare insieme alle altre informazioni sul deployment Firebase Hosting alla pagina di destinazione. Ad esempio:

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

Quando utilizzi il comando firebase deploy, tieni presente quanto segue:

  • Per eseguire il deployment delle risorse da una directory di progetto, la directory del progetto deve avere un file firebase.json. Questo file è creato automaticamente per te Comando firebase init.

  • Per impostazione predefinita, firebase deploy crea una release per tutte le risorse di cui è possibile eseguire il deployment nella directory del progetto. Per eseguire il deployment di funzionalità o servizi Firebase specifici, l'utilizzo del deployment parziale.

Conflitti di deployment per le regole di sicurezza

Per Firebase Realtime Database, Cloud Storage for Firebase e Cloud Firestore, puoi definire le regole di sicurezza nella directory del progetto locale o nella console Firebase.

Un'altra opzione per evitare conflitti di deployment è utilizzare il deployment parziale e definire solo le regole Console Firebase.

Quote di deployment

È possibile (anche se improbabile) che tu superi una quota che limita o volume delle operazioni di deployment di Firebase. Ad esempio, quando per il deployment di un numero molto elevato di funzioni, potresti ricevere HTTP 429 Quota . Per risolvere questi problemi, prova utilizzando un deployment parziale.

Esegui il rollback di un deployment

Puoi eseguire il rollback di un deployment Firebase Hosting dalla pagina Firebase Hosting del progetto selezionando l'azione Rollback per la release che ti interessa.

Al momento non è possibile eseguire il rollback delle release delle regole di sicurezza per Firebase Realtime Database, Cloud Storage for Firebase o Cloud Firestore.

Esegui il deployment di servizi Firebase specifici

Se vuoi eseguire il deployment solo di funzionalità o servizi Firebase specifici, puoi utilizzare una elenco separato da virgole in un flag nel comando firebase deploy. Ad esempio: il comando seguente esegue il deployment di contenuti Firebase Hosting Cloud Storage regole di sicurezza.

firebase deploy --only hosting,storage

La seguente tabella elenca i servizi e le funzionalità disponibili per e deployment continuo. I nomi nei flag corrispondono alle chiavi nel tuo firebase.json.

Sintassi dei flag Servizio o funzionalità di cui è stato eseguito il deployment
--only hosting Contenuti in Firebase Hosting
--only database Firebase Realtime Database regole
--only storage Cloud Storage for Firebase regole
--only firestore Cloud Firestore regole e indici per tutti i database configurati
--only functions Cloud Functions for Firebase (sono possibili versioni più specifiche di questo flag)

Esegui il deployment di funzioni specifiche

Quando esegui il deployment di funzioni, puoi scegliere come target funzioni specifiche. Ad esempio:

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

Un'altra opzione consiste nel raggruppare le funzioni in gruppi di esportazione /functions/index.js. Le funzioni di raggruppamento consentono di eseguire il deployment con un singolo comando.

Ad esempio, puoi scrivere le seguenti funzioni per definire un valore groupA e un groupB:

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

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

In questo esempio, un file functions/groupB.js separato contiene elementi funzioni specifiche che definiscono le funzioni in groupB. Ad esempio:

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

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

In questo esempio, puoi eseguire il deployment di tutte le funzioni groupA eseguendo il seguente comando dalla directory del progetto:

firebase deploy --only functions:groupA

In alternativa, puoi scegliere come target una funzione specifica all'interno di un gruppo eseguendo questo comando :

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

Elimina funzioni

L'interfaccia a riga di comando Firebase supporta i seguenti comandi e opzioni per eliminando le funzioni di cui è stato eseguito il deployment in precedenza:

  • Consente di eliminare tutte le funzioni che corrispondono al nome specificato in tutte le regioni: 

    firebase functions:delete FUNCTION-1_NAME

  • Elimina una funzione specificata in esecuzione in una regione non predefinita: 

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

  • Elimina più di una funzione: 

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

  • Elimina un gruppo di funzioni specificato: 

    firebase functions:delete GROUP_NAME

  • Ignora la richiesta di conferma: 

    firebase functions:delete FUNCTION-1_NAME --force

Configura attività basate su script di pre-deployment e post-deployment

Puoi collegare gli script shell al comando firebase deploy per eseguire di pre-deployment e post-deployment. Ad esempio, uno script di predeployment potrebbe transpilare il codice TypeScript in JavaScript e un hook postdeployment potrebbe notificare agli amministratori i nuovi deployment dei contenuti del sito in Firebase Hosting.

Per configurare gli hook di pre-deployment o post-deployment, aggiungi script bash al tuo firebase.json. Puoi definire script brevi direttamente nel file firebase.json oppure puoi fare riferimento ad altre file nella directory del progetto.

Ad esempio, il seguente script è l'espressione firebase.json per un un'attività post-deployment che invia un messaggio Slack al completamento del deployment Firebase Hosting.

"hosting": {
  // ...

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

Il file dello script messageSlack.sh si trova nella directory del progetto e ha nel seguente modo:

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

Puoi configurare hook predeploy e postdeploy per qualsiasi asset di cui puoi eseguire il deployment. Tieni presente che con firebase deploy attiva tutte le attività di pre-deployment e post-deployment definite firebase.json file. Eseguire solo le attività associate a un account Servizio Firebase, utilizza i comandi di deployment parziale.

Entrambi i hook predeploy e postdeploy visualizzano l'output standard e l'errore gli stream degli script al terminale. Per i casi di errore, tieni presente quanto segue:

  • Se un hook di pre-deployment non viene completato come previsto, il deployment viene annullato.
  • Se il deployment non riesce per qualsiasi motivo, gli hook post-deployment non vengono attivati.

Variabili di ambiente

All'interno degli script in esecuzione negli hook di pre-deployment e post-deployment, le variabili di ambiente disponibili:

  • $GCLOUD_PROJECT: ID progetto del progetto attivo
  • $PROJECT_DIR: la directory principale contenente il file firebase.json
  • $RESOURCE_DIR: (solo per gli script hosting e functions) il valore percorso della directory che contiene Hosting o Cloud Functions risorse di cui eseguire il deployment

Gestisci più istanze di Realtime Database

Un progetto Firebase può avere più istanze Firebase Realtime Database. Di per impostazione predefinita, i comandi dell'interfaccia a riga di comando interagiscono con l'istanza del database default.

Tuttavia, puoi interagire con un'istanza di database non predefinita utilizzando il flag --instance DATABASE_NAME. La i seguenti comandi supportano il flag --instance:

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

Riferimento comando

Comandi amministrativi dell'interfaccia a riga di comando

Comando Descrizione
guida Visualizza le informazioni della guida sull'interfaccia a riga di comando o su comandi specifici.
init Associa e configura un nuovo progetto Firebase nella directory attuale. Questo comando crea un file di configurazione firebase.json nella directory corrente.
login Autentica l'interfaccia a riga di comando nel tuo account Firebase. Richiede l'accesso a un browser web.
Per accedere all'interfaccia a riga di comando in ambienti remoti che non consentono l'accesso a localhost, usa --no-localhost flag.
login:ci Genera un token di autenticazione da utilizzare in ambienti non interattivi ambienti cloud-native.
esci Esegue la disconnessione dell'interfaccia a riga di comando dal tuo account Firebase.
open Apre un browser con le risorse del progetto pertinenti.
projects:list Elenca tutti i progetti Firebase a cui hai accesso.
usa Imposta il progetto Firebase attivo per l'interfaccia a riga di comando.
Gestisce gli alias del progetto.

Comandi per la gestione dei progetti

Comando Descrizione
Gestione dei progetti Firebase
projects:addfirebase Aggiunge risorse Firebase a un progetto Google Cloud esistente.
projects:crea Crea un nuovo progetto Google Cloud e aggiunge le risorse Firebase a il nuovo progetto.
projects:list Elenca tutti i progetti Firebase a cui hai accesso.
Gestione delle app Firebase (iOS, Android, web)
apps:create Crea una nuova app Firebase nel progetto attivo.
apps:list Elenca le app Firebase registrate nel progetto attivo.
apps:sdkconfig Stampa la configurazione dei servizi Google di un'app Firebase.
setup:web Obsoleta. Usa invece apps:sdkconfig e specifica web come argomento della piattaforma.
Stampa la configurazione dei servizi Google di un'app web Firebase.
Gestione degli hash dei certificati SHA (solo Android)
apps:android:sha:crea\
FIREBASE_APP_ID SHA_HASH		 Aggiunge l'hash del certificato SHA specificato all'app Android Firebase specificata.
apps:android:sha:elimina \
FIREBASE_APP_ID SHA_HASH		 Elimina l'hash del certificato SHA specificato dall'app Android creata con Firebase specificata.
apps:android:sha:list \
FIREBASE_APP_ID		 Elenca gli hash dei certificati SHA per l'intervallo di indirizzi specificato App Firebase per Android

Deployment e sviluppo locale

Questi comandi ti consentono di eseguire il deployment e interagire con il tuo sito Firebase Hosting.

Comando Descrizione
distribuire Esegue il deployment di codice e asset dalla directory del progetto alla progetto. Per Firebase Hosting è necessario un file di configurazione firebase.json.
servire Avvia un server web locale con la configurazione di Firebase Hosting. Per Firebase Hosting, un firebase.json il file di configurazione è obbligatorio.

Comandi App Distribution

Comando Descrizione
appdistribution:distribution \
--app FIREBASE_APP_ID		 Rende la build disponibile ai tester.
appdistribution:testers:add Aggiunge tester al progetto.
appdistribution:testers:remove Rimuove i tester dal progetto.

Comandi App Hosting

Comando Descrizione
apphosting:backends:crea \
--progetto PROJECT_ID
--location REGION --app APP_ID 		Crea la raccolta di risorse gestite collegate a un singolo codebase che comprende un backend App Hosting. Se vuoi, specifica un'app web Firebase esistente tramite il relativo ID app Firebase.
apphosting:backends:get \ BACKEND_ID
--project PROJECT_ID
--location REGION 		Recupera dettagli specifici, incluso l'URL pubblico, di un backend.
apphosting:backends:list \
--progetto PROJECT_ID 		Recupera un elenco di tutti i backend attivi associati a un progetto.
firebase apphosting:backends:elimina \ BACKEND_ID
--progetto PROJECT_ID
--posizione REGION 		Elimina un backend dal progetto.
apphosting:secrets:set \
KEY --progetto PROJECT_ID
--posizione REGION --data-file Data file		 Archivia il materiale segreto in Secret Manager. Facoltativamente, fornisci un il percorso del file da cui leggere i dati secret. Imposta su _ per leggere i dati riservati dall'input standard.
apphosting:secrets:grantaccess \
KEY --progetto PROJECT_ID BACKEND_ID
--posizione REGION 		Concede il backend account di servizio al secret fornito, in modo che sia accessibile App Hosting in fase di build o di esecuzione.
apphosting:secrets:describe \
KEY --progetto PROJECT_ID 		Recupera i metadati per un secret e le relative versioni.
firebase apphosting:secrets:access \
KEY[@version]
--progetto PROJECT_ID 		Accede a un valore del secret specificato e la relativa versione. Il valore predefinito è l'accesso alla versione più recente.

Comandi Authentication (gestione utenti)

Comando Descrizione
auth:esportazione Esporta gli account utente del progetto attivo in un file JSON o CSV. Per per altri dettagli, consulta auth:import e auth:export .
auth:importa Importa gli account utente da un file JSON o CSV nella cartella progetto. Per ulteriori dettagli, consulta auth:import e auth:export .

Comandi Cloud Firestore

Comando Descrizione
firestore:località

Elenca le località disponibili per il tuo database Cloud Firestore.

firestore:databases:create DATABASE_ID

Crea un'istanza di database in modalità nativa nel tuo progetto Firebase.

Il comando accetta i seguenti flag:

  • --location <nome regione> per specificare località di deployment per il database. Tieni presente che puoi eseguire firebase firestore:locations per l'elenco disponibili luoghi. Obbligatorio.
  • --delete-protection <deleteProtectionState> per consentire o impedire l'eliminazione del database specificato. Valori validi sono ENABLED o DISABLED. Il valore predefinito è DISABLED.
  • --recupero point-in-time <PITRState> in per stabilire se abilitare il recupero point-in-time. I valori validi sono ENABLED o DISABLED. Il valore predefinito è DISABLED. Facoltativo.
firestore:databases:list

Elenca i database nel tuo progetto Firebase.
firestore:databases:get DATABASE_ID

Ottieni la configurazione del database per un database specificato nel tuo progetto Firebase.
firestore:databases:update DATABASE_ID

Aggiorna la configurazione di un database specificato nel tuo progetto Firebase.

È richiesto almeno un flag. Il comando accetta i seguenti flag:

  • --delete-protection <deleteProtectionState> per consentire o impedire l'eliminazione del database specificato. Valori validi sono ENABLED o DISABLED. Il valore predefinito è DISABLED.
  • --recupero point-in-time <PITRState> in per stabilire se abilitare il recupero point-in-time. I valori validi sono ENABLED o DISABLED. Il valore predefinito è DISABLED. Facoltativo.
firestore:databases:delete DATABASE_ID

Eliminare un database nel progetto Firebase.
firestore:indexes

Elenca gli indici di un database nel tuo progetto Firebase.

Il comando utilizza il seguente flag:

  • --database DATABASE_ID in specifica il nome del database per il quale elencare gli indici. In caso contrario fornito, gli indici sono elencati per il database predefinito.
firestore:elimina

Elimina i documenti nel database del progetto attivo. Con l'interfaccia a riga di comando, puoi eliminare in modo ricorsivo tutti i documenti di una raccolta.

Tieni presente che l'eliminazione dei dati Cloud Firestore con l'interfaccia a riga di comando comporta l'esecuzione di operazioni di lettura eliminare i costi. Per ulteriori informazioni, vedi Informazioni sulla fatturazione di Cloud Firestore.

Il comando utilizza il seguente flag:

  • --database DATABASE_ID per specificare il nome del database da cui vengono eliminati i documenti. Se non specificato, i documenti vengono eliminati dal database predefinito. Facoltativo.

Comandi Cloud Functions for Firebase

Comando Descrizione
functions:config:clone Clona l'ambiente di un altro progetto in Firebase attivo progetto.
functions:config:get Recupera i valori di configurazione esistenti del progetto attivo Cloud Functions.
functions:config:set Archivia i valori di configurazione del runtime del progetto attivo Cloud Functions.
functions:config:unset Rimuove i valori dalla configurazione di runtime del progetto attivo.
functions:log Legge i log di Cloud Functions di cui è stato eseguito il deployment.

Per ulteriori informazioni, fai riferimento all'ambiente per la configurazione iniziale.

Comandi Crashlytics

Comando Descrizione
crashlytics:mappingfile:generateid \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML 		Genera un ID file di mappatura univoco nella risorsa Android specificata (XML).
crashlytics:mappingfile:upload \
--app=FIREBASE_APP_ID \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML \
PATH/TO/MAPPING_FILE.TXT 		Carica un file di mapping (TXT) compatibile con ProGuard per questa app, e lo associa all'ID del file di mappatura dichiarato File di risorse Android (XML).
crashlytics:symbols:upload \
--app=FIREBASE_APP_ID \
PATH/TO/SYMBOLS		 Genera un file di simboli compatibile con Crashlytics per gli arresti anomali delle librerie native su Android e lo carica sui server Firebase.

Comandi Extensions

Comando Descrizione
Estensione Mostra informazioni su come utilizzare i comandi Firebase Extensions.
Elenca le istanze delle estensioni installate nel progetto attivo.
ext:configura \
EXTENSION_INSTANCE_ID		 Riconfigura i valori dei parametri di un'istanza dell'estensione nel manifest dell'estensione.
ext:info \
PUBLISHER_ID/EXTENSION_ID		 Stampa le informazioni dettagliate su un'estensione.
ext:install \
PUBLISHER_ID/EXTENSION_ID		 Aggiunge una nuova istanza di un'estensione nel tuo manifest dell'estensione.
ext:elenco Elenca tutte le istanze dell'estensione installate in un progetto Firebase.
Stampa l'ID istanza per ogni estensione.
ext:disinstalla\
EXTENSION_INSTANCE_ID		 Rimuove un'istanza di estensione da manifest dell'estensione.
ext:update \
EXTENSION_INSTANCE_ID		 Consente di aggiornare un'istanza dell'estensione alla versione più recente nel tuo manifest dell'estensione.
ext:esportazione Esporta tutte le istanze delle estensioni installate dal progetto manifest dell'estensione.

Extensions comando publisher

Comando Descrizione
ext:dev:init Inizializza una base di codice di base per una nuova estensione nella directory corrente.
ext:dev:list \
PUBLISHER_ID		 Stampa un elenco di tutte le estensioni caricate da un publisher.
ext:dev:register Registra un progetto Firebase come progetto del publisher di estensioni.
ext:dev:deprecate \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE		 Ritira che corrispondono al predicato di versione.
Un predicato di versione può essere una singola versione (ad esempio 1.0.0), o un intervallo di versioni (ad esempio >1.0.0).
Se non viene fornito alcun predicato di versione, ritira tutte le versioni di quell'estensione.
ext:dev:undeprecate \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE		 Annulla deprecazione che corrispondono al predicato di versione.
Un predicato di versione può essere una singola versione (ad esempio 1.0.0), o un intervallo di versioni (ad esempio >1.0.0).
Se non viene fornito alcun predicato di versione, annulla la deprecazione di tutte le versioni di quell'estensione.
ext:dev:upload \
PUBLISHER_ID/EXTENSION_ID		 Carica una nuova versione di un'estensione.
ext:dev:usage \
PUBLISHER_ID		 Mostra i conteggi delle installazioni e le metriche di utilizzo per le estensioni caricate da un editore.

Comandi Hosting

Comando Descrizione
hosting:disattiva

Interrompe la gestione del traffico Firebase Hosting per l'account Firebase attivo progetto.

L'URL Hosting del progetto mostrerà il messaggio "Sito non trovato" messaggio dopo l'esecuzione di questo comando.

Gestione di Hosting siti
firebase hosting:sites:create \
SITE_ID

Crea un nuovo sito Hosting nel progetto Firebase attivo utilizzando: SITE_ID specificato

(Facoltativo) Specifica un'app web Firebase esistente da associare con il nuovo sito passando il seguente flag: --app FIREBASE_APP_ID:

firebase hosting:sites:delete \
SITE_ID

Elimina il sito Hosting specificato

L'interfaccia a riga di comando mostra un messaggio di conferma prima dell'eliminazione del sito.

(Facoltativo) Salta la richiesta di conferma passando il metodo seguenti flag: -f o --force

firebase hosting:sites:get \
SITE_ID

Recupera le informazioni sul sito Hosting specificato
firebase hosting:sites:list

Elenca tutti i siti Hosting per il progetto Firebase attivo

Gestione dei canali di anteprima
firebase hosting:channel:create \
CHANNEL_ID

Crea un nuovo canale di anteprima in predefinito Hosting sito utilizzando il valore specificato CHANNEL_ID

Questo comando non viene eseguito nel canale.
firebase hosting:channel:delete \
CHANNEL_ID

Elimina il canale di anteprima specificato

Non puoi eliminare il canale dal vivo di un sito.
firebase hosting:channel:deploy \
CHANNEL_ID

Esegue il deployment dei contenuti e la configurazione Hosting nell'istanza specificata anteprima del canale

Se il canale di anteprima non esiste ancora, questo comando crea la canale nel sito predefinito Hosting prima del deployment sul canale.

firebase hosting:channel:list Elenca tutti i canali (incluso il canale "dal vivo") nella sito predefinito Hosting
firebase hosting:channel:open \
CHANNEL_ID		 Apre un browser all'URL del canale specificato o restituisce l'URL se non è possibile aprire in un browser
Clonazione delle versioni
firebase hosting:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID/
TARGET_SITE_IDTARGET_CHANNEL_ID

Clona la versione di cui è stato eseguito il deployment più recente nell'"origine" specificata canale al "target" specificato canale

Questo comando esegue anche il deployment nel "target" specificato canale. Se "target" il canale non esiste ancora, questo comando crea un nuovo canale di anteprima nella sezione "target" Hosting sito prima del deployment in del canale.

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

Clona la versione specificata nel "target" specificato canale

Questo comando esegue anche il deployment nel "target" specificato canale. Se "target" il canale non esiste ancora, questo comando crea un nuovo canale di anteprima nella sezione "target" Hosting sito prima del deployment in del canale.

Puoi trovare VERSION_ID nel Dashboard Hosting della console Firebase.

Comandi Realtime Database

Tieni presente che puoi creare la tua istanza iniziale predefinita di Realtime Database nel Firebase o utilizzando la console generale firebase init flusso di lavoro o lo specifico Flusso firebase init database.

Una volta create le istanze, puoi gestirle come descritto in Gestisci più istanze Realtime Database.

Comando Descrizione
database:get Recupera i dati dal database del progetto attivo e li visualizza come JSON. Supporta l'esecuzione di query su dati indicizzati.
database:instances:create Crea un'istanza di database con un nome dell'istanza specificato. Accetta l'opzione --location per creare un database in un regione. Per i nomi delle regioni da utilizzare con questa opzione, vedi seleziona le località per il progetto. Se non esiste alcuna istanza di database per il progetto attuale, ti viene richiesto per eseguire il flusso firebase init e creare un'istanza.
database:instances:list Elenca tutte le istanze di database per questo progetto. Accetta i Opzione --location per elencare i database in una specifica regione. Per i nomi delle regioni da utilizzare con questa opzione, consulta seleziona le località per il progetto.
database:profile Crea un profilo delle operazioni sul database del progetto attivo. Per maggiori dettagli, consulta i tipi di operazioni Realtime Database.
database:push Invia nuovi dati a un elenco in una posizione specificata nell'elenco nel database del progetto. Riceve input da un file, da STDIN o da un argomento della riga di comando.
database:rimuovi Elimina tutti i dati in una posizione specificata nei campi del progetto attivo per configurare un database.
database:set Sostituisce tutti i dati in una posizione specificata nei campi del progetto attivo per configurare un database. Prende l'input da un file, da STDIN o da un argomento della riga di comando.
database:update Esegue un aggiornamento parziale in una posizione specificata nella nel database del progetto. Prende l'input da un file, STDIN o da una riga di comando .

Comandi Remote Config

Comando Descrizione
remoteconfig:versions:list \
--limite di NUMBER_OF_VERSIONS		 Elenca le dieci versioni più recenti del modello. Specifica 0 per restituire tutte le versioni esistenti o, facoltativamente, di passa l'opzione --limit per limitare il numero le versioni secondarie restituite.
remoteconfig:get \
--v, numero_versione VERSION_NUMBER
--o, output FILENAME		 Recupera il modello in base alla versione (per impostazione predefinita è la versione più recente) e genera i gruppi di parametri, i parametri, i nomi delle condizioni e la versione in una tabella. Facoltativamente, puoi scrivere l'output in un file specificato con -o, FILENAME.
remoteconfig:rollback \
--v, version_number VERSION_NUMBER
--force		 Esegue il rollback di Remote Config modello a una versione precedente specificata numero predefinito o viene quella predefinita per la versione precedente immediata (versione corrente -1). A meno che --force non venga passato, richiede S/N prima di procedere con il rollback.