Création d'un indicateur de fonctionnalité à variantes multiples

Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/appconfig/.

Dans le volet de navigation, choisissez Applications, puis choisissez une application.

Dans l'onglet Profils de configuration et indicateurs de fonctionnalités, choisissez un profil de configuration d'indicateur de fonctionnalité existant.

Dans la section Drapeaux, choisissez Ajouter un nouveau drapeau.

Dans la section Définition de l'indicateur de fonctionnalité, pour Nom de l'indicateur, entrez un nom.

Pour Flag key, entrez un identifiant de drapeau pour distinguer les drapeaux au sein du même profil de configuration. Les indicateurs d'un même profil de configuration ne peuvent pas avoir la même clé. Une fois le drapeau créé, vous pouvez modifier son nom, mais pas sa clé.

(Facultatif) Dans le champ Description, entrez les informations relatives à cet indicateur.

Dans la section Variantes, choisissez Multi-variant drapeau.

(Facultatif) Dans la section Attributs de l'indicateur de fonctionnalité, choisissez Définir l'attribut. Les attributs vous permettent de fournir des valeurs supplémentaires dans votre drapeau. Pour plus d'informations sur les attributs et les contraintes, consultezComprendre les attributs des indicateurs de fonctionnalité.

1. Pour Clé, spécifiez une touche d'indicateur et choisissez son type dans la liste des types. Pour plus d'informations sur les options prises en charge pour les champs Valeur et Contraintes, consultez la section sur les attributs référencée précédemment.

2. Sélectionnez Valeur obligatoire pour spécifier si une valeur d'attribut est requise.

3. Choisissez Définir un attribut pour ajouter des attributs supplémentaires.

4. Choisissez Appliquer pour enregistrer les modifications d'attributs.

Dans la section Variantes de l'indicateur de fonctionnalité, choisissez Créer une variante.

1. Dans le champ Nom de la variante, entrez un nom.

2. Utilisez le bouton Valeur activée pour activer la variante.

3. Dans la zone de texte Règle, entrez une règle.

4. Utilisez les options Créer une variante > Créer une variante ci-dessus ou Créer une variante ci-dessous pour créer des variantes supplémentaires pour cet indicateur.

5. Dans la section Variante par défaut, utilisez le bouton Valeur activée pour activer la variante par défaut. Vous pouvez éventuellement fournir des valeurs pour les attributs définis à l'étape 10.

6. Cliquez sur Appliquer.

Vérifiez les détails du drapeau et de ses variantes, puis choisissez Créer un drapeau.

Créez un fichier de configuration sur votre machine locale qui spécifie les détails de l'indicateur multivariant que vous souhaitez créer. Enregistrez le fichier avec une extension de .json fichier. Le fichier doit respecter le schéma AWS.AppConfig.FeatureFlags JSON. Le contenu du schéma de votre fichier de configuration sera similaire au suivant.

{
  "flags": {
    "FLAG_NAME": {
      "attributes": {
          "ATTRIBUTE_NAME": {
          "constraints": {
            "type": "CONSTRAINT_TYPE"
          }
        }
      },
      "description": "FLAG_DESCRIPTION",
      "name": "VARIANT_NAME"
    }
  },
  "values": {
    "VARIANT_VALUE_NAME": {
      "_variants": [
        {
          "attributeValues": {
            "ATTRIBUTE_NAME": BOOLEAN
          },
          "enabled": BOOLEAN,
          "name": "VARIANT_NAME",
          "rule": "VARIANT_RULE"
        },
        {
          "attributeValues": {
            "ATTRIBUTE_NAME": BOOLEAN
          },
          "enabled": BOOLEAN,
          "name": "VARIANT_NAME",
          "rule": "VARIANT_RULE"
        },
        {
          "attributeValues": {
            "ATTRIBUTE_NAME": BOOLEAN
          },
          "enabled": BOOLEAN,
          "name": "VARIANT_NAME",
          "rule": "VARIANT_RULE"
        },
        {
          "attributeValues": {
            "ATTRIBUTE_NAME": BOOLEAN
          },
          "enabled": BOOLEAN,
          "name": "VARIANT_NAME",
          "rule": "VARIANT_RULE"
        }
      ]
    }
  },
  "version": "VERSION_NUMBER"
}

Voici un exemple avec trois variantes et la variante par défaut.

{
  "flags": {
    "ui_refresh": {
      "attributes": {
        "dark_mode_support": {
          "constraints": {
            "type": "boolean"
          }
        }
      },
      "description": "A release flag used to release a new UI",
      "name": "UI Refresh"
    }
  },
  "values": {
    "ui_refresh": {
      "_variants": [
        {
          "attributeValues": {
            "dark_mode_support": true
          },
          "enabled": true,
          "name": "QA",
          "rule": "(ends_with $email \"qa-testers.mycompany.com\")"
        },
        {
          "attributeValues": {
            "dark_mode_support": true
          },
          "enabled": true,
          "name": "Beta Testers",
          "rule": "(exists key::\"opted_in_to_beta\")"
        },
        {
          "attributeValues": {
            "dark_mode_support": false
          },
          "enabled": true,
          "name": "Sample Population",
          "rule": "(split pct::10 by::$email)"
        },
        {
          "attributeValues": {
            "dark_mode_support": false
          },
          "enabled": false,
          "name": "Default Variant"
        }
      ]
    }
  },
  "version": "1"
}

Utilisez l'CreateHostedConfigurationVersionAPI pour enregistrer les données de configuration de votre indicateur de fonctionnalité dans AWS AppConfig.

Le service_returned_content_file contient vos données de configuration qui incluent certaines métadonnées AWS AppConfig générées.