Modelli e controllo delle versioni di Remote Config


I modelli Remote Config sono insiemi di modelli in formato JSON e le condizioni che hai creato per il tuo progetto Firebase. Tu creare modelli client da cui l'app recupera i valori, e server, da cui i client server possono recuperare i valori.

Questa sezione illustra i modelli di server. Per conoscere le specifiche del cliente modelli, fare clic su Modelli di client.

Puoi modificare e gestire il modello utilizzando la console Firebase, che mostra i contenuti del modello in formato grafico Parametri e Condizioni schede.

Ecco un esempio di file modello di 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-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    },
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

Puoi eseguire queste attività di gestione delle versioni con la console Firebase:

  • Elenco di tutte le versioni dei modelli archiviate
  • Recuperare una versione specifica
  • Esegui il rollback a una versione client specifica
  • Elimina Remote Config modelli dalla modifica storia pagina

Esiste un limite totale di 300 versioni archiviate dell'intera durata per tipo di modello (300 modelli client e 300 modelli server), tra cui numeri di versione per i modelli eliminati. Se pubblichi più di 300 versioni per tipo di modello per tutta la durata di un progetto, vengono eliminate le versioni precedenti, mantenendo un massimo di 300 versioni quel tipo.

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

Puoi eliminare Remote Config di modelli in base alle tue esigenze dal Cronologia delle modifiche pagina attiva la console Remote Config.

Gestire le versioni del modello Remote Config

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

Elenca tutte le versioni archiviate del modello Remote Config

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

  1. Dalla console Firebase, apri Remote Config.

  2. Poi, Parametri scheda, seleziona l'"orologio" visualizzata in alto a destra.

    Si apre Cronologia delle modifiche pagina che elenca tutte le versioni dei modelli archiviate in un menu 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 come.

Recuperare una versione specifica del modello Remote Config

Puoi recuperare tutti i dati archiviati del modello Remote Config. Per recuperare un modello archiviato versione:

  1. Apri il riquadro dei dettagli di Cronologia delle modifiche.

  2. Per visualizzare i dettagli di un'altra versione nell'elenco, selezionala dal menu a destra.

  3. Visualizza una differenza dettagliata del modello attivo e di qualsiasi altra versione archiviata in base a passando il mouse sopra il menu contestuale di una versione non selezionata e selezionando Confronta con la versione selezionata.

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

Puoi eseguire il rollback a qualsiasi versione memorizzata del modello. Per eseguire il rollback di un modello:

  1. Individua il pulsante di opzione in alto a destra nella pagina Cronologia delle modifiche. Fai clic e conferma solo se vuoi eseguire il rollback quella versione e utilizzare questi valori immediatamente per tutte le app e gli utenti.

Tieni presente che questa operazione di rollback crea effettivamente una nuova versione numerata. Ad esempio, eseguire il rollback dalla versione 10 alla versione 6 crea in modo efficace una nuova copia della versione 6, rispetto all'originale solo in quanto il suo numero di versione è 11. La versione originale 6 è ancora archiviata, a condizione che non abbia raggiunto la scadenza, e la versione 11 diventa il modello attivo.

Elimina un modello di Remote Config

Puoi eliminare Remote Config modelli dalla console Firebase. A elimina un modello Remote Config:

1. Da Remote Config Parametri pagina, fare clic Cronologia delle modifiche.

  1. Passa al modello che desideri eliminare e fai clic su Altro, quindi seleziona Elimina.

  2. Quando ti viene chiesto di confermare l'eliminazione, fai clic su Elimina.

Scarica e pubblica Remote Config modelli

Scarica e pubblica Remote Config modelli per integrarli nei tuoi controllo del codice sorgente e creazione di sistemi, automatizzare gli aggiornamenti delle configurazioni e mantenere i parametri e valori sincronizzati tra più progetti.

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

Supponiamo che tu abbia più progetti che rappresentano diverse fasi ciclo di vita dello sviluppo del software, ad esempio sviluppo, test, gestione temporanea e produzione ambienti cloud-native. In questo caso, potresti promuovere un modello completamente testato dal tuo di gestione temporanea nell'ambiente di produzione, scaricandolo di gestione temporanea e pubblicazione nel progetto di produzione.

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

I parametri e i valori parametro creati specificatamente come varianti in un A/B Testing esperimento non è incluso nei modelli esportati.

Per esportare e importare Remote Config modelli:

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

Scarica il modello corrente di Remote Config

Usa quanto segue per scaricare il modello Remote Config attivo in Formato JSON:

  1. Da Parametri o condizioni di Remote Config scheda, apri il Menu e Seleziona Scarica file di configurazione attuale.
  2. Quando richiesto, fai clic su Scarica file di configurazione e scegli il percorso in cui vuoi salvare il file, poi fai clic su Salva.

Convalida il modello Remote Config

I modelli server vengono convalidati quando tenti di pubblicare dal Console Firebase. Tieni presente che le condizioni di Percentuale casuale possono essere importati, ma eventuali condizioni non supportate genereranno un errore durante il caricamento. Se stai tentando di pubblicare un modello originariamente esportato da un modello cliente, assicurati innanzitutto di rimuovere eventuali condizioni specifiche del cliente.

Pubblica il modello Remote Config

Dopo aver scaricato un modello, apportato le modifiche necessarie ai contenuti JSON e e la convalida, puoi pubblicarla in un progetto.

La pubblicazione di un modello sostituisce l'intero modello di configurazione esistente con aggiornato e incrementa la versione del modello di uno. 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 a parametri e valori sono immediatamente disponibili alle tue app e ai tuoi utenti. Se necessario, puoi esegui il rollback a una versione precedente.

Usa i seguenti comandi per pubblicare il modello:

  1. Da Parametri o condizioni di Remote Config apri il Menu, e seleziona Pubblica da un file.
  2. Quando richiesto, fai clic su Sfoglia, naviga e seleziona Remote Config file da pubblicare, quindi fai clic su Seleziona.
  3. Il file verrà convalidato e, se la convalida va a buon fine, puoi fare clic su Pubblica per rendere la configurazione immediatamente disponibile per le tue app e i tuoi utenti.

Passaggi successivi