Gestire i modelli e il controllo delle versioni del server Remote Config

Seleziona il tipo di modello: Modelli lato client Modelli lato server


I modelli Remote Config sono insiemi di parametri e condizioni in formato JSON creati per il tuo progetto Firebase. I modelli di server forniscono le configurazioni alle istanze del server utilizzando Firebase Admin SDK per Remote Config (disponibile per Node.js, Java, Python e Go).

Puoi utilizzare la console Firebase per modificare e gestire il modello di server. Vai a DevOps e coinvolgimento > Remote Config per visualizzare i contenuti del modello in formato grafico nella pagina Parametri e nella pagina Condizioni.

Ecco un esempio di file di modello del server:

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

Puoi eseguire queste attività di gestione delle versioni nella console Firebase (vai a DevOps e coinvolgimento > Remote Config):

  • Elenca tutte le versioni dei template archiviati
  • Recupera una versione specifica
  • Esegui il rollback a una versione specifica del server
  • Elimina Remote Config modelli dalla pagina Cronologia delle modifiche.

È previsto un limite totale di 300 versioni archiviate per tutta la durata per tipo di modello (300 modelli client e 300 modelli server), che include i numeri di versione archiviati per i modelli eliminati. Se pubblichi più di 300 versioni di modelli per tipo di modello durante il ciclo di vita di un progetto, le versioni meno recenti vengono eliminate, mantenendo un massimo di 300 versioni di quel tipo.

Ogni volta che aggiorni i parametri, Remote Config crea un nuovo template Remote Config con controllo delle versioni e archivia il template precedente come una versione che puoi recuperare o di cui puoi eseguire il rollback in base alle tue esigenze. I numeri di versione vengono incrementati in sequenza a partire dal valore iniziale memorizzato da Remote Config. Tutti i modelli includono un campo version come mostrato, contenente i metadati relativi a quella versione specifica.

Puoi eliminare i modelli Remote Config in base alle tue esigenze nella pagina DevOps e coinvolgimento > Remote Config > Cronologia delle modifiche della console Firebase.

Gestisci le versioni del template Remote Config

Questa sezione descrive come gestire le versioni del tuo modello di server Remote Config.

Elenca tutte le versioni archiviate del template Remote Config

Puoi recuperare un elenco di tutte le versioni archiviate del template Remote Config. Per farlo:

  1. Nella console Firebase, vai alla pagina DevOps e coinvolgimento > Remote Config > Parametri.

  2. Seleziona l'icona "orologio" visualizzata in alto a destra.

    Si apre la pagina Cronologia delle modifiche, che elenca tutte le versioni dei modelli memorizzate in un menu a elenco a destra.

    L'elenco dei modelli include i metadati di tutte le versioni archiviate, tra cui l'ora dell'aggiornamento, l'utente che lo ha eseguito e il modo in cui è stato eseguito.

Recupera una versione specifica del template Remote Config

Puoi recuperare qualsiasi versione archiviata specifica del template Remote Config. Ecco come recuperare una versione del modello memorizzata:

  1. Nella console Firebase, vai alla pagina DevOps e coinvolgimento > Remote Config > Cronologia delle modifiche.

  2. Per impostazione predefinita, la pagina mostra il modello attualmente attivo. Per visualizzare una versione diversa, selezionala nel riquadro dei dettagli a destra.

  3. Visualizza una differenza dettagliata tra il template attivo e qualsiasi altra versione archiviata passando il mouse sopra il menu contestuale di qualsiasi versione non selezionata e selezionando Confronta con la versione selezionata.

Esegui il rollback a una versione archiviata specifica del template Remote Config

Puoi eseguire il rollback a qualsiasi versione archiviata del template. Ecco come eseguire il rollback di un modello:

  1. Nella console Firebase, vai alla pagina DevOps e coinvolgimento > Remote Config > Cronologia delle modifiche.

  2. Individua il pulsante di opzione in alto a destra nella pagina per le versioni precedenti del modello idonee per il rollback.

  3. Fai clic e conferma questa opzione solo se hai la certezza di voler eseguire il rollback a quella versione e utilizzare questi valori immediatamente per tutte le app e tutti gli utenti.

Tieni presente che questa operazione di rollback crea di fatto una nuova versione numerata. Ad esempio, il rollback dalla versione 10 alla versione 6 crea di fatto una nuova copia della versione 6, che differisce dall'originale solo per il numero di versione, che è 11. La versione 6 originale viene comunque archiviata, supponendo che non abbia raggiunto la scadenza, e la versione 11 diventa il template attivo.

Elimina un modello Remote Config

Puoi eliminare i template Remote Config utilizzando la console Firebase. Ecco come eliminare un modello:

  1. Nella console Firebase, vai alla pagina DevOps e coinvolgimento > Remote Config > Parametri.

  2. Fai clic su Cronologia delle modifiche.

  3. Passa al modello che vuoi eliminare, fai clic su Altro, quindi seleziona Elimina.

  4. Quando ti viene richiesto di confermare l'eliminazione, fai clic su Elimina.

Scarica e pubblica i modelli Remote Config

Scarica e pubblica i modelli Remote Config per integrarli nei tuoi sistemi di controllo del codice sorgente e di build, automatizzare gli aggiornamenti della configurazione e mantenere sincronizzati parametri e valori in più progetti.

Puoi scaricare il modello Remote Config attualmente attivo dalla console Firebase. Puoi quindi aggiornare il file JSON esportato e pubblicarlo nello stesso progetto o in un progetto nuovo o esistente.

Ad esempio, supponiamo che tu abbia più progetti che rappresentano diverse fasi del ciclo di vita dello sviluppo software, come ambienti di sviluppo, test, gestione temporanea e produzione. In questo caso, puoi promuovere un modello completamente testato dal tuo ambiente di gestione temporanea all'ambiente di produzione scaricandolo dal progetto di gestione temporanea e pubblicandolo nel progetto di produzione.

Puoi anche utilizzare questo metodo per eseguire la migrazione delle configurazioni da un progetto a un altro o per compilare un nuovo progetto con parametri e valori di un progetto esistente.

I parametri e i valori parametro creati specificamente come varianti in un esperimento A/B Testing non sono inclusi nei modelli esportati.

Per esportare e importare i modelli Remote Config:

  1. Scarica il modello Remote Config corrente.
  2. Convalida il template Remote Config.
  3. Pubblica il modello Remote Config.

Scarica il modello Remote Config attuale

Utilizza quanto segue per scaricare il modello Remote Config attivo in formato JSON:

  1. Nella console Firebase, vai alla pagina DevOps e coinvolgimento > Remote Config > Parametri o Condizioni.

  2. Apri il Menu e seleziona Scarica il file di configurazione attuale.

  3. Quando richiesto, fai clic su Scarica file di configurazione, scegli la posizione in cui vuoi salvare il file, quindi fai clic su Salva.

Convalida il modello Remote Config

I modelli di server vengono convalidati quando tenti di pubblicarli dalla console Firebase. Le condizioni che utilizzano la regola Utente in percentuale casuale possono essere importate, ma qualsiasi condizione non supportata genera un errore durante il caricamento. Se stai tentando di pubblicare un modello originariamente esportato da un modello client, assicurati di rimuovere prima tutte le condizioni specifiche del client.

Pubblica il modello Remote Config

Dopo aver scaricato un modello, apportato le modifiche necessarie ai contenuti JSON e averlo convalidato, puoi pubblicarlo in un progetto.

La pubblicazione di un template sostituisce l'intero template di configurazione esistente con il file aggiornato e incrementa di uno la versione del template. Poiché l'intera configurazione viene sostituita, se elimini un parametro dal file JSON e lo pubblichi, il parametro viene eliminato dal server e non è più disponibile per i client.

Dopo la pubblicazione, le modifiche ai parametri e ai valori sono immediatamente disponibili per le app e gli utenti. Se necessario, puoi eseguire il rollback a una versione precedente.

Per pubblicare il modello:

  1. Nella console Firebase, vai alla pagina DevOps e coinvolgimento > Remote Config > Parametri o Condizioni.

  2. Apri il menu e seleziona Pubblica da un file.

  3. Quando richiesto, fai clic su Sfoglia, vai al file Remote Config che vuoi pubblicare, selezionalo e fai clic su Seleziona.

  4. Il file viene convalidato. Se la convalida ha esito positivo, fai clic su Pubblica per rendere la configurazione immediatamente disponibile per le tue app e i tuoi utenti.

Passaggi successivi