Erstellen eines Feature-Flags mit mehreren Varianten

Öffnen Sie die AWS Systems Manager Konsole unter. https://console.aws.amazon.com/systems-manager/appconfig/

Wählen Sie im Navigationsbereich Anwendungen und dann eine Anwendung aus.

Wählen Sie auf der Registerkarte Konfigurationsprofile und Feature-Flags ein vorhandenes Feature-Flag-Konfigurationsprofil aus.

Wählen Sie im Abschnitt Flags die Option Neues Flag hinzufügen aus.

Geben Sie im Abschnitt Feature-Flag-Definition für Flaggenname einen Namen ein.

Geben Sie als Flaggenschlüssel eine Flag-ID ein, um die Flaggen innerhalb desselben Konfigurationsprofils zu unterscheiden. Flaggen innerhalb desselben Konfigurationsprofils können nicht denselben Schlüssel haben. Nachdem das Flag erstellt wurde, können Sie den Flaggennamen bearbeiten, nicht jedoch den Flaggenschlüssel.

(Optional) Geben Sie im Feld Beschreibung Informationen zu dieser Flagge ein.

Wählen Sie im Abschnitt Varianten die Option Multi-variant Flagge aus.

(Optional) Wählen Sie im Abschnitt Feature-Flag-Attribute die Option Attribut definieren aus. Mit Attributen können Sie zusätzliche Werte in Ihrem Flag angeben. Weitere Informationen zu Attributen und Einschränkungen finden Sie unterWissenswertes über Feature-Flag-Attribute.

1. Geben Sie für Schlüssel einen Flaggenschlüssel an und wählen Sie seinen Typ aus der Typliste aus. Informationen zu den unterstützten Optionen für die Felder Wert und Einschränkungen finden Sie im Abschnitt zu Attributen, auf den bereits verwiesen wurde.

2. Wählen Sie Erforderlicher Wert aus, um anzugeben, ob ein Attributwert erforderlich ist.

3. Wählen Sie Attribut definieren, um weitere Attribute hinzuzufügen.

4. Wählen Sie Anwenden, um die Attributänderungen zu speichern.

Wählen Sie im Abschnitt Feature-Flag-Varianten die Option Variante erstellen aus.

1. Geben Sie als Variantenname einen Namen ein.

2. Verwenden Sie den Wert „Aktiviert“, um die Variante zu aktivieren.

3. Geben Sie in das Textfeld Regel eine Regel ein.

4. Verwenden Sie die Optionen Variante erstellen > Variante oben erstellen oder Variante unten erstellen, um weitere Varianten für dieses Kennzeichen zu erstellen.

5. Verwenden Sie im Abschnitt Standardvariante die Option Aktiviert, um die Standardvariante zu aktivieren. Geben Sie optional Werte für die in Schritt 10 definierten Attribute an.

6. Wählen Sie Anwenden aus.

Überprüfen Sie die Details des Flags und seiner Varianten und wählen Sie Create flag.

Erstellen Sie auf Ihrem lokalen Computer eine Konfigurationsdatei, in der die Details des Fags für mehrere Varianten angegeben sind, das Sie erstellen möchten. Speichern Sie die Datei mit einer .json Dateierweiterung. Die Datei muss dem AWS.AppConfig.FeatureFlags JSON-Schema entsprechen. Der Schemainhalt Ihrer Konfigurationsdatei wird dem Folgenden ähneln.

{
  "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"
}

Hier ist ein Beispiel mit drei Varianten und der Standardvariante.

{
  "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"
}

Verwenden Sie die CreateHostedConfigurationVersion API, um Ihre Feature-Flag-Konfigurationsdaten in zu speichern AWS AppConfig.

Das service_returned_content_file enthält Ihre Konfigurationsdaten, die einige AWS AppConfig generierte Metadaten enthalten.