快速入门：使用 Azure 应用程序配置创建 JavaScript 应用

项目
12/29/2023

在本快速入门中，你将使用 Azure 应用程序配置 JavaScript 提供程序客户端库通过 Azure 应用程序配置来集中存储和管理应用程序设置。

适用于 JavaScript 的应用程序配置提供程序基于 Azure SDK for JavaScript 构建，旨在更轻松地用于更丰富的功能。它允许以 Map 对象的形式访问应用程序配置中的键值。它提供了从多个标签组合配置、密钥前缀剪裁、Key Vault 引用自动解析等功能。作为示例，本教程演示如何在 Node.js 应用中使用 JavaScript 提供程序。

先决条件

具有活动订阅的 Azure 帐户。创建试用版订阅。
应用程序配置存储区。创建存储区。
LTS 版本的 Node.js。有关直接在 Windows 上或使用适用于 Linux 的 Windows 子系统 (WSL) 安装 Node.js 的信息，请参阅 Node.js 入门

添加键值

将以下键值添加到应用程序配置存储区。有关如何使用 Azure 门户或 CLI 将键值添加到存储区的详细信息，请转到创建键值。

密钥	值	内容类型
message	来自 Azure 应用程序配置的消息	留空
app.greeting	Hello World	留空
app.json	{"myKey":"myValue"}	application/json

设置 Node.js 应用

在本教程中，你将创建一个 Node.js 控制台应用并从你的应用程序配置存储中加载数据。

为名为 app-configuration-quickstart 的项目创建一个新目录。
```
mkdir app-configuration-quickstart
```
切换到新创建的 app-configuration-quickstart 目录。
```
cd app-configuration-quickstart
```
使用 npm install 命令安装 Azure 应用配置提供程序。
```
npm install @azure/app-configuration-provider
```

在 app-configuration-quickstart 目录中，创建名为 app.js 的新文件，并添加以下代码：

const { load } = require("@azure/app-configuration-provider");
const connectionString = process.env.AZURE_APPCONFIG_CONNECTION_STRING;

async function run() {
    let settings;

    // Sample 1: Connect to Azure App Configuration using a connection string and load all key-values with null label.
    settings = await load(connectionString);

    // Find the key "message" and print its value.
    console.log(settings.get("message"));  // Output: Message from Azure App Configuration

    // Find the key "app.json" as an object, and print its property "myKey".
    const jsonObject = settings.get("app.json");
    console.log(jsonObject.myKey);  // Output: myValue

    // Sample 2: Load all key-values with null label and trim "app." prefix from all keys.
    settings = await load(connectionString, {
      trimKeyPrefixes: ["app."]
    });

    // From the keys with trimmed prefixes, find a key with "greeting" and print its value.
    console.log(settings.get("greeting")); // Output: Hello World

    // Sample 3: Load all keys starting with "app." prefix and null label.
    settings = await load(connectionString, {
      selectors: [{
        keyFilter: "app.*"
      }],
    });

    // Print true or false indicating whether a setting is loaded.
    console.log(settings.has("message")); // Output: false
    console.log(settings.has("app.greeting")); // Output: true
    console.log(settings.has("app.json")); // Output: true
}

run().catch(console.error);

在本地运行应用程序

设置名为 AZURE_APPCONFIG_CONNECTION_STRING 的环境变量，并将其设置为应用程序配置存储的连接字符串。在命令行中运行以下命令：
要使用 Windows 命令提示符在本地运行应用，请运行以下命令并将 <app-configuration-store-connection-string> 替换为你的应用程序配置存储的连接字符串：
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<app-configuration-store-connection-string>"
```
如果使用 Windows PowerShell，请运行以下命令并将 <app-configuration-store-connection-string> 替换为应用程序配置存储的连接字符串：
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<app-configuration-store-connection-string>"
```
如果使用 macOS，请运行以下命令并将 <app-configuration-store-connection-string> 替换为应用程序配置存储的连接字符串：
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
如果使用 Linux，请运行以下命令并将 <app-configuration-store-connection-string> 替换为应用程序配置存储的连接字符串：
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
使用以下命令输出环境变量的值，以验证其设置是否正确。
使用 Windows 命令提示符时，重启命令提示符使更改生效，然后运行以下命令：
```
echo %AZURE_APPCONFIG_CONNECTION_STRING%
```
如果使用 Windows PowerShell，请运行以下命令：
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING
```
如果使用 macOS，请运行以下命令：
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
如果使用 Linux，请运行以下命令：
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
正确设置环境变量后，请运行以下命令以在本地运行应用：
```
node app.js
```
应该会看到以下输出：
```
Message from Azure App Configuration
myValue
Hello World
false
true
true
```

清理资源

如果不想继续使用本文中创建的资源，请删除此处创建的资源组以避免产生费用。

重要

删除资源组的操作不可逆。将永久删除资源组以及其中的所有资源。请确保不要意外删除错误的资源组或资源。如果在包含要保留的其他资源的资源组中创建了本文的资源，请从相应的窗格中单独删除每个资源，而不是删除该资源组。

登录到 Azure 门户，然后选择“资源组”。
在“按名称筛选”框中，输入资源组的名称。
在结果列表中，选择资源组名称以查看概述。
选择“删除资源组”。
系统会要求确认是否删除资源组。重新键入资源组的名称进行确认，然后选择“删除” 。

片刻之后，将会删除该资源组及其所有资源。

后续步骤

在本快速入门中，你创建了一个新的应用程序配置存储，并学习了如何在 Node.js 应用中使用应用程序配置 JavaScript 提供程序访问键值。

如需更多代码示例，请访问：

Azure 应用程序配置 JavaScript 提供程序