Självstudie: Använda dynamisk konfiguration i JavaScript

I den här självstudien får du lära dig hur du aktiverar dynamisk konfiguration i dina JavaScript-program. Exemplet i den här självstudien bygger på exempelprogrammet som introducerades i JavaScript-snabbstarten. Slutför Skapa en JavaScript-app med Azure App Configuration innan du fortsätter.

Förutsättningar

• Slutför snabbstarten Skapa en JavaScript-app med Azure App Configuration.

Lägga till nyckelvärden

Lägg till följande nyckelvärde i Azure App Configuration Store. Mer information om hur du lägger till nyckelvärden i ett arkiv med hjälp av Azure Portal eller CLI finns i Skapa ett nyckelvärde.

Tangent	Värde	Etikett	Innehållstyp
meddelande	Hej världen!	Lämna tom	Lämna tom
vaktpost	1	Lämna tom	Lämna tom

Kommentar

En sentinel-nyckel är en nyckel som du uppdaterar när du har slutfört ändringen av alla andra nycklar. Appen övervakar sentinel-nyckeln. När en ändring identifieras uppdaterar appen alla konfigurationsvärden. Den här metoden hjälper till att säkerställa konsekvensen i konfigurationen i din app och minskar det totala antalet begäranden som görs till Azure App Configuration Store, jämfört med övervakning av alla nycklar för ändringar.

Läsa in data på nytt från App Configuration

Följande exempel visar hur du använder uppdateringsbara konfigurationsvärden i konsolprogram. Välj följande instruktioner baserat på hur ditt program använder konfigurationsdata som lästs in från App Configuration, antingen som ett Map eller ett konfigurationsobjekt.

Du kan ansluta till App Configuration med antingen Microsoft Entra-ID (rekommenderas) eller en anslutningssträng. Följande kodfragment visar hur du använder Microsoft Entra-ID. Du använder StandardAzureCredential för att autentisera till appkonfigurationsarkivet. När du slutförde snabbstarten som anges i förhandskraven har du redan tilldelat autentiseringsuppgifterna rollen AppKonfigurationsdataläsare.

1. Öppna filen app.js och uppdatera load funktionen. Lägg till en refreshOptions parameter för att aktivera uppdatering och konfigurera uppdateringsalternativ. Den inlästa konfigurationen uppdateras när en ändring identifieras på servern. Som standard används ett uppdateringsintervall på 30 sekunder, men du kan åsidosätta det med refreshIntervalInMs egenskapen .

   Använda konfiguration som karta

   // Connecting to Azure App Configuration using endpoint and token credential
   const settings = await load(endpoint, credential, {
       // Setting up to refresh when the sentinel key is changed
       refreshOptions: {
           enabled: true,
           watchedSettings: [{ key: "sentinel" }] // Watch for changes to the key "sentinel" and refreshes the configuration when it changes
       }
   });
   

   Använda konfiguration som objekt

   Konfigurationsobjektet skapas genom att anropa constructConfigurationObject funktionen. För att säkerställa en uppdaterad konfiguration uppdaterar du konfigurationsobjektet i återanropet onRefresh som utlöses när en konfigurationsändring identifieras och konfigurationen uppdateras.

   // Connecting to Azure App Configuration using endpoint and token credential
   const settings = await load(endpoint, credential, {
       // Setting up to refresh when the sentinel key is changed
       refreshOptions: {
           enabled: true,
           watchedSettings: [{ key: "sentinel" }] // Watch for changes to the key "sentinel" and refreshes the configuration when it changes
       }
   });
   
   // Constructing configuration object
   let config = settings.constructConfigurationObject();
   
   // Setting up callback to ensure `config` object is updated once configuration is changed.
   settings.onRefresh(() => {
       config = settings.constructConfigurationObject();
   });
   
   

2. Konfigurationen uppdateras inte automatiskt när du konfigurerar refreshOptions den. Du måste anropa refresh metoden för att utlösa en uppdatering. Den här designen förhindrar onödiga begäranden till App Configuration när programmet är inaktivt. Du bör inkludera anropet där programaktiviteten refresh inträffar. Detta kallas aktivitetsdriven konfigurationsuppdatering. Du kan till exempel anropa refresh när du bearbetar ett inkommande meddelande eller en order, eller i en iteration där du utför en komplex uppgift. Du kan också använda en timer om programmet alltid är aktivt. I det här exemplet refresh anropas i en loop i demonstrationssyfte. Även om anropet refresh misslyckas av någon anledning fortsätter programmet att använda den cachelagrade konfigurationen. Ett annat försök görs när det konfigurerade uppdateringsintervallet har passerat och anropet utlöses av programaktiviteten refresh . Anrop refresh är en no-op innan det konfigurerade uppdateringsintervallet förflutit, så dess prestandapåverkan är minimal även om den anropas ofta.

   Lägg till följande kod för att avsöka konfigurationsändringar av övervakade nyckelvärden.

   Använda konfiguration som karta

   // Polling for configuration changes every 5 seconds
   while (true) {
       await sleepInMs(5000); // Waiting before the next refresh
       await settings.refresh(); // Refreshing the configuration setting
       console.log(settings.get("message")); // Consume current value of message from a Map
   }
   

   Använda konfiguration som objekt

   // Polling for configuration changes every 5 seconds
   while (true) {
       await sleepInMs(5000); // Waiting before the next refresh
       await settings.refresh(); // Refreshing the configuration setting
       console.log(config.message); // Consume current value of message from an object
   }
   

3. Nu bör filen app.js se ut som följande kodfragment:

   Använda konfiguration som karta

   const sleepInMs = require("util").promisify(setTimeout);
   const { load } = require("@azure/app-configuration-provider");
   const { DefaultAzureCredential } = require("@azure/identity");
   const endpoint = process.env.AZURE_APPCONFIG_ENDPOINT;
   const credential = new DefaultAzureCredential(); // For more information, see https://learn.microsoft.com/azure/developer/javascript/sdk/credential-chains#use-defaultazurecredential-for-flexibility
   
   async function run() {
       // Connecting to Azure App Configuration using endpoint and token credential
       const settings = await load(endpoint, credential, {
           // Setting up to refresh when the sentinel key is changed
           refreshOptions: {
               enabled: true,
               watchedSettings: [{ key: "sentinel" }] // Watch for changes to the key "sentinel" and refreshes the configuration when it changes
           }
       });
   
       // Polling for configuration changes every 5 seconds
       while (true) {
           await sleepInMs(5000); // Waiting before the next refresh
           await settings.refresh(); // Refreshing the configuration setting
           console.log(settings.get("message")); // Consume current value of message from a Map
       }
   }
   
   run().catch(console.error);
   

   Använda konfiguration som objekt

   const sleepInMs = require("util").promisify(setTimeout);
   const { load } = require("@azure/app-configuration-provider");
   const { DefaultAzureCredential } = require("@azure/identity");
   const endpoint = process.env.AZURE_APPCONFIG_ENDPOINT;
   const credential = new DefaultAzureCredential(); // For more information, see https://learn.microsoft.com/azure/developer/javascript/sdk/credential-chains#use-defaultazurecredential-for-flexibility
   
   async function run() {
       // Connecting to Azure App Configuration using endpoint and token credential
       const settings = await load(endpoint, credential, {
           // Setting up to refresh when the sentinel key is changed
           refreshOptions: {
               enabled: true,
               watchedSettings: [{ key: "sentinel" }] // Watch for changes to the key "sentinel" and refreshes the configuration when it changes
           }
       });
   
       // Constructing configuration object
       let config = settings.constructConfigurationObject();
   
       // Setting up callback to ensure `config` object is updated once configuration is changed.
       settings.onRefresh(() => {
           config = settings.constructConfigurationObject();
       });
   
       // Polling for configuration changes every 5 seconds
       while (true) {
           await sleepInMs(5000); // Waiting before the next refresh
           await settings.refresh(); // Refreshing the configuration setting
           console.log(config.message); // Consume current value of message from an object
       }
   }
   
   run().catch(console.error);
   

Kör appen

1. Kör skriptet:

   node app.js
   

2. Verifiera utdata:

   Hello World!
   

   Den fortsätter att skriva ut "Hello World!" på en ny rad var 5:e sekund.

3. Uppdatera följande nyckelvärden till Azure App Configuration Store. Uppdatera värdet för nyckeln message först och sedan sentinel.

   Tangent	Värde	Etikett	Innehållstyp
   meddelande	Hello World - Uppdaterad!	Lämna tom	Lämna tom
   vaktpost	2	Lämna tom	Lämna tom

4. När värdena har uppdaterats skrivs det uppdaterade värdet ut efter uppdateringsintervallet.

   Hello World - Updated!
   

Rensa resurser

Om du inte vill fortsätta använda resurserna som skapas i den här artikeln tar du bort resursgruppen som du skapade här för att undvika avgifter.

Viktigt!

Att ta bort en resursgrupp kan inte ångras. Resursgruppen och alla resurser i den tas bort permanent. Se till att du inte oavsiktligt tar bort fel resursgrupp eller resurser. Om du har skapat resurserna för den här artikeln i en resursgrupp som innehåller andra resurser som du vill behålla tar du bort varje resurs individuellt från respektive fönster i stället för att ta bort resursgruppen.

1. Logga in på Azure Portal och välj Resursgrupper.
2. I rutan Filtrera efter namn anger du namnet på resursgruppen.
3. I resultatlistan väljer du resursgruppens namn för att se en översikt.
4. Välj Ta bort resursgrupp.
5. Du blir ombedd att bekräfta borttagningen av resursgruppen. Ange namnet på resursgruppen för att bekräfta och välj Ta bort.

Efter en liten stund tas resursgruppen och alla dess resurser bort.

Nästa steg

I den här självstudien har du aktiverat JavaScript-appen för att dynamiskt uppdatera konfigurationsinställningarna från Azure App Configuration. Om du vill lära dig hur du använder en hanterad Azure-identitet för att effektivisera åtkomsten till Azure App Configuration fortsätter du till nästa självstudie.

Integrering av hanterad identitet