Beispiele für Feature-Flags für den lokalen Entwicklungsmodus des AWS AppConfig Agenten

Dieser Abschnitt enthält Beispiele für Feature-Flags, die Sie mit AWS AppConfig Agent im lokalen Entwicklungsmodus verwenden können. Im lokalen Entwicklungsmodus werden Feature-Flag-Daten im Abrufzeitformat der Daten erwartet. Das Abrufzeitformat ist das Format, das zurückgegeben wird, wenn das Flag von der GetLatestConfigurationAPI abgerufen wird. Es enthält nur den Wert des Flags. Das Abrufzeitformat beinhaltet nicht die vollständige Definition eines Flags (wie sie an die API übergeben wurde). CreateHostedConfigurationVersion Die vollständige Definition eines Flags enthält auch Informationen wie Attributnamen und -werte, Einschränkungen und den aktivierten Status des Flags.

Beispiele für Flaggen mit grundlegenden Funktionen

Verwenden Sie die folgenden Beispiele für grundlegende Feature-Flags mit AWS AppConfig Agent im lokalen Entwicklungsmodus.

Anmerkung

Wenn Sie möchten, dass der Agent den Inhaltstyp Ihrer lokalen Feature-Flag-Daten als meldet application/json (wie beim Abrufen von Flag-Daten aus einer Umgebung, die sich nicht AWS AppConfig im lokalen Entwicklungsmodus befindet), müssen Ihre lokalen Feature-Flag-Dateien die Erweiterung.json verwenden. Beispiel, Local:MyFeatureFlags:SampleB1.json.

Beispiel 1: Ein einzelnes Flag, das eine Aktualisierung der Benutzeroberfläche darstellt.

{
    "ui_refresh": {
        "enabled": true,
        "new_styleguide_colors": true
    }
}

Beispiel 2: Mehrere Flags stehen für betriebsbereite Feature-Flags.

{
   "background_worker": {
        "enabled": true,
        "num_threads": 4,
        "queue_name": "MyWorkQueue"
   },
   "emergency_shutoff_switch": {
        "enabled": false
   },
   "logger_settings": {
        "enabled": true,
        "level": "INFO"
   }
}

Beispiele für Merkmalsflaggen mit mehreren Varianten

Das Abrufzeitformat einer Feature-Flag-Konfiguration, die mindestens ein Feature-Flag mit mehreren Varianten enthält, wird als Amazon Ion-Daten statt als JSON-Daten dargestellt. In diesem Format werden Flags mit mehreren Varianten als Liste mit Anmerkungen dargestellt, und grundlegende Flags werden als kommentierte Zeichenfolge dargestellt. Die Listenelemente eines Flags mit mehreren Varianten sind entweder ein Tupel (eine Liste mit einer Länge von zwei), das eine einzelne Variante darstellt, oder eine Zeichenfolge, die die Standardvariante darstellt. Innerhalb eines Variantentupels ist das erste Element ein S-Ausdruck, der die Regel der Variante darstellt, und das zweite Element ist eine Zeichenfolge, die den Inhalt der Variante darstellt.

Damit der Agent diese Dateien richtig interpretieren kann, müssen Ihre lokalen Feature-Flag-Dateien die folgende Erweiterung haben:. application%ion%type=AWS.AppConfig.FeatureFlags. Beispiel, Local:MyFeatureFlags:SampleMV1.application%ion%type=AWS.AppConfig.FeatureFlags.

Beispiel 1: Eine Flagge mit mehreren Varianten, die eine gestaffelte Version einer neuen Funktion darstellt.

'tiered_release'::[
  [
    (or (and (eq $group "Tier1") (split by::$userId pct::1 seed::"2025.01.01")) (and (eq $group "Tier2") (split by::$userId pct::7 seed::"2025.01.01"))),
    '''{"_variant": "ShowFeature", "enabled": true}'''
  ],
  '''{"_variant": "HideFeature", "enabled": false}'''
]

Beispiel 2: Mehrere Flags, die je nach Benutzer-ID unterschiedliche UX-Displays repräsentieren. Die ersten beiden Flaggen sind variantenreich und die letzte Flagge ist einfach.

'colorway'::[
  [
    (contains $userId "beta"),
    '''{"_variant": "BetaTesters", "enabled": true, "background": "blue", "foreground": "red"}''',
  ],
  [
    (split by::$userId pct::10),
    '''{"_variant": "SplitRollOutRedAndBlue", "enabled": true, "background": "blue", "foreground": "red"}''',
  ],
  '''{"_variant": "default", "enabled": true, "background": "green", "foreground": "green"}''',
]

'simple_feature'::[
  [
    (contains $userId "beta"),
    '''{"_variant": "BetaTesters", "enabled": true}'''
  ],
  '''{"_variant": "default", "enabled": false}'''
]

'button_color'::'''{"enabled": true, "color": "orange"}'''