在 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>的終端機視窗進行偵錯。

The 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 登錄取得套件。

您可以找到下列套件：

若要使用服務的最新 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 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 的套件 一節中找到資源提供者清單。

訂閱

如果您還沒有訂用帳戶，請建立訂用帳戶，並儲存稍後要使用的訂用帳戶標識碼。 如需如何建立訂用帳戶的資訊，請參閱本 檔。

服務主體

服務主體及其相關聯的環境信息應該建立並儲存在某處。 建議使用具有 owner 角色的服務主體，但視範例而定，contributor 角色可能已足夠。 如需必要值，請參閱範例存放 庫中 的自述檔。 您可以使用 SDK 語言所支援的任何格式讀取這些值，例如來自 JSON 檔案（我們的範例使用）。 根據正在執行的樣本，可能並非所有的值都會被使用。 請參閱範例存放庫以獲取更新的範例程式代碼或進一步資訊。

租戶識別碼

若要尋找 Azure Stack Hub 的目錄或租用戶標識碼，請遵循 本文中的指示。

註冊資源提供者

遵循本 文件，註冊必要的資源提供者。 視您想要執行的範例而定，需要這些資源提供者。 例如，如果您想要執行 VM 範例， Microsoft.Compute 則需要資源提供者註冊。

Azure Stack 資源管理員端點

Azure Resource Manager （ARM） 是一種管理架構，可讓系統管理員部署、管理及監視 Azure 資源。 Azure Resource Manager 可以在單一作業中以群組而非個別方式處理這些工作。 您可以從 Resource Manager 端點取得元數據資訊。 端點會傳回 JSON 檔案，其中包含執行程式碼所需的資訊。

請考慮下列事項：

• Azure Stack 開發工具包中的 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 範例，說明如何執行該範例。

後續步驟

深入瞭解 API 設定檔：

• 在 Azure Stack Hub 中管理 API 版本設定檔
• 配置檔所支援的資源提供者 API 版本