Snabbstart: Hantera funktionsflaggor i Azure App Configuration

Azure App Configuration tillhandahåller funktionshantering via funktionsflaggor, vilket gör det möjligt för team att dynamiskt kontrollera programfunktioner utan att distribuera om kod. Detta möjliggör säkra, riktade distributioner, snabbare experimentering och minskad risk, vilket ger utvecklare flexibel kontroll över appbeteende och möjlighet att snabbt svara på föränderliga affärs- eller kundbehov.

Funktionshanteraren i Azure-portalen tillhandahåller ett användargränssnitt för att skapa och hantera de funktionsflaggor som du använder i dina program.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa en kostnadsfritt.
• En App Configuration-butik, som visas i guiden för att skapa en App Configuration-butik.

Skapa en funktionsflagga

Skapa en ny funktionsflagga i Azure-portalen genom att följa stegen nedan.

1. Öppna din Azure App Configuration-butik i Azure-portalen. På resursmenyn går du till Åtgärder och väljer Funktionshanteraren>Skapa.

   

2. Under Vad ska du använda funktionsflaggan för? väljer du något av följande:

   • Växla – Växla funktioner på/av med en enkel växel. Använd för kortvariga driftväxlingar och scenarier där en enda på/av-kontroll räcker.
   • Distribution – Aktivera funktionen gradvis för en procentandel användare. Använd för gradvisa funktionslanseringar för att minska risken och för kanarieutgåvor eller etapperade distributioner i miljöer eller användarsegment.
   • Experiment – Kör kontrollerade experiment med trafikallokering för att fastställa vilken variant som fungerar bäst. Använd för A/B-testning, multivariatexperiment eller utvärdering av måttdrivna funktioner och andra scenarier som kräver statistisk jämförelse.
   Strömbrytare

   Använd Switch för att aktivera eller inaktivera funktioner direkt för alla användare.

   1. Konfigurera Grundläggande för att ange huvudegenskaperna för funktionsflaggan .

      Inställning	Exempelvärde	beskrivning
      Aktivera funktionsflagga	Växla på	Det här alternativet aktiverar funktionsflaggan när den skapas. Om du inaktiverar detta sparas konfigurationen för den nya funktionsflaggan, men den nya funktionsflaggan förblir inaktiverad.
      Namn på funktionsflagga	Beta	Namnet på funktionsflaggan är det du använder för att referera till flaggan i koden. Den måste vara unik i ett program.
      Nyckel	Beta	Du kan använda nyckeln för att filtrera funktionsflaggor som läses in i ditt program. Nyckeln genereras som standard från funktionsflaggans namn, men du kan också lägga till ett prefix eller ett namnområde för att gruppera dina funktionsflaggor, till exempel .appconfig.featureflag/Beta.
      Etikett	Lämna tom	Du kan använda etiketter för att skapa olika funktionsflaggor för samma nyckel och filtrera flaggor som läses in i ditt program baserat på etiketten. Som standard har en funktionsflagga ingen etikett.
      Beskrivning	Lämna tom	Lämna tom eller ange en beskrivning för funktionsflaggan.

      

   2. Konfigurera telemetri för att samla in utvärderingshändelser för den här funktionsflaggan. När det är aktiverat skickas utvärderingshändelser till telemetriutgivaren som du konfigurerar i ditt program. Innan du aktiverar telemetri länkar du en Application Insights-resurs till App Configuration Store i Telemetry>App Insights.

   3. Välj Granska + skapa för att se en sammanfattning av den nya funktionsflaggan och välj sedan Skapa för att slutföra åtgärden. Ett meddelande anger att den nya funktionsflaggan har skapats.

   Utrullning

   Använd Distribution för att progressivt exponera en funktion för en procentandel användare.

   1. Konfigurera Grundläggande för att ange huvudegenskaperna för funktionsflaggan .

      Inställning	Exempelvärde	beskrivning
      Aktivera funktionsflagga	Växla på	Det här alternativet aktiverar funktionsflaggan när den skapas. Om du inaktiverar detta sparas konfigurationen för den nya funktionsflaggan, men den nya funktionsflaggan förblir inaktiverad.
      Namn på funktionsflagga	Beta	Namnet på funktionsflaggan är det du använder för att referera till flaggan i koden. Den måste vara unik i ett program.
      Nyckel	Beta	Du kan använda nyckeln för att filtrera funktionsflaggor som läses in i ditt program. Nyckeln genereras som standard från funktionsflaggans namn, men du kan också lägga till ett prefix eller ett namnområde för att gruppera dina funktionsflaggor, till exempel .appconfig.featureflag/myapp/Beta.
      Etikett	Lämna tom	Du kan använda etiketter för att skapa olika funktionsflaggor för samma nyckel och filtrera flaggor som läses in i ditt program baserat på etiketten. Som standard har en funktionsflagga ingen etikett.
      Beskrivning	Lämna tom	Lämna tom eller ange en beskrivning för funktionsflaggan.

      **

   2. På fliken Målgrupp aktiverar du en funktionsflagga för en angiven procentandel eller inkluderar eller exkluderar uttryckligen grupper och användare.

      Inställning	Exempelvärde	beskrivning
      Standardprocent	0–100	Ange ett värde mellan 0 och 100 för att ange procentandelen användare som får funktionen som standard.
      Åsidosätt efter grupper	Av (avmarkerat)	Välj för att aktivera gruppbaserade åsidosättningar. När du är aktiverad kan du: Lägg till grupper som uttryckligen ska inkluderas i distributionen och ange procentandelen gruppmedlemmar som ska ta emot funktionen. Lägg till grupper som ska undantas från distributionen.
      Åsidosatt av användare	Av (avmarkerat)	Välj för att aktivera användarbaserad inriktning. När du är aktiverad kan du ange enskilda användare som ska inkluderas eller exkluderas.

   3. På fliken Konfiguration konfigurerar du värden för funktionsflaggan. Ditt program kan hämta lämplig konfiguration genom att utvärdera vilket värde som gäller för varje användare.

      Inställning	Exempelvärde	beskrivning
      Inkludera konfiguration	Rutan är markerad	Välj att koppla nyckel/värde-inställningar till funktionsflaggan. Med de här inställningarna kan ditt program justera beteendet dynamiskt utan att distribuera om kod.
      Gammal konfiguration	{"color":"blue"}	Visar de konfigurationsvärden som tidigare associerats med funktionsflaggan före den här uppdateringen. Använd detta för att jämföra ändringar och spåra versioner.
      Ny konfiguration	{"color":"green"}	Visar de uppdaterade konfigurationsvärden som du tillämpar nu. Dessa värden åsidosätter den gamla konfigurationen och definierar det nya beteendet när funktionsflaggan är aktiverad.

   4. Konfigurera villkor för att schemalägga ändringar och hantera anpassade begränsningar för att hantera dina funktioner.

      Inställning	Exempelvärde	beskrivning
      Lägg till schema	Start: 2025-11-01 Slut: 2025-11-15 Tidszon: (UTC-06:00) Centraltid (USA och Kanada) Upprepning: inaktiverad	Definiera en tidsbaserad distribution genom att ange start- och slutdatum. Du kan också uppdatera den föreslagna tidszonen och aktivera upprepning för upprepade aktiveringar.
      Lägg till anpassat villkor	User.Subscription == "Premium"	Skapa villkor baserat på anpassade attribut (till exempel region, enhetstyp eller prenumerationsnivå). Med villkor kan du rikta in dig på exakt vilka användare som får funktionen.
      Kräv att alla funktionsfilter är aktiverade	På (markerad)	Det här alternativet visas först när du har aktiverat både Lägg till anpassat villkor och Lägg till schema. När kontrollen är markerad måste alla aktiverade funktionsfilter utvärderas till true för att funktionen ska tillämpas (logisk AND). När de avmarkeras utvärderas filtren oberoende (logisk ELLER).

   5. Konfigurera telemetri för att samla in utvärderingshändelser för den här funktionsflaggan. När det är aktiverat skickas utvärderingshändelser till telemetriutgivaren som du konfigurerar i ditt program. Innan du aktiverar telemetri länkar du en Application Insights-resurs till App Configuration Store i Telemetry>App Insights.

   6. Välj Granska + skapa för att se en sammanfattning av den nya funktionsflaggan och välj sedan Skapa för att slutföra åtgärden. Ett meddelande anger att den nya funktionsflaggan har skapats.

   Experiment

   Använd Experiment för att köra A/B-tester och jämföra varianter.

   1. Konfigurera Grundläggande för att ange huvudegenskaperna för funktionsflaggan .

      Inställning	Exempelvärde	beskrivning
      Aktivera funktionsflagga	Växla på	Det här alternativet aktiverar funktionsflaggan när den skapas. Om du inaktiverar detta sparas konfigurationen för den nya funktionsflaggan, men den nya funktionsflaggan förblir inaktiverad.
      Namn på funktionsflagga	Beta	Namnet på funktionsflaggan är det du använder för att referera till flaggan i koden. Den måste vara unik i ett program.
      Nyckel	Beta	Du kan använda nyckeln för att filtrera funktionsflaggor som läses in i ditt program. Nyckeln genereras som standard från funktionsflaggans namn, men du kan också lägga till ett prefix eller ett namnområde för att gruppera dina funktionsflaggor, till exempel .appconfig.featureflag/myapp/Beta.
      Etikett	Lämna tom	Du kan använda etiketter för att skapa olika funktionsflaggor för samma nyckel och filtrera flaggor som läses in i ditt program baserat på etiketten. Som standard har en funktionsflagga ingen etikett.
      Beskrivning	Lämna tom	Lämna tom eller ange en beskrivning för funktionsflaggan.

      

   2. Konfigurera Varianter för att jämföra beteende, allokera trafik och köra riktade tester.

      Inställning	Exempelvärde	beskrivning
      Variantnamn	Variant 1	Ange ett unikt namn för varje variant.
      Värde	<your-variant-1-value>	Värdet som returneras för varianten. Det kan vara ett sträng-, tal-, booleskt eller JSON-objekt. Använd Redigera värde i flera linjer för komplex JSON-konfiguration som din app läser när du utvärderar flaggan.
      Standardvariant	Variant 1 (standardläge)	Välj en variant som stabil reserv och referens. Den här varianten returneras när ingen specifik tilldelning gäller eller när funktionsflaggan är inaktiverad. Det är också baslinjen som används för riktad allokering och kontrollerade tester.

   3. Konfigurera Allokering för att distribuera trafik mellan varianter och tillämpa åsidosättningar för specifika grupper eller användare.

      Inställning	Exempelvärde	beskrivning
      Trafikdistribution mellan varianter	Standard: 100% Variant 1: 0% Variant 2: 0%	Ange procentandelen trafik som allokeras till varje variant. Fördelningen för alla varianter måste uppgå till 100%. Använd det här alternativet för att styra hur målgruppen exponeras för olika varianter.
      Åsidosättningar för allokering	Åsidosättning av grupper/åsidosättning av användare	Tilldela specifika varianter till valda grupper eller enskilda användare oavsett procentbaserad allokering. När både grupp- och användaråsidosättningar gäller har användarens tilldelning företräde.
      Distribution (frö)	Använd anpassat frö: 12345	Som standard randomiseras percentilfördelningen. Ange ett fast frö för att producera deterministiska (repeterbara) allokeringar över funktionsflaggor som delar samma startvärde.

      Viktigt!

      Om funktionsutvärderingar sker i ett klientprogram (till exempel en webbläsare) kan funktionsflaggadata – inklusive användarnamn som anges här – exponeras för slutanvändarna. Mer information finns i Klientprogram i App Configuration.

   4. Konfigurera Villkor för att begränsa exponering, schemalägga ändringar och hantera anpassade begränsningar för att hantera dina funktioner.

      Inställning	Exempelvärde	beskrivning
      Begränsa exponering	Rutan är markerad	När du väljer det här alternativet visas ytterligare alternativ för att kontrollera exponeringen efter procentandel, grupper och användare. Om den är avmarkerad tillämpas funktionsflaggan globalt utan dessa begränsningar.
      Standardprocent	100	Visas endast när Gränsexponering är markerad. Ange ett värde mellan 0 och 100 för att ange procentandelen av hela användarbasen som tar emot funktionen som standard.
      Åsidosätt efter grupper	Inkludera: MarketingTeam (100%) Exkludera: TestGroup	Visas endast när Gränsexponering är markerad. Inkludera grupper för att aktivera funktionen för dem även om de ligger utanför standardprocenten. Exkludera grupper för att inaktivera funktionen för dem.
      Åsidosatt av användare	Inbegripa: john@example.com Utesluta: jane@example.com	Visas endast när Gränsexponering är markerad. Inkludera användare för att aktivera funktionen för dem även om de ligger utanför standardprocenten. Exkludera användare för att inaktivera funktionen för dem. För en lång lista över användare rekommenderar vi att du använder grupper i stället för användare, eftersom funktionsflaggor har en gräns på 10 kB.
      Lägg till schema	Start: 2025-11-01 Slut: 2025-11-15 Tidszon: (UTC-06:00) Centraltid (USA och Kanada) Upprepning: Varje vecka	Definiera en tidsbaserad distribution genom att ange start- och sluttider. Du kan också uppdatera den föreslagna tidszonen och aktivera upprepning för upprepade aktiveringar (till exempel varje vecka eller varje månad).
      Lägg till anpassat villkor	User.Region == "EU"	Skapa villkor baserat på anpassade attribut (till exempel region, enhetstyp eller prenumerationsnivå). Villkor tillåter exakt inriktning så att endast användare som matchar dessa kriterier får funktionen.
      Kräv att alla funktionsfilter är aktiverade	På (markerad)	Det här alternativet visas först när du har aktiverat flera villkor. När det är markerat måste alla aktiverade funktionsfilter utvärderas till true för att funktionsflaggan ska tillämpas (logisk AND). När de avmarkeras utvärderas filtren oberoende (logisk ELLER).

   5. Konfigurera telemetri för att samla in utvärderingshändelser för den här funktionsflaggan. När det är aktiverat skickas utvärderingshändelser till telemetriutgivaren som du konfigurerar i ditt program. Innan du aktiverar telemetri länkar du en Application Insights-resurs till App Configuration Store i Telemetry>App Insights.

   6. Välj Granska + skapa för att se en sammanfattning av den nya funktionsflaggan och välj sedan Skapa för att slutföra åtgärden. Ett meddelande anger att den nya funktionsflaggan har skapats.

Redigera funktionsflaggor

Följ dessa steg för att uppdatera en funktionsflagga:

1. Gå till Operations>Feature Manager på resursmenyn.

2. Flytta till höger i funktionsflaggan som du vill ändra och välj ellipsen Fler åtgärder (...). På den här menyn kan du visa information om funktionsflaggan, redigera flaggan, låsa eller låsa upp den, skapa en etikett, uppdatera taggar, granska historiken eller ta bort flaggan.

3. Välj Redigera för att göra ändringar med hjälp av det visuella redigeringsprogrammet eller Avancerad redigering för att ändra flaggans råa JSON direkt.

4. Du kan också ändra funktionsflaggans tillstånd genom att aktivera eller inaktivera växlingsknappen Aktiverad .

Hantera vy

Menyn Funktionshanteraren visar funktionsflaggor som lagras i Azure App Configuration. Du kan ändra visning av funktionshanteraren i Azure Portal genom att välja Hantera vy.

• Med inställningar kan du välja hur många funktionsflaggor som läses in per åtgärden Läs in mer . Läs in fler visas bara om det finns fler än 200 funktionsflaggor.

• Med Redigera kolumner kan du lägga till eller ta bort kolumner och ändra kolumnordningen.

  

Funktionsflaggor som skapas med Funktionshanteraren lagras som vanliga nyckelvärden. De behålls med specialprefixet .appconfig.featureflag/ och innehållstypen application/vnd.microsoft.appconfig.ff+json;charset=utf-8.

Följ stegen nedan om du vill visa underliggande nyckelvärden för funktionsflaggor i Configuration Explorer.

1. På resursmenyn väljer du Operations>Configuration Explorer och sedan Hantera vyinställningar>.

   

2. Välj Inkludera funktionsflaggor i konfigurationsutforskaren och Använd.

Relaterat innehåll

Om du vill börja använda funktionsflaggor med Azure App Configuration fortsätter du till följande snabbstarter som är specifika för programmets språk eller plattform.

• ASP.NET Core
• .NET/.NET Framework
• .NET-bakgrundstjänst
• Java Spring
• Python
• JavaScript
• Azure Kubernetes Service
• Azure Functions