Skip to content

Latest commit

 

History

History
138 lines (92 loc) · 4.71 KB

quickstart-javascript.md

File metadata and controls

138 lines (92 loc) · 4.71 KB
title description services author ms.service ms.devlang ms.topic ms.custom ms.date ms.author
Quickstart for using Azure App Configuration with JavaScript apps | Microsoft Docs
In this quickstart, create a Node.js app with Azure App Configuration to centralize storage and management of application settings separate from your code.
azure-app-configuration
maud-lv
azure-app-configuration
javascript
quickstart
quickstart, mode-other
07/12/2021
malev

Quickstart: Create a JavaScript app with Azure App Configuration

In this quickstart, you will use Azure App Configuration to centralize storage and management of application settings using the App Configuration client library for JavaScript.

Prerequisites

Create an App Configuration store

[!INCLUDE azure-app-configuration-create]

  1. Select Configuration Explorer > Create > Key-value to add the following key-value pairs:

    Key Value
    TestApp:Settings:Message Data from Azure App Configuration

    Leave Label and Content Type empty for now.

  2. Select Apply.

Setting up the Node.js app

  1. In this tutorial, you'll create a new directory for the project named app-configuration-quickstart.

    mkdir app-configuration-quickstart

  2. Switch to the newly created app-configuration-quickstart directory.

    cd app-configuration-quickstart

  3. Install the Azure App Configuration client library by using the npm install command.

    npm install @azure/app-configuration

  4. Create a new file called app.js in the app-configuration-quickstart directory and add the following code:

    const appConfig = require("@azure/app-configuration");

Configure your connection string

  1. Set an environment variable named AZURE_APP_CONFIG_CONNECTION_STRING, and set it to the access key to your App Configuration store. At the command line, run the following command:

    PowerShell

    $Env:AZURE_APP_CONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"

    Command line

    setx AZURE_APP_CONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"

    macOS

    export AZURE_APP_CONFIG_CONNECTION_STRING='connection-string-of-your-app-configuration-store'

  2. Restart the command prompt to allow the change to take effect. Print out the value of the environment variable to validate that it is set properly.

Connect to an App Configuration store

The following code snippet creates an instance of AppConfigurationClient using the connection string stored in your environment variables.

const connection_string = process.env.AZURE_APP_CONFIG_CONNECTION_STRING;
const client = new appConfig.AppConfigurationClient(connection_string);

Get a configuration setting

The following code snippet retrieves a configuration setting by key name. The key shown in this example was created in the previous steps of this article.

async function run() {
  
  let retrievedSetting = await client.getConfigurationSetting({
    key: "TestApp:Settings:Message"
  });

  console.log("Retrieved value:", retrievedSetting.value);
}

run().catch((err) => console.log("ERROR:", err));

Build and run the app locally

  1. Run the following command to run the Node.js app:

    node app.js

  2. You should see the following output at the command prompt:

    Retrieved value: Data from Azure App Configuration

Clean up resources

[!INCLUDE azure-app-configuration-cleanup]

Next steps

In this quickstart, you created a new App Configuration store and learned how to access key-values from a Node.js app.

For additional code samples, visit:

[!div class="nextstepaction"] Azure App Configuration client library samples