在 Azure Stack Hub 中搭配使用 API 版本設定檔與 Node.js 軟體開發套件 (SDK)

發行項
10/30/2024

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 Resource Manager 工具。 SDK 中的資源提供者包括計算、網路、儲存體、應用程式服務和 KeyVault。可在 Node.js 應用程式中安裝的資源提供者用戶端程式庫有 10 個。您也可以下載指定要用於 2020-09-01-profile 的資源提供者，以便將應用程式的記憶體最佳化。每個模組都包含資源提供者、個別 API 版本和 API 設定檔。

API 設定檔是資源提供者和 API 版本的組合。您可以使用 API 設定檔，取得資源提供者套件中每個資源類型的最新、最穩定版本。

若要利用所有服務的最新版本，請使用套件的最新設定檔。
若要使用與 Azure Stack Hub 相容的服務，請使用 @azure/arm-resources-profile-hybrid-2020-09-01 或 @azure/arm-storage-profile-2020-09-01-hybrid

NPM 套件

每個資源提供者都有自己的套件。您可以從 npm 登錄取得套件。

您可以找到下列套件：

資源提供者	套件
App Service	@azure/arm-resources-profile-2020-09-01-hybrid
Azure Resource Manager 訂用帳戶	@azure/arm-subscriptions-profile-hybrid-2020-09-01
Azure Resource Manager 原則	@azure/arm-policy-profile-hybrid-2020-09-01
Azure Resource Manager 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
Storage	@azure/arm-storage-profile-2020-09-01-hybrid
Network	@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套件的 azure-arm-resource 設定檔。

針對資源提供者的特定 API 版本，請使用套件內所定義的特定 API 版本。

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

針對 Azure Stack Hub 建置的最新設定檔。只要您是在 1808 以上的戳記上，使用此設定檔就能讓服務與 Azure Stack Hub 有最高的相容性。
@azure-arm-resource

包含所有服務最新版本的設定檔。使用 Azure 中所有服務的最新版本。

Profiles

針對包含日期的設定檔，若要使用不同的 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

安裝 GIT。如需相關指示，請參閱使用者入門 - 安裝 Git。
安裝或升級至 Node.js 的目前版本。 Node.js 也包含 npm JavaScript 套件管理員。
安裝或升級 Visual Studio Code 並安裝適用於 Visual Studio Code 的 Node.js 擴充功能。
安裝 Azure Stack Hub Resource Manger 的用戶端套件。如需詳細資訊，請參閱如何安裝用戶端程式庫。
需要安裝的套件取決於您想要使用的設定檔版本。您可以在 npm 中的套件一節找到資源提供者清單。

訂用帳戶

如果您還沒有訂用帳戶，請建立訂用帳戶，並儲存訂用帳戶識別碼以供稍後使用。如需有關如何建立訂閱的詳細資訊，請參閱此文件。

服務主體

您應建立服務主體及其相關聯的環境資訊，並將其儲存。建議使用 owner 角色的服務主體，但視範例而定，contributor 角色可能已足夠。如需必要值，請參閱範例存放庫中的讀我檔案。您可以使用 SDK 語言所支援的任何格式讀取這些值，例如透過 JSON 檔案 (即我們的範例所使用的檔案)。視正在執行的範例而定，並非這些所有值皆可以使用。如需更新的範例程式碼或進一步資訊，請參閱範例存放庫。

租用戶識別碼

若要尋找 Azure Stack Hub 的目錄或租用戶識別碼，請遵循這篇文章的指示。

註冊資源提供者

遵循此文件來註冊所需的資源提供者。根據要執行的範例而定會需要這些資源提供者。例如如果您想要執行 VM 範例，則需要註冊 Microsoft.Compute 資源提供者。

Azure Stack Resource Manager 端點

Azure Resource Manager (ARM) 是可讓系統管理員進行部署、管理及監視 Azure 資源的管理架構。 Azure Resource Manager 能夠以群組方式處理這些工作，而非個別單獨作業的方式。您可以從 Resource Manager 端點取得中繼資料資訊。此端點會傳回 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.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

範例

請參閱範例存放庫以了解更新至最新的範例程式碼。根 README.md 描述一般需求，以及各子目錄均包含的特定範例，其專屬的 README.md 說明如何執行該範例。

如需適用於 Azure Stack 版本 2008 或設定檔 2019-03-01 以及下列範例的詳細資訊，請參閱此處。

後續步驟

深入了解 API 設定檔：

共用方式為