在 Azure Stack Hub 中将 API 版本配置文件与 Node.js 软件开发工具包 (SDK) 配合使用

Node.js 与 API 版本配置文件

可以使用 Node.js SDK 来帮助构建和管理应用的基础结构。 Node.js SDK 中的 API 配置文件可让你在 Azure 资源与 Azure Stack Hub 资源之间切换,为开发混合云解决方案提供帮助。 只需编写代码一次,即可将目标限定于 Azure 和 Azure Stack Hub。

在本文中,可以使用 Visual Studio Code 作为开发工具。 Visual Studio Code 可以调试 Node.js SDK,并可让你运行应用并将其推送到 Azure Stack Hub 实例。 可以通过 Visual Studio Code 或者在终端窗口中运行 node <nodefile.js> 命令进行调试。

Node.js SDK

Node.js SDK 提供 Azure Stack Hub 资源管理器工具。 该 SDK 中的资源提供程序包括了计算、网络、存储、应用服务和 KeyVault。 可在 Node.js 应用程序中安装的资源提供程序客户端库有 10 个。 还可以下载指定要用于 2020-09-01-profile 的资源提供程序,以优化应用程序的内存。 每个模块包括资源提供程序、相应的 API 版本和 API 配置文件。

API 配置文件是资源提供程序和 API 版本的组合。 可以使用 API 配置文件获取资源提供程序包中每个资源类型的最新且最稳定的版本。

  • 若要使用所有服务的最新版本,请使用包的 latest 配置文件。

  • 若要使用与 Azure Stack Hub 兼容的服务,请使用 @azure/arm-resources-profile-hybrid-2020-09-01 或 @azure/arm-storage-profile-2020-09-01-hybrid

NPM 包

每个资源提供程序都有自身的包。 可以从 npm 注册表获取包。

可以找到以下包:

资源提供程序 程序包
应用服务 @azure/arm-resources-profile-2020-09-01-hybrid
Azure 资源管理器订阅 @azure/arm-subscriptions-profile-hybrid-2020-09-01
Azure 资源管理器策略 @azure/arm-policy-profile-hybrid-2020-09-01
Azure 资源管理器 DNS @azure/arm-dns-profile-2020-09-01-hybrid
授权 @azure/arm-authorization-profile-2020-09-01-hybrid
计算 @azure/arm-compute-profile-2020-09-01-hybrid
存储 @azure/arm-storage-profile-2020-09-01-hybrid
网络 @azure/arm-network-profile-2020-09-01-hybrid
资源 @azure/arm-resources-profile-hybrid-2020-09-01
Keyvault @azure/arm-keyvault-profile-2020-09-01-hybrid

若要使用某个服务的最新 API 版本,请使用特定客户端库的最新配置文件。 例如,若要单独使用资源服务的最新 API 版本,请使用资源管理客户端库包的 azure-arm-resource 配置文件。

对于资源提供程序的特定 API 版本,请使用包中定义的特定 API 版本。

  • @azure/arm-resourceprovider-profile-2020-09-01-hybrid

    为 Azure Stack Hub 生成的最新配置文件。 使用此配置文件可以使服务与阵列版本 1808 或更高版本的 Azure Stack Hub 最兼容。

  • @azure-arm-resource

    配置文件包含所有服务的最新版本。 使用 Azure 中所有服务的最新版本。

配置文件

对于包含日期的配置文件,若要使用不同的 SDK 配置文件或版本,可以替换 @azure/arm-keyvault-profile-<date>-hybrid 中的日期。 例如,对于 2008 版本,配置文件为 2019-03-01,字符串变为 @azure/arm-keyvault-profile-2019-03-01-hybrid。 请注意,有时,SDK 团队会更改包的名称,因此仅用不同日期替换字符串的日期可能不起作用。 请参阅下表,了解配置文件与 Azure Stack 版本的关联。

Azure Stack 版本 配置文件
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020-09-01
2102 2020-09-01
2008 2019-03-01

有关 Azure Stack Hub 和 API 配置文件的详细信息,请参阅 API 配置文件的摘要

安装 Node.js SDK

  1. 安装 Git。 有关说明,请参阅入门 - 安装 Git

  2. 安装或升级到 Node.js 的最新版本。 Node.js 还包含 npm JavaScript 包管理器。

  3. 安装或升级 Visual Studio Code,并安装适用于 Visual Studio Code 的 Node.js 扩展

  4. 安装 Azure Stack Hub 资源管理器的客户端包。 有关详细信息,请参阅如何安装客户端库

  5. 需安装的包取决于要使用的配置文件版本。 可以在 npm 中的包部分找到资源提供程序列表。

订阅

如果还没有订阅,请创建订阅,并保存稍后要使用的订阅 ID。 有关如何创建订阅的详细信息,请参阅此文档

服务主体

应创建服务主体及其关联环境信息并将其保存到某个位置。 建议使用具有 owner 角色的服务主体,但根据该示例,contributor 角色即可满足要求。 有关必需值,请参阅示例存储库中的自述文件。 读取的这些值可以是 SDK 语言支持的任何格式,例如我们的示例使用的 JSON 文件格式。 并非所有这些值都可以使用,具体取决于所运行的示例。 有关更新的示例代码或详细信息,请参阅示例存储库

租户 ID

若要查找 Azure Stack Hub 的目录或租户 ID,请按照此文中的说明进行操作。

注册资源提供程序

遵循此文档注册所需的资源提供程序。 根据要运行的示例,将需要这些资源提供程序。 例如,如果要运行 VM 示例,则需要 Microsoft.Compute 资源提供程序注册。

Azure Stack 资源管理器终结点

Azure 资源管理器 (ARM) 是一种管理框架,可供管理员用来部署、管理和监视 Azure 资源。 Azure 资源管理器可以通过单个操作以组任务而不是单个任务的形式处理这些任务。 可以从资源管理器终结点获取元数据信息。 该终结点返回 JSON 文件,其中包含运行代码所需的信息。

考虑以下情况:

  • Azure Stack 开发工具包 (ASDK) 中的 ResourceManagerEndpointUrl 是:https://management.local.azurestack.external/

  • 集成系统中的 ResourceManagerEndpointUrl 为 https://management.region.<fqdn>/,其中 <fqdn> 是完全限定的域名。

  • 检索所需的元数据:<ResourceManagerUrl>/metadata/endpoints?api-version=1.0

示例 JSON:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.chinacloudapi.cn/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.chinacloudapi.cn/",
         "audiences": ["https://management.yourtenant.partner.onmschina.cn/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

示例

有关最新的示例代码,请参阅示例存储库。 根 README.md 描述一般要求,每个子目录都包含一个特定示例,内有其自己的关于如何运行该示例的 README.md

有关适用于 Azure Stack 版本 2008 或配置文件 2019-03-01 及更低版本的示例,请参阅此文

后续步骤

了解有关 API 配置文件的详细信息: