API-versieprofielen gebruiken met Node.js SDK (Software Development Kit) in Azure Stack Hub

  • Artikel
  • 4 minuten om te lezen

Node.js- en API-versieprofielen

U kunt Node.js SDK gebruiken om de infrastructuur voor uw apps te bouwen en te beheren. API-profielen in de Node.js SDK helpen bij uw hybride cloudoplossingen door te schakelen tussen wereldwijde Azure-resources en Azure Stack Hub-resources. U kunt één keer code schrijven en vervolgens gericht zijn op zowel globale Azure als Azure Stack Hub.

In dit artikel kunt u Visual Studio Code gebruiken als uw ontwikkelhulpprogramma. Visual Studio Code kan fouten opsporen in de Node.js SDK en kunt u de app uitvoeren en de app naar uw Azure Stack Hub-exemplaar pushen. U kunt fouten opsporen vanuit Visual Studio Code of via een terminalvenster waarop de opdracht node <nodefile.js>wordt uitgevoerd.

De Node.js SDK

De Node.js SDK biedt hulpprogramma's voor Azure Stack Hub-Resource Manager. Resourceproviders in de SDK omvatten compute, netwerken, opslag, app-services en KeyVault. Er zijn 10 clientbibliotheken van de resourceprovider die u kunt installeren in uw node.js-toepassing. U kunt ook downloaden welke resourceprovider u gaat gebruiken voor het profiel 2020-09-01 om het geheugen voor uw toepassing te optimaliseren. Elke module bestaat uit een resourceprovider, de respectieve API-versie en het API-profiel.

Een API-profiel is een combinatie van resourceproviders en API-versies. U kunt een API-profiel gebruiken om de meest recente, stabiele versie van elk resourcetype in een resourceproviderpakket op te halen.

  • Als u gebruik wilt maken van de nieuwste versies van alle services, gebruikt u het meest recente profiel van de pakketten.

  • Als u de services wilt gebruiken die compatibel zijn met Azure Stack Hub, gebruikt u de @azure/arm-resources-profile-hybrid-2020-09-01 of @azure/arm-storage-profile-2020-09-01-hybrid

NPM-pakketten

Elke resourceprovider heeft een eigen pakket. U kunt het pakket ophalen uit het npm-register.

U vindt de volgende pakketten:

Resourceprovider Pakket
App Service @azure/arm-resources-profile-2020-09-01-hybrid
Azure Resource Manager-abonnementen @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
Autorisatie @azure/arm-authorization-profile-2020-09-01-hybrid
Compute @azure/arm-compute-profile-2020-09-01-hybrid
Storage @azure/arm-storage-profile-2020-09-01-hybrid
Netwerk @azure/arm-network-profile-2020-09-01-hybrid
Bronnen @azure/arm-resources-profile-hybrid-2020-09-01
Sleutelkluis @azure/arm-keyvault-profile-2020-09-01-hybrid

Als u de nieuwste API-versie van een service wilt gebruiken, gebruikt u het meest recente profiel van de specifieke clientbibliotheek. Als u bijvoorbeeld alleen de nieuwste API-versie van de resourceservice wilt gebruiken, gebruikt u het azure-arm-resource profiel van de Resource Management-clientbibliotheek.

Gebruik de specifieke API-versies die in het pakket zijn gedefinieerd voor de specifieke API-versies van een resourceprovider.

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

    Nieuwste profiel gebouwd voor Azure Stack Hub. Gebruik dit profiel voor services om het meest compatibel te zijn met Azure Stack Hub zolang u een 1808-stempel of hoger hebt.

  • @azure-arm-resource

    Het profiel bestaat uit de nieuwste versies van alle services. Gebruik de nieuwste versies van alle services in Azure.

Profielen

Als u voor profielen met datums een ander SDK-profiel of een andere versie wilt gebruiken, kunt u de datum in @azure/arm-keyvault-profile-<date>-hybridvervangen. Voor de versie 2008 is 2019-03-01het profiel bijvoorbeeld en wordt de tekenreeks .@azure/arm-keyvault-profile-2019-03-01-hybrid Soms verandert het SDK-team de naam van de pakketten, dus het vervangen van de datum van een tekenreeks door een andere datum werkt mogelijk niet. Zie de volgende tabel voor het koppelen van profielen en Azure Stack-versies.

Azure Stack-versie Profiel
2108 2020-09-01
2102 2020-09-01
2008 2019-03-01

Zie het overzicht van API-profielen voor meer informatie over Azure Stack Hub- en API-profielen.

De Node.js SDK installeren

  1. Installeer Git. Zie Aan de slag - Git installeren voor instructies.

  2. Installeer of upgrade naar de huidige versie van Node.js. Node.js bevat ook npm JavaScript-pakketbeheer.

  3. Installeer of upgrade Visual Studio Code en installeer de Node.js-extensie voor Visual Studio Code.

  4. Installeer de clientpakketten voor azure Stack Hub Resource Manger. Zie voor meer informatie hoe u clientbibliotheken installeert.

  5. De pakketten die moeten worden geïnstalleerd, zijn afhankelijk van de profielversie die u wilt gebruiken. U vindt een lijst met resourceproviders in de sectie Pakketten in npm .

Abonnement

Als u nog geen abonnement hebt, maakt u een abonnement en slaat u de abonnements-id op die later moet worden gebruikt. Zie dit document voor informatie over het maken van een abonnement.

Service-principal

Een service-principal en de bijbehorende omgevingsgegevens moeten ergens worden gemaakt en opgeslagen. Service-principal met owner rol wordt aanbevolen, maar afhankelijk van het voorbeeld kan een contributor rol volstaan. Raadpleeg de README in de voorbeeldopslagplaats voor de vereiste waarden. U kunt deze waarden lezen in elke indeling die wordt ondersteund door de SDK-taal, zoals uit een JSON-bestand (die door onze voorbeelden wordt gebruikt). Afhankelijk van het voorbeeld dat wordt uitgevoerd, kunnen niet al deze waarden worden gebruikt. Zie de voorbeeldopslagplaats voor bijgewerkte voorbeeldcode of meer informatie.

Tenant-id

Volg de instructies in dit artikel om de map- of tenant-id voor uw Azure Stack Hub te vinden.

Resourceprovider registreren

Registreer de vereiste resourceproviders door dit document te volgen. Deze resourceproviders zijn vereist, afhankelijk van de voorbeelden die u wilt uitvoeren. Als u bijvoorbeeld een VM-voorbeeld wilt uitvoeren, is de registratie van de Microsoft.Compute resourceprovider vereist.

Azure Stack Resource Manager-eindpunt

Azure Resource Manager (ARM) is een beheerframework waarmee beheerders Azure-resources kunnen implementeren, beheren en bewaken. Azure Resource Manager kan deze taken verwerken als een groep, in plaats van afzonderlijk, in één bewerking. U kunt de metagegevensgegevens ophalen uit het Resource Manager-eindpunt. Het eindpunt retourneert een JSON-bestand met de gegevens die nodig zijn om uw code uit te voeren.

Overweeg de volgende:

  • De ResourceManagerEndpointUrl in de Azure Stack Development Kit (ASDK) is: https://management.local.azurestack.external/.

  • De ResourceManagerEndpointUrl in geïntegreerde systemen is: https://management.region.<fqdn>/, waar <fqdn> is uw volledig gekwalificeerde domeinnaam.

  • De vereiste metagegevens ophalen: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

Voorbeeld-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"]
      }
}

Voorbeelden

Zie de voorbeeldopslagplaats voor voorbeeldcode voor update-to-date. In de hoofdmap README.md worden algemene vereisten beschreven en elke submap bevat een specifiek voorbeeld met een eigen README.md voorbeeld over het uitvoeren van dat voorbeeld.

Zie hier voor het voorbeeld dat van toepassing is op azure Stack-versie 2008 of -profiel 2019-03-01 en hieronder.

Volgende stappen

Meer informatie over API-profielen: