I modelli Remote Config sono insiemi di parametri e condizioni in formato JSON che hai creato per il tuo progetto Firebase. Puoi creare modelli client, da cui la tua app recupera i valori, e modelli server, da cui i client server possono recuperare i valori.
Questa sezione illustra i modelli di server. Per scoprire di più sui modelli specifici del client, fai clic su Modelli di client.Modifichi e gestisci il modello utilizzando la console Firebase, che mostra i contenuti del modello in formato grafico nelle schede Parametri e Condizioni.
Ecco un esempio di file di modello 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 Firebase console:
- Elencare tutte le versioni del modello archiviate
- Recuperare una versione specifica
- Eseguire il rollback a una versione client specifica
- Eliminare i modelli Remote Config dalla pagina Cronologia delle modifiche
È previsto un limite totale di 300 versioni archiviate a vita 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 precedenti vengono eliminate, mantenendo un massimo di 300 versioni di quel tipo.
Ogni volta che aggiorni i parametri, Remote Config crea un
nuovo modello Remote Config con controllo delle versioni e archivia il modello precedente come
versione a cui puoi recuperare o eseguire il rollback, se necessario. I 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 metadati relativi a quella versione specifica.
Puoi eliminare i modelli Remote Config in base alle esigenze dalla pagina Cronologia delle modifiche della console Remote Config.
Gestire le versioni dei modelli Remote Config
Questa sezione descrive come gestire le versioni del modello di Remote Config template.
Elencare tutte le versioni archiviate del modello Remote Config
Puoi recuperare un elenco di tutte le versioni archiviate del Remote Config modello. A tal fine:
Dalla console Firebase, apri Remote Config.
Quindi, nella scheda Parametri, seleziona l'icona "orologio" visualizzata in alto a destra.
Si apre la pagina Cronologia delle modifiche che elenca tutte le versioni del modello archiviate in un menu di elenco a destra.
L'elenco dei modelli include i metadati per tutte le versioni archiviate, inclusi l'ora dell'aggiornamento, l'utente che l'ha eseguito e la modalità di esecuzione.
Recuperare una versione specifica del modello Remote Config
Puoi recuperare qualsiasi versione specifica archiviata del modello Remote Config. Per recuperare una versione del modello archiviata:
Apri il riquadro dei dettagli della cronologia delle modifiche.
Per visualizzare i dettagli di un'altra versione nell'elenco, selezionala dal menu a destra.
Visualizza una differenza dettagliata del modello attivo e di qualsiasi altra versione archiviata passando il mouse sopra il menu contestuale di qualsiasi versione non selezionata e selezionando Confronta con la versione selezionata.
Eseguire il rollback a una versione specifica archiviata del modello Remote Config
Puoi eseguire il rollback a qualsiasi versione archiviata del modello. Per eseguire il rollback di un modello:
- Individua il pulsante delle opzioni in alto a destra nella pagina Cronologia delle modifiche. Fai clic e conferma solo se sei sicuro 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 effettivamente una nuova versione numerata. Ad esempio, l'esecuzione del rollback dalla versione 10 alla versione 6 crea effettivamente una nuova copia della versione 6, che differisce dall'originale solo per il fatto che 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.
Eliminare un modello Remote Config
Puoi eliminare i modelli Remote Config dalla console Firebase. Per eliminare un Remote Config modello:
1. Nella pagina Remote Config Parametri, fai clic su Cronologia delle modifiche.Passa al modello che vuoi eliminare, fai clic su Altro, quindi seleziona Elimina.
Quando ti viene chiesto di confermare l'eliminazione, fai clic su Elimina.
Scaricare e pubblicare i modelli Remote Config
Scarica e pubblica i modelli Remote Config per integrarli nei sistemi di controllo della 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. Quindi, puoi aggiornare il file JSON esportato e pubblicarlo nello stesso progetto oppure in un progetto nuovo o esistente.
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, potresti promuovere un modello completamente testato dall'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 popolare un nuovo progetto con parametri e valori di un progetto stabilito.
I parametri e i valori dei parametri creati specificamente come varianti in un A/B Testing esperimento non sono inclusi nei modelli esportati.
Per esportare e importare i modelli Remote Config:
- Scarica il modello di configurazione Remote Config corrente.
- Convalida il modelloRemote Config.
- Pubblica il modello Remote Config.
Scaricare il modello di Remote Config corrente
Utilizza quanto segue per scaricare il modello Remote Config attivo in formato JSON:
- Nella scheda Remote Config Parametri o Condizioni , apri il menu e seleziona Scarica il file di configurazione attuale.
- Quando ti viene chiesto, fai clic su Scarica il file di configurazione, scegli la posizione in cui vuoi salvare il file, quindi fai clic su Salva.
Convalidare il modello di Remote Config
I modelli di server vengono convalidati quando tenti di pubblicarli dalla Firebase console. Tieni presente che le condizioni Utente in percentuale casuale possono essere importate, ma qualsiasi condizione non supportata genererà un errore durante il caricamento. Se stai tentando di pubblicare un modello esportato originariamente da un modello client, assicurati di rimuovere prima tutte le condizioni specifiche del client.
Pubblicare 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 modello sostituisce l'intero modello di configurazione esistente con il file aggiornato e incrementa di uno la versione del modello. 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 disponibili immediatamente per le app e gli utenti. Se necessario, puoi eseguire il rollback a una versione precedente.
Utilizza i seguenti comandi per pubblicare il modello:
- Nella scheda Remote Config Parametri o Condizioni, apri il Menu, e seleziona Pubblica da un file.
- Quando ti viene chiesto, fai clic su Sfoglia, individua e seleziona il Remote Config file che vuoi pubblicare, quindi fai clic su Seleziona.
- Il file verrà convalidato e, se l'operazione va a buon fine, puoi fare clic su Pubblica per rendere la configurazione immediatamente disponibile per le app e gli utenti.
Passaggi successivi
- Scopri di più sull' utilizzo di Remote Config negli ambienti server.
- Prova lato server Remote Config con Cloud Functions e Vertex AI.