你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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

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

先决条件

创建应用配置存储区

  1. 若要创建新应用程序配置存储区,请登录 Azure 门户

  2. 在主页的左上角,选择“创建资源” 。

  3. 在“搜索服务和市场”框中,输入“应用程序配置”,然后选择 Enter

    显示“搜索应用程序配置”页面的屏幕截图。

  4. 在搜索结果中选择“应用程序配置”,然后选择“创建” 。

    显示“创建”页面的屏幕截图。

  5. 在“创建应用配置”窗格中,输入以下设置:

    设置 建议的值 说明
    订阅 订阅 选择要用来测试应用配置的 Azure 订阅。 如果帐户只有一个订阅,则会自动选择该订阅并且不显示“订阅”列表 。
    资源组 AppConfigTestResources 为应用程序配置存储区资源选择或创建资源组。 此组可用于组织多个资源,删除该资源组可以同时删除这些资源。 有关详细信息,请参阅使用资源组管理 Azure 资源
    资源名称 全局唯一名称 输入要用于应用程序配置存储区资源的唯一资源名称。 该名称必须是包含 5 到 50 个字符的字符串,只能包含数字、字母和 - 字符。 该名称的开头或末尾不能是 - 字符。
    位置 美国中部 使用“位置”指定在其中托管应用配置存储区的地理位置 。 为获得最佳性能,请在应用程序的其他组件所在的同一区域创建资源。
    定价层 免费 选择所需的定价层。 有关详细信息,请参阅应用配置定价页
  6. 选择“查看 + 创建”以验证自己的设置 。

  7. 选择“创建”。 部署可能需要几分钟。

  8. 部署完成后,转到“应用程序配置”资源。 选择“设置”“访问密钥”。 记下只读主密钥连接字符串。 稍后将使用此连接字符串来配置应用程序,以与创建的应用程序配置存储区进行通信。

  1. 选择“配置资源管理器”>“创建”>“键-值”来添加以下键值对 :

    密钥
    TestApp:Settings:Message Azure 应用配置的数据

    暂时将“标签”和“内容类型”保留为空 。

  2. 选择“应用”。

设置 Node.js 应用

  1. 在本教程中,你将为名为 app-configuration-quickstart 的项目创建一个新目录。

    mkdir app-configuration-quickstart
    
  2. 切换到新创建的 app-configuration-quickstart 目录。

    cd app-configuration-quickstart
    
  3. 使用 npm install 命令安装 Azure 应用程序配置客户端库。

    npm install @azure/app-configuration
    
  4. 在 app-configuration-quickstart 目录中,创建名为 app.js 的新文件,并添加以下代码 :

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

配置连接字符串

  1. 设置名为“AZURE_APP_CONFIG_CONNECTION_STRING”的环境变量,并将其设置为应用程序配置存储区的访问密钥。 在命令行中运行以下命令:

    $Env:AZURE_APP_CONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
    
  2. 重启命令提示符以使更改生效。 输出环境变量的值以验证其设置是否正确。

连接到应用程序配置存储区

以下代码片段使用环境变量中存储的连接字符串创建 AppConfigurationClient 实例。

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

获取配置设置

以下代码片段按 key 名称检索配置设置。 此示例中显示的键值是在本文的前面步骤中创建的。

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));

在本地生成并运行应用

  1. 运行以下命令以运行 Node.js 应用:

    node app.js
    
  2. 应在命令提示符处看到以下输出:

    Retrieved value: Data from Azure App Configuration
    

清理资源

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

重要

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

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

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

后续步骤

在本快速入门中,你创建了新的应用程序配置存储区,并了解到如何从 Node.js 应用访问键-值。

有关其他代码示例,请访问: