Utiliser des fichiers manifestes de flags de fonctionnalité

Ce guide explique comment créer ou exporter des flags à partir d'un fichier manifeste de flags de fonctionnalité App Lifecycle Manager.

Les flags de fonctionnalité App Lifecycle Manager vous permettent de contrôler la disponibilité et le comportement des fonctionnalités de vos applications sans nécessiter de nouveaux déploiements de code ni de modifications d'infrastructure. Les fichiers manifestes de flags de fonctionnalité vous permettent de créer des flags par groupes. Vous n'avez donc pas besoin de créer et de synchroniser manuellement des flags dans votre plan de gestion et votre environnement de développement local. Les fichiers manifestes fournissent un utilitaire de gestion groupée qui vous permet de gérer vos flags à l'aide de fichiers JSON conformes au schéma de fichier manifeste de flag OpenFeature Open Source.

Prérequis

À vérifier avant de commencer :

  1. Un environnement gcloud configuré pour gérer les ressources App Lifecycle Manager.
  2. Vous avez suivi le guide de démarrage rapide Déployer des flags de fonctionnalité.

Créer des flags à partir d'un fichier manifeste

La commande push vous permet de créer plusieurs flags à la fois en fournissant un fichier manifeste JSON local.

  1. Créez un fichier nommé my_flags.json avec vos définitions de flag. Ce fichier sert de source de vérité locale pour votre fichier manifeste.

    Exemple de my_flags.json :

    {
  "flags": {
    "my-flag": {
      "defaultValue": "foo-bar",
      "description": "A description of the flag.",
      "flagType": "string"
    }
  }
}
    1. Exécutez la commande push en spécifiant votre fichier manifeste et le UnitKind cible.
    gcloud beta app-lifecycle-manager flags push \
    --file="my_flags.json" \
    --unit-kind="UNIT_KIND_NAME"

Créer un fichier manifeste à partir de configurations de flag existantes

La commande pull récupère les configurations de flag existantes à partir de l'API App Lifecycle Manager et génère un fichier manifeste JSON local. Cela vous permet de conserver un enregistrement local de vos flags ou de les préparer à être utilisés avec les outils de génération de code OpenFeature.

  1. Exécutez la commande pull en spécifiant le chemin de sortie de votre choix.

     gcloud beta app-lifecycle-manager flags pull \
     --output-file="manifest.json" \
     --unit-kind="UNIT_KIND_NAME" \
     --overwrite-output-file

  2. Si vous utilisez des accesseurs de flag de type sécurisé, exécutez l'utilitaire de génération de code de l'interface de ligne de commande OpenFeature sur le nouveau fichier manifest.json pour mettre à jour les accesseurs de flag de type sécurisé de votre application. Cela garantit que les fichiers manifestes correspondent aux clés et aux types du plan de gestion.

Étape suivante