Aller au contenu principal

Export de Configuration des Flags

Open in QuickMonitoring→ Sites → [Votre Site] → Feature Flags → Exporter

Exportez la configuration de vos flags en JSON — utile pour synchroniser les définitions de flags entre environnements ou pour sauvegarder votre configuration de feature flags.

Ce que vous verrez​

La page Feature Flags comporte un bouton Exporter (ou une icône de téléchargement) en haut à droite de la liste des flags. En cliquant dessus, un fichier JSON est téléchargé immédiatement dans votre navigateur.

Le fichier exporté contient la configuration complète de tous les flags du site : noms, clés, types, variantes, règles de ciblage, pourcentages de déploiement et état d'activation.

Format du fichier exporté​

Le fichier JSON exporté suit cette structure :

{
  "exported_at": "2025-05-19T14:32:00Z",
  "site_id": "site_abc123",
  "site_name": "Mon Site de Production",
  "flags": [
    {
      "key": "nouvelle-interface-paiement",
      "name": "Nouvelle interface de paiement",
      "description": "Refonte du tunnel de paiement - Q2 2025",
      "type": "boolean",
      "enabled": true,
      "rollout_percentage": 25,
      "targeting_rules": [
        {
          "property": "plan",
          "operator": "equals",
          "value": "pro",
          "match": "all"
        }
      ],
      "variants": [],
      "created_at": "2025-03-10T09:00:00Z",
      "updated_at": "2025-05-15T16:22:00Z"
    },
    {
      "key": "test-couleur-bouton",
      "name": "Test couleur bouton CTA",
      "description": "Expérience A/B sur la couleur du bouton principal",
      "type": "multivariant",
      "enabled": true,
      "rollout_percentage": 100,
      "targeting_rules": [],
      "variants": [
        { "key": "control", "value": "bleu", "weight": 50 },
        { "key": "variante-a", "value": "rouge", "weight": 25 },
        { "key": "variante-b", "value": "vert", "weight": 25 }
      ],
      "created_at": "2025-04-01T11:00:00Z",
      "updated_at": "2025-05-19T10:00:00Z"
    }
  ]
}

Comment l'utiliser​

Cas d'usage 1 — Sauvegarde de la configuration​

Exportez régulièrement votre configuration de flags pour conserver une sauvegarde :

  1. Accédez à Feature Flags pour votre site.
  2. Cliquez sur Exporter.
  3. Sauvegardez le fichier flags-export-[date].json dans votre dépôt Git ou votre système de stockage.

Recommandation : versionnez ce fichier dans votre dépôt Git aux côtés de votre code. Cela crée une trace historique de vos configurations de flags et facilite les revues de code.

Cas d'usage 2 — Migration entre environnements​

Si vous gérez plusieurs environnements (développement, staging, production), exportez les flags d'un environnement et importez-les dans un autre :

  1. Sur le site Staging, cliquez sur Exporter et téléchargez le JSON.
  2. Sur le site Production, utilisez l'option Importer (si disponible) et sélectionnez le fichier exporté.

Note : La fonctionnalité d'import n'est disponible que sur les forfaits Pro et supérieurs. Sur le forfait gratuit, utilisez le JSON exporté comme référence pour recréer manuellement les flags.

Cas d'usage 3 — Revue de configuration en équipe​

Partagez le fichier JSON exporté avec votre équipe pour une revue de la configuration des flags avant un lancement majeur :

# Exemple de workflow Git
git add flags-config-prod-2025-05-19.json
git commit -m "snapshot: configuration des flags avant lancement v2.0"

Cas d'usage 4 — Utilisation du JSON dans des scripts d'automatisation​

Le fichier exporté peut être utilisé dans des scripts pour automatiser la synchronisation ou la validation :

// Exemple : script Node.js pour vérifier les flags désactivés
const config = require('./flags-export-2025-05-19.json');

const flagsDesactives = config.flags.filter(flag => !flag.enabled);
console.log(`Flags désactivés : ${flagsDesactives.length}`);
flagsDesactives.forEach(flag => {
  console.log(`  - ${flag.key} (mis à jour : ${flag.updated_at})`);
});

Exporter un seul flag​

Pour exporter la configuration d'un flag spécifique, accédez à la page de détail du flag et utilisez le bouton Exporter ce flag (disponible dans le menu d'options du flag). Le JSON généré contiendra uniquement ce flag.

Condition de validation​

Vous obtenez cet achievement lorsque : l'export JSON de la configuration des flags est téléchargé depuis le tableau de bord pour ce site, et le fichier contient au moins un flag.

Problèmes courants​

Le bouton Exporter est grisé. Vous devez avoir au moins un flag créé pour que l'export soit disponible. Si aucun flag n'existe, créez d'abord un flag, puis revenez pour exporter.

Le fichier JSON téléchargé est vide ou ne contient pas tous mes flags. Vérifiez que vous exportez depuis le bon site (le bon siteId). Si des flags sont manquants, ils peuvent avoir été supprimés ou appartenir à un autre site de votre organisation.

Je veux réimporter ce fichier mais je ne trouve pas le bouton Importer. La fonctionnalité d'import est disponible sur les forfaits payants. Sur le forfait gratuit, utilisez le JSON comme référence et recréez les flags manuellement via le formulaire Nouveau Flag.

Les règles de ciblage dans le JSON sont différentes de ce que je vois dans l'interface. L'export utilise des clés techniques internes (ex. equals, contains) alors que l'interface affiche des libellés traduits (ex. est égal à, contient). Les deux représentent les mêmes règles — la différence est uniquement de présentation.