Gérer les modèles de serveur et la gestion des versions de Remote Config

Sélectionnez un type de modèle : Modèles côté client Modèles côté serveur


Les modèles Remote Config sont des ensembles de paramètres et de conditions au format JSON créés pour votre projet Firebase. Les modèles de serveur diffusent des configurations vers des instances de serveur à l'aide de Firebase Admin SDK pour Remote Config (disponible pour Node.js, Java, Python et Go).

Vous pouvez utiliser la console Firebase pour modifier et gérer votre modèle de serveur. Accédez à DevOps & Engagement > Remote Config pour afficher le contenu du modèle au format graphique sur la page Paramètres et la page 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-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

Vous pouvez effectuer ces tâches de gestion des versions dans la console Firebase (accédez à DevOps et engagement > Remote Config) :

  • Lister toutes les versions de modèle stockées
  • Récupérer une version spécifique
  • Effectuer un rollback vers une version de serveur spécifique
  • Supprimez Remote Config modèles de la page "Historique des modifications".

Le nombre total de versions stockées par type de modèle est limité à 300 (300 modèles client et 300 modèles serveur), ce qui inclut 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 pendant 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 modèle Remote Config avec une nouvelle version et stocke le modèle précédent en tant que version que vous pouvez récupérer ou restaurer 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 les modèles Remote Config si nécessaire sur la page DevOps et engagement > Remote Config > Historique des modifications de la console Firebase.

Gérer les versions du modèle Remote Config

Cette section explique comment gérer les versions de votre modèle de serveur Remote Config.

Lister toutes les versions stockées du modèle Remote Config

Vous pouvez récupérer la liste de toutes les versions stockées du modèle Remote Config. Pour ce faire, procédez comme suit :

  1. Dans la console Firebase, accédez à la page DevOps et engagement > Remote Config > Paramètres.

  2. Sélectionnez l'icône en forme d'horloge en haut à droite.

    La page Historique des modifications s'ouvre. Elle liste toutes les versions de modèles stockées dans un menu de liste à droite.

    La liste des modèles inclut les métadonnées de 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 du modèle Remote Config. Voici comment récupérer une version de modèle stockée :

  1. Dans la console Firebase, accédez à la page DevOps et engagement > Remote Config > Historique des modifications.

  2. Par défaut, la page affiche le modèle actif actuel. Pour afficher une autre version, sélectionnez-la dans le volet Détails à droite.

  3. 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, puis 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. Voici comment effectuer un rollback d'un modèle :

  1. Dans la console Firebase, accédez à la page DevOps et engagement > Remote Config > Historique des modifications.

  2. Recherchez le bouton d'option en haut à droite de la page pour les versions de modèle précédentes éligibles au rollback.

  3. Cliquez et confirmez cette action uniquement si vous êtes sûr de vouloir revenir à 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 nouvelle version numérotée. Par exemple, si vous effectuez un rollback de la version 10 à la version 6, une nouvelle copie de la version 6 est créée. Elle ne diffère de l'originale 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 à l'aide de la console Firebase. Pour supprimer un modèle :

  1. Dans la console Firebase, accédez à la page DevOps et engagement > Remote Config > Paramètres.

  2. Cliquez sur Historique des modifications.

  3. Accédez au modèle que vous souhaitez supprimer, cliquez sur Plus, puis sélectionnez Supprimer.

  4. 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 de code source 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 à partir de 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.

Par exemple, supposons que vous disposiez de plusieurs projets représentant différentes étapes du cycle de vie du développement logiciel, telles que 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 à un autre, ou pour renseigner un nouveau projet avec les paramètres et les valeurs d'un projet existant.

Les paramètres et les valeurs de paramètre créés spécifiquement en tant que variantes dans une expérience A/B Testing ne sont pas inclus dans les modèles exportés.

Pour exporter et importer des modèles Remote Config :

  1. Téléchargez le modèle Remote Config actuel.
  2. Validez le modèle Remote Config.
  3. Publiez le modèle Remote Config.

Télécharger le modèle Remote Config actuel

Utilisez la commande suivante pour télécharger le modèle Remote Config actif au format JSON :

  1. Dans la console Firebase, accédez à la page DevOps et engagement > Remote Config > Paramètres ou conditions.

  2. Ouvrez le Menu, puis sélectionnez Télécharger le fichier de configuration actuel.

  3. 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 essayez de les publier depuis la console Firebase. Les conditions qui utilisent la règle Utilisateur d'un pourcentage aléatoire peuvent être importées, mais toute condition non compatible génère une erreur lors de l'importation. Si vous essayez de publier un modèle qui a été exporté à l'origine à partir d'un modèle client, veillez à supprimer d'abord 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'intégralité 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'intégralité de la configuration est remplacée, si vous supprimez un paramètre du fichier JSON et que vous le publiez, il est supprimé du serveur et n'est plus disponible pour les clients.

Une fois publiés, 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.

Pour publier votre modèle, procédez comme suit :

  1. Dans la console Firebase, accédez à la page DevOps et engagement > Remote Config > Paramètres ou conditions.

  2. Ouvrez le Menu, puis sélectionnez Publier à partir d'un fichier.

  3. Lorsque vous y êtes invité, cliquez sur Parcourir, accédez au fichier Remote Config que vous souhaitez publier, sélectionnez-le, puis cliquez sur Sélectionner.

  4. Le fichier est validé. Si la validation réussit, cliquez sur Publier pour que la configuration soit immédiatement disponible pour vos applications et vos utilisateurs.

Étapes suivantes