Creazione di un contrassegno di funzionalità con più varianti

Apri la AWS Systems Manager console all'indirizzo. https://console.aws.amazon.com/systems-manager/appconfig/

Nel pannello di navigazione, scegli Applicazioni, quindi scegli un'applicazione.

Nella scheda Profili di configurazione e feature flag, scegliete un profilo di configurazione dei feature flag esistente.

Nella sezione Bandiere, scegli Aggiungi nuovo flag.

Nella sezione Feature flag definition, per Nome contrassegno, inserisci un nome.

Per Flag key, inserite un identificatore di bandiera per distinguere i flag all'interno dello stesso profilo di configurazione. I flag all'interno dello stesso profilo di configurazione non possono avere la stessa chiave. Dopo aver creato il flag, puoi modificare il nome del flag, ma non la chiave del flag.

(Facoltativo) Nel campo Descrizione, inserisci le informazioni su questa bandiera.

Nella sezione Varianti, scegli Multi-variant contrassegno.

(Facoltativo) Nella sezione Attributi del flag della funzione, scegli Definisci attributo. Gli attributi consentono di fornire valori aggiuntivi all'interno del flag. Per ulteriori informazioni su attributi e vincoli, vedereComprendere gli attributi dei feature flag.

1. Per Chiave, specificate una chiave contrassegnata e sceglietene il tipo dall'elenco Tipo. Per informazioni sulle opzioni supportate per i campi Valore e Vincoli, vedete la sezione sugli attributi a cui si fa riferimento in precedenza.

2. Selezionate Valore richiesto per specificare se un valore di attributo è obbligatorio.

3. Scegliete Definisci attributo per aggiungere altri attributi.

4. Scegliete Applica per salvare le modifiche agli attributi.

Nella sezione Feature flag variant, scegli Crea variante.

1. Per Nome variante, inserisci un nome.

2. Usa l'interruttore Valore abilitato per abilitare la variante.

3. Nella casella di testo Regola, inserisci una regola.

4. Utilizzate le opzioni Crea variante > Crea variante sopra o Crea variante sotto per creare varianti aggiuntive per questo contrassegno.

5. Nella sezione Variante predefinita, usa l'interruttore Valore abilitato per abilitare la variante predefinita. Facoltativamente, fornisci i valori per gli attributi definiti nel passaggio 10.

6. Scegli Applica.

Verifica i dettagli della bandiera e delle sue varianti e scegli Crea bandiera.

Create un file di configurazione sul computer locale che specifichi i dettagli del flag multivariante da creare. Salvate il file con un'.jsonestensione. Il file deve rispettare lo schema AWS.AppConfig.FeatureFlags JSON. Il contenuto dello schema del file di configurazione sarà simile al seguente.

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

Ecco un esempio con tre varianti e la variante predefinita.

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

Usa l'CreateHostedConfigurationVersionAPI per salvare i dati di configurazione del feature flag in AWS AppConfig.

service_returned_content_fileContiene i dati di configurazione che includono alcuni AWS AppConfig metadati generati.