Remote Config modèles sont des ensembles de paramètres et de conditions au format JSON que vous avez créés pour votre projet Firebase. Vous pouvez créer des modèles clients, à partir desquels votre application récupère des valeurs, et des modèles serveurs, à partir desquels les clients serveurs peuvent récupérer des valeurs.
Cette section traite des modèles de serveur. Pour en savoir plus sur les modèles spécifiques aux clients, cliquez sur Modèles de client.Vous modifiez et gérez le modèle à l'aide de la Firebase console, qui affiche le contenu du modèle au format graphique dans les onglets Paramètres et Conditions.
Voici un exemple de fichier de modèle de serveur :
{
"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
}
}
Vous pouvez effectuer les tâches de gestion des versions suivantes avec la Firebase console :
- Répertorier toutes les versions de modèle stockées
- Récupérer une version spécifique
- Effectuer un rollback vers une version client spécifique
- Supprimer des modèles Remote Config de la page Historique des modifications
Le nombre total de versions stockées à vie par type de modèle est limité à 300 (300 modèles de client et 300 modèles de serveur), y compris les numéros de version stockés pour les modèles supprimés. Si vous publiez plus de 300 versions de modèle par type de modèle au cours de la durée de vie d'un projet, les versions les plus anciennes sont supprimées, ce qui permet de conserver un maximum de 300 versions de ce type.
Chaque fois que vous mettez à jour des paramètres, Remote Config crée un
nouveau modèle Remote Config versionné et stocke le modèle précédent en tant que
version que vous pouvez récupérer ou vers laquelle vous pouvez effectuer un rollback si nécessaire. Les numéros de version
sont incrémentés de manière séquentielle à partir de la valeur initiale stockée par Remote Config.
Tous les modèles incluent un champ version, comme illustré, contenant des métadonnées sur cette version spécifique.
Vous pouvez supprimer des modèles Remote Config selon vos besoins depuis la page Historique des modifications de la console Remote Config.
Gérer les versions de modèle Remote Config
Cette section explique comment gérer les versions de votre Remote Config modèle.
Répertorier toutes les versions stockées du modèle Remote Config
Vous pouvez récupérer une liste de toutes les versions stockées du Remote Config modèle. Pour ce faire :
Dans la Firebase console, ouvrez Remote Config.
Ensuite, dans l'onglet Paramètres, sélectionnez l'icône d'horloge affichée en haut à droite.
La page Historique des modifications s'ouvre et répertorie toutes les versions de modèle stockées dans un menu de liste à droite.
La liste des modèles inclut des métadonnées pour toutes les versions stockées, y compris l'heure de la mise à jour, l'utilisateur qui l'a effectuée et la manière dont elle a été effectuée.
Récupérer une version spécifique du modèle Remote Config
Vous pouvez récupérer n'importe quelle version stockée spécifique du modèle Remote Config. Pour récupérer une version de modèle stockée :
Ouvrez le volet de détails de l'historique des modifications.
Pour afficher les détails d'une autre version de la liste, sélectionnez-la dans le menu de droite.
Affichez une comparaison détaillée du modèle actif et de toute autre version stockée en pointant sur le menu contextuel d'une version non sélectionnée et en sélectionnant Comparer avec la version sélectionnée.
Effectuer un rollback vers une version stockée spécifique du modèle Remote Config
Vous pouvez effectuer un rollback vers n'importe quelle version stockée du modèle. Pour effectuer un rollback d'un modèle :
- Recherchez le bouton d'option en haut à droite de la page "Historique des modifications". Cliquez dessus et confirmez uniquement si vous êtes sûr de vouloir effectuer un rollback vers cette version et utiliser ces valeurs immédiatement pour toutes les applications et tous les utilisateurs.
Notez que cette opération de rollback crée une version numérotée. Par exemple, le rollback de la version 10 vers la version 6 crée une copie de la version 6, qui ne diffère de l'original que par son numéro de version, qui est 11. La version 6 d'origine est toujours stockée, à condition qu'elle n'ait pas expiré, et la version 11 devient le modèle actif.
Supprimer un modèle Remote Config
Vous pouvez supprimer des modèles Remote Config depuis la console Firebase. Pour supprimer un Remote Config modèle :
1. Sur la page "Remote Config Paramètres ", cliquez sur Historique des modifications.Basculez vers le modèle que vous souhaitez supprimer, cliquez sur Plus, puis sélectionnez Supprimer.
Lorsque vous êtes invité à confirmer la suppression, cliquez sur Supprimer.
Télécharger et publier des modèles Remote Config
Téléchargez et publiez des modèles Remote Config pour les intégrer à vos systèmes de contrôle des sources et de compilation, automatiser les mises à jour de configuration et synchroniser les paramètres et les valeurs sur plusieurs projets.
Vous pouvez télécharger le modèle Remote Config actuellement actif depuis la console Firebase. Vous pouvez ensuite mettre à jour le fichier JSON exporté et le publier dans le même projet, ou le publier dans un projet nouveau ou existant.
Supposons que vous ayez plusieurs projets représentant différentes étapes de votre cycle de vie de développement logiciel, comme les environnements de développement, de test, de préproduction et de production. Dans ce cas, vous pouvez promouvoir un modèle entièrement testé de votre environnement de préproduction vers votre environnement de production en le téléchargeant depuis votre projet de préproduction et en le publiant dans votre projet de production.
Vous pouvez également utiliser cette méthode pour migrer des configurations d'un projet vers un autre ou pour remplir un nouveau projet avec des paramètres et des valeurs provenant d'un projet établi.
Les paramètres et les valeurs de paramètre créés spécifiquement en tant que variantes dans une A/B Testing expérience ne sont pas inclus dans les modèles exportés.
Pour exporter et importer des modèles Remote Config :
- Téléchargez le modèle Remote Config Config actuel.
- Validez le modèle Remote Config.
- Publiez le modèle Remote Config.
Télécharger le modèle Remote Config actuel
Utilisez les éléments suivants pour télécharger le modèle Remote Config actif au format JSON :
- Dans l'onglet " Remote Config Paramètres" ou "Conditions ", ouvrez le Menu, puis sélectionnez "Télécharger le fichier de configuration actuel".
- Lorsque vous y êtes invité, cliquez sur Télécharger le fichier de configuration, choisissez l'emplacement où vous souhaitez enregistrer le fichier, puis cliquez sur Enregistrer.
Valider le modèle Remote Config
Les modèles de serveur sont validés lorsque vous tentez de publier depuis la Firebase console. Notez que les conditions "Utilisateur en pourcentage aléatoire" peuvent être importées, mais toute condition non acceptée générera une erreur lors de l'importation. Si vous tentez de publier un modèle qui a été exporté à l'origine à partir d'un modèle de client, veillez d'abord à supprimer toutes les conditions spécifiques au client.
Publier le modèle Remote Config
Après avoir téléchargé un modèle, apporté les modifications nécessaires au contenu JSON et l'avoir validé, vous pouvez le publier dans un projet.
La publication d'un modèle remplace l'ensemble du modèle de configuration existant par le fichier mis à jour et incrémente la version du modèle de un. Étant donné que l'ensemble de la configuration est remplacé, si vous supprimez un paramètre du fichier JSON et que vous le publiez, le paramètre est supprimé du serveur et n'est plus disponible pour les clients.
Après la publication, les modifications apportées aux paramètres et aux valeurs sont immédiatement disponibles pour vos applications et vos utilisateurs. Si nécessaire, vous pouvez effectuer un rollback vers une version précédente.
Utilisez les commandes suivantes pour publier votre modèle :
- Dans l'onglet " Remote Config Paramètres" ou "Conditions ", ouvrez le Menu, puis sélectionnez "Publier à partir d'un fichier".
- Lorsque vous y êtes invité, cliquez sur Parcourir, accédez au fichier Remote Config que vous souhaitez publier et sélectionnez-le, puis cliquez sur Sélectionner.
- Le fichier sera validé et, en cas de succès, vous pourrez cliquer sur Publier pour rendre la configuration immédiatement disponible pour vos applications et vos utilisateurs.
Étapes suivantes
- En savoir plus sur l'utilisation de Remote Config dans les environnements serveur.
- Essayez côté serveur Remote Config avec Cloud Functions et Vertex AI.