Guida introduttiva: Gestire i flag di funzionalità nella configurazione di app Azure
app Azure Configurazione include flag di funzionalità, che è possibile usare per abilitare o disabilitare una funzionalità e flag di funzionalità varianti (anteprima), che consentono più varianti di un flag di funzionalità.
Gestione funzionalità nella portale di Azure fornisce un'interfaccia utente per creare e gestire i flag di funzionalità e i flag di funzionalità varianti usati nelle applicazioni.
Prerequisiti
- Un account Azure con una sottoscrizione attiva. Crearne una gratuitamente.
- Archivio Configurazione app. Creare un archivio.
Creare un flag di funzionalità
Aggiungere un nuovo flag di funzionalità seguendo la procedura seguente.
Aprire l'archivio di configurazione app Azure nel portale di Azure e dal menu Operazioni selezionare Gestione>funzionalità Crea. Selezionare quindi Flag di funzionalità.
In Crea selezionare o immettere le informazioni seguenti:
Impostazione Valore di esempio Descrizione Abilitare il flag di funzionalità Casella selezionata Questa opzione abilita il flag di funzionalità al momento della creazione. Se si lascia deselezionata questa casella, la configurazione del nuovo flag di funzionalità verrà salvata, ma il nuovo flag di funzionalità rimarrà disabilitato. Nome del flag di funzionalità Beta Il nome del flag di funzionalità è quello usato per fare riferimento al flag nel codice. Deve essere univoco all'interno di un'applicazione. Chiave Beta È possibile usare la chiave per filtrare i flag di funzionalità caricati nell'applicazione. La chiave viene generata dal nome del flag di funzionalità per impostazione predefinita, ma è anche possibile aggiungere un prefisso o uno spazio dei nomi per raggruppare i flag di funzionalità, ad esempio .appconfig.featureflag/myapp/Beta. Etichetta Lasciare vuoto È possibile usare le etichette per creare flag di funzionalità diversi per la stessa chiave e flag di filtro caricati nell'applicazione in base all'etichetta. Per impostazione predefinita, un flag di funzionalità non ha alcuna etichetta. Descrizione Lasciare vuoto Lasciare vuota o immettere una descrizione per il flag di funzionalità. Usare il filtro delle funzionalità Casella deselezionata Lasciare deselezionata la casella filtro funzionalità. Per altre informazioni sui filtri delle funzionalità, vedere Usare i filtri delle funzionalità per abilitare i flag di funzionalità condizionali e Abilitare l'implementazione a fasi delle funzionalità per i destinatari di destinazione. Selezionare Applica per creare il flag di funzionalità.
Creare un flag di funzionalità variante (anteprima)
Aggiungere un nuovo flag di funzionalità varianti (anteprima) aprendo l'archivio di configurazione app Azure nel portale di Azure e dal menu Operazioni selezionare Gestione>funzionalità Crea. Selezionare quindi Flag di funzionalità varianti (anteprima).
Configurare le informazioni di base
Nelle schede Dettagli selezionare o immettere le informazioni seguenti:
| Impostazione | Valore di esempio | Descrizione |
|---|---|---|
| Abilitare il flag di funzionalità | Casella selezionata | Questa opzione abilita il flag di funzionalità al momento della creazione. Se si lascia deselezionata questa casella, la configurazione del nuovo flag di funzionalità verrà salvata, ma il nuovo flag di funzionalità rimarrà disabilitato. |
| Nome | Greeting | Il nome del flag di funzionalità è quello usato per fare riferimento al flag nel codice. Deve essere univoco all'interno di un'applicazione. |
| Chiave | Greeting | È possibile usare la chiave per filtrare i flag di funzionalità caricati nell'applicazione. La chiave viene generata dal nome del flag di funzionalità per impostazione predefinita, ma è anche possibile aggiungere un prefisso o uno spazio dei nomi per raggruppare i flag di funzionalità, ad esempio .appconfig.featureflag/myapp/Greeting. |
| Etichetta | Lasciare vuoto | È possibile usare le etichette per creare flag di funzionalità diversi per la stessa chiave e flag di filtro caricati nell'applicazione in base all'etichetta. Per impostazione predefinita, un flag di funzionalità non ha alcuna etichetta. |
| Descrizione | Lasciare vuoto | Lasciare vuota o immettere una descrizione per il flag di funzionalità. |
Selezionare Avanti>per aggiungere varianti.
Aggiungere varianti
Nella scheda Varianti selezionare o immettere le informazioni seguenti.
| Impostazione | Valore di esempio | Descrizione |
|---|---|---|
| Nome variante | Off & On | Per impostazione predefinita, vengono aggiunte due varianti. Aggiornarli o immettere un nome per una nuova variante. I nomi delle varianti devono essere univoci all'interno di un flag di funzionalità. |
| valore | false & true | Specificare un valore per ogni variante. Il valore può essere una stringa, un numero, un valore booleano o un oggetto di configurazione. Per modificare il valore in un editor JSON, è possibile selezionare Modifica valore in più righe. |
| Variante predefinita | Disattivato | Scegliere la variante predefinita dall'elenco a discesa. Il flag di funzionalità restituisce la variante predefinita quando nessuna variante viene assegnata a un gruppo di destinatari o il flag di funzionalità è disabilitato. Accanto alla variante predefinita designata, viene visualizzata la parola Default . |
Selezionare Avanti > per accedere alle impostazioni di allocazione .
Allocare il traffico
Nella scheda Allocazione selezionare o immettere le informazioni seguenti:
Distribuire il traffico in ogni variante, aggiungendo fino al 100%.
Facoltativamente, selezionare le opzioni Override by Groups (Sostituisci per gruppi ) e Override by Users (Sostituisci per utenti ) per assegnare varianti per i gruppi o gli utenti selezionati. Queste opzioni sono disabilitate per impostazione predefinita.
In Distribuzione selezionare Facoltativamente Usa valore di inizializzazione personalizzato e specificare una stringa non valida come nuovo valore di inizializzazione. L'uso di un valore di inizializzazione comune tra più flag di funzionalità consente allo stesso utente di essere allocato allo stesso percentile. È utile quando si distribuiscono più flag di funzionalità contemporaneamente e si vuole garantire un'esperienza coerente per ogni segmento del pubblico. Se non viene specificato alcun valore di inizializzazione personalizzato, viene usato un valore di inizializzazione predefinito in base al nome della funzionalità.
Selezionare Rivedi e crea per visualizzare un riepilogo del nuovo flag di funzionalità varianti e quindi selezionare Crea per finalizzare l'operazione. Una notifica indica che il nuovo flag di funzionalità è stato creato correttamente.
Modificare i flag di funzionalità
Per aggiornare un flag di funzionalità o un flag di funzionalità varianti:
Dal menu Operazioni selezionare Gestione funzionalità.
Passare alla fine destra del flag di funzionalità o del flag di funzionalità variante da modificare e selezionare i puntini di sospensione Altre azioni (...). Da questo menu è possibile modificare il flag, bloccarlo o sbloccarlo, creare un'etichetta, aggiornare i tag, esaminare la cronologia o eliminare il flag.
Selezionare Modifica e aggiornare il flag.
Facoltativamente, modificare lo stato di un flag di funzionalità attivando o disattivando l'interruttore Abilitato .
Gestisci visualizzazioni
Il menu Gestione funzionalità visualizza i flag di funzionalità e i flag di funzionalità varianti archiviati in app Azure Configurazione. È possibile modificare la visualizzazione gestione funzionalità nella portale di Azure selezionando Gestisci visualizzazione.
Impostazioni consente di scegliere il numero di flag di funzionalità che verranno caricati per ogni azione Carica più. Il caricamento di più sarà visibile solo se sono presenti più di 200 flag di funzionalità.
Modifica colonne consente di aggiungere o rimuovere colonne e modificare l'ordine delle colonne.
I flag di funzionalità creati con Gestione funzionalità vengono archiviati come normali valori chiave-valore. Vengono mantenuti con il prefisso .appconfig.featureflag/ speciale e il tipo di application/vnd.microsoft.appconfig.ff+json;charset=utf-8contenuto . Per visualizzare i valori chiave sottostanti dei flag di funzionalità in Esplora configurazione, seguire questa procedura.
Nel menu Operazioni aprire Esplora configurazione, quindi selezionare Gestisci visualizzazione> Impostazioni.
Selezionare Includi flag di funzionalità in Esplora configurazione e Applica.