Použití profilů verzí rozhraní API s Node.js sadou SDK (Software Development Kit) ve službě Azure Stack Hub

Článek
10/30/2024

Node.js a profily verzí rozhraní API

Sadu Node.js SDK můžete použít k vytvoření a správě infrastruktury pro vaše aplikace. Profily rozhraní API v sadě Node.js SDK pomáhají s hybridními cloudovými řešeními tím, že umožňují přepínat mezi globálními prostředky Azure a prostředky služby Azure Stack Hub. Můžete kódovat jednou a pak cílit na globální Azure i Azure Stack Hub.

V tomto článku můžete jako vývojový nástroj použít Visual Studio Code . Visual Studio Code může ladit sadu Node.js SDK a umožňuje spustit aplikaci a odeslat ji do instance služby Azure Stack Hub. Ladění můžete provést z editoru Visual Studio Code nebo pomocí okna terminálu pomocí příkazu node <nodefile.js>.

Sada Node.js SDK

Sada Node.js SDK poskytuje nástroje azure Stack Hub Resource Manager. Poskytovatelé prostředků v sadě SDK zahrnují výpočetní prostředky, sítě, úložiště, aplikační služby a KeyVault. Do node.js aplikace můžete nainstalovat 10 klientských knihoven poskytovatele prostředků. Můžete si také stáhnout, kterého poskytovatele prostředků budete používat pro profil 2020-09-01- , abyste optimalizovali paměť pro vaši aplikaci. Každý modul se skládá z poskytovatele prostředků, příslušné verze rozhraní API a profilu rozhraní API.

Profil rozhraní API je kombinací zprostředkovatelů prostředků a verzí rozhraní API. Profil rozhraní API můžete použít k získání nejnovější a nejstabilnější verze jednotlivých typů prostředků v balíčku poskytovatele prostředků.

Pokud chcete využívat nejnovější verze všech služeb, použijte nejnovější profil balíčků.
Pokud chcete používat služby kompatibilní se službou Azure Stack Hub, použijte @azure/arm-resources-profile-hybrid-2020-09-01 nebo @azure/arm-storage-profile-2020-09-01-hybrid.

Balíčky NPM

Každý poskytovatel prostředků má svůj vlastní balíček. Balíček můžete získat z registru npm.

Můžete najít následující balíčky:

Poskytovatel prostředků	Balíček
App Service	@azure/arm-resources-profile-2020-09-01-hybrid
Předplatná Azure Resource Manager	@azure/arm-subscriptions-profile-hybrid-2020-09-01
Azure Resource Manager Policy	@azure/arm-policy-profile-hybrid-2020-09-01
Azure Resource Manager DNS	@azure/arm-dns-profile-2020-09-01-hybrid
Autorizace	@azure/arm-authorization-profile-2020-09-01-hybrid
Výpočetní služby	@azure/arm-compute-profile-2020-09-01-hybrid
Storage	@azure/arm-storage-profile-2020-09-01-hybrid
Síť	@azure/arm-network-profile-2020-09-01-hybrid
Prostředky	@azure/arm-resources-profile-hybrid-2020-09-01
Keyvault	@azure/arm-keyvault-profile-2020-09-01-hybrid

Pokud chcete použít nejnovější verzi rozhraní API služby, použijte profil Nejnovější konkrétní klientské knihovny. Pokud například chcete použít samotnou službu prostředků s nejnovější verzí rozhraní API, použijte azure-arm-resource profil balíčku Klientská knihovna správy prostředků.

Pro konkrétní verze rozhraní API poskytovatele prostředků použijte konkrétní verze rozhraní API definované v balíčku.

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

Nejnovější profil vytvořený pro Azure Stack Hub. Tento profil použijte k tomu, aby služby byly co nejkompatibilnější se službou Azure Stack Hub, pokud používáte razítko 1808 nebo dále.
@azure arm-resource

Profil se skládá z nejnovějších verzí všech služeb. Používejte nejnovější verze všech služeb v Azure.

Profily

Pokud chcete použít jiný profil nebo verzi sady SDK, můžete u profilů obsahujících kalendářní data nahradit v @azure/arm-keyvault-profile-<date>-hybrid. Například pro verzi 2008 je 2019-03-01profil a řetězec se změní @azure/arm-keyvault-profile-2019-03-01-hybridna . Všimněte si, že někdy tým SADY SDK změní název balíčků, takže pouhé nahrazení data řetězce jiným datem nemusí fungovat. V následující tabulce najdete informace o přidružení profilů a verzí služby Azure Stack.

Verze služby Azure Stack	Profil
2311	2020_09_01
2301	2020_09_01
2206	2020_09_01
2108	2020-09-01
2102	2020-09-01
2008	2019-03-01

Další informace o službě Azure Stack Hub a profilech rozhraní API najdete v tématu Souhrn profilů rozhraní API.

Instalace sady Node.js SDK

Nainstalujte Git. Pokyny najdete v tématu Začínáme – Instalace Gitu.
Nainstalujte nebo upgradujte na aktuální verzi Node.js. Node.js zahrnuje také správce balíčků npm JavaScript.
Nainstalujte nebo upgradujte Visual Studio Code a nainstalujte rozšířeníNode.js pro Visual Studio Code.
Nainstalujte klientské balíčky pro správce prostředků služby Azure Stack Hub. Další informace najdete v tématu Instalace klientských knihoven.
Balíčky, které je potřeba nainstalovat, závisí na verzi profilu, kterou chcete použít. Seznam poskytovatelů prostředků najdete v části Balíčky v npm .

Předplatné

Pokud ještě předplatné nemáte, vytvořte předplatné a uložte ID předplatného, abyste ho mohli použít později. Informace o tom, jak vytvořit předplatné, najdete v tomto dokumentu.

Instanční objekt

Instanční objekt a informace o jeho přidruženém prostředí by se měly někde vytvořit a uložit. Doporučuje se instanční objekt s owner rolí, ale v závislosti na ukázce contributor může stačit role. Požadované hodnoty najdete v souboru README v ukázkovém úložišti . Tyto hodnoty můžete číst v libovolném formátu podporovaném jazykem sady SDK, například ze souboru JSON (který používají naše ukázky). V závislosti na spuštěné ukázce se nedají použít všechny tyto hodnoty. Aktualizovaný ukázkový kód nebo další informace najdete v ukázkovém úložišti .

ID tenanta

Pokud chcete najít ID adresáře nebo tenanta pro službu Azure Stack Hub, postupujte podle pokynů v tomto článku.

Registrace poskytovatelů prostředků

Podle tohoto dokumentu zaregistrujte požadované poskytovatele prostředků. Tito poskytovatelé prostředků budou vyžadováni v závislosti na ukázkách, které chcete spustit. Pokud například chcete spustit ukázku virtuálního počítače, Microsoft.Compute vyžaduje se registrace poskytovatele prostředků.

Koncový bod Azure Stack Resource Manageru

Azure Resource Manager (ARM) je architektura pro správu, která správcům umožňuje nasazovat, spravovat a monitorovat prostředky Azure. Azure Resource Manager může tyto úlohy zpracovávat jako skupinu, nikoli jednotlivě, v rámci jedné operace. Informace o metadatech můžete získat z koncového bodu Resource Manager. Koncový bod vrátí soubor JSON s informacemi potřebnými ke spuštění kódu.

Zvažte použití těchto zdrojů:

ResourceManagerEndpointUrl v sadě Azure Stack Development Kit (ASDK) je: https://management.local.azurestack.external/.
ResourceManagerEndpointUrl v integrovaných systémech je: https://management.region.<fqdn>/, kde <fqdn> je plně kvalifikovaný název domény.
Načtení požadovaných metadat: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

Ukázkový kód 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"]
      }
}

Ukázky

Ukázkový kód aktualizace k datu najdete v ukázkovém úložišti . Kořen README.md popisuje obecné požadavky a každý podadresář obsahuje konkrétní ukázku s vlastní README.md ukázkou, jak ji spustit.

Ukázku použitelnou pro verzi 2008 nebo profil 2019-03-01 služby Azure Stack najdete tady a níže.

Další kroky

Další informace o profilech rozhraní API:

Sdílet prostřednictvím