Använda API-versionsprofiler med Node.js software development kit (SDK) i Azure Stack Hub

Node.js- och API-versionsprofiler

Du kan använda Node.js SDK för att skapa och hantera infrastrukturen för dina appar. API-profiler i Node.js SDK hjälper dig med dina hybridmolnlösningar genom att låta dig växla mellan globala Azure-resurser och Azure Stack Hub-resurser. Du kan koda en gång och sedan rikta in dig på både global Azure och Azure Stack Hub.

I den här artikeln kan du använda Visual Studio Code som utvecklingsverktyg. Visual Studio Code kan felsöka Node.js SDK och gör att du kan köra appen och skicka appen till din Azure Stack Hub-instans. Du kan felsöka från Visual Studio Code eller via ett terminalfönster som kör kommandot node <nodefile.js>.

SDK:Node.js

Node.js SDK tillhandahåller Azure Stack Hub-Resource Manager verktyg. Resursprovidrar i SDK:n inkluderar beräkning, nätverk, lagring, apptjänster och KeyVault. Det finns 10 klientbibliotek för resursprovidern som du kan installera i node.js-programmet. Du kan också ladda ned ange vilken resursprovider du ska använda för profilen 2020-09-01 för att optimera minnet för ditt program. Varje modul består av en resursprovider, respektive API-version och API-profilen.

En API-profil är en kombination av resursprovidrar och API-versioner. Du kan använda en API-profil för att få den senaste, mest stabila versionen av varje resurstyp i ett resursproviderpaket.

  • Om du vill använda de senaste versionerna av alla tjänster använder du paketens senaste profil.

  • Om du vill använda tjänsterna som är kompatibla med Azure Stack Hub använder du @azure/arm-resources-profile-hybrid-2020-09-01 eller @azure/arm-storage-profile-2020-09-01-hybrid

NPM-paket

Varje resursprovider har ett eget paket. Du kan hämta paketet från npm-registret.

Du hittar följande paket:

Resursprovider Paket
App Service @azure/arm-resources-profile-2020-09-01-hybrid
Azure Resource Manager-prenumerationer @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
Auktorisering @azure/arm-authorization-profile-2020-09-01-hybrid
Beräkning @azure/arm-compute-profile-2020-09-01-hybrid
Storage @azure/arm-storage-profile-2020-09-01-hybrid
Nätverk @azure/arm-network-profile-2020-09-01-hybrid
Resurser @azure/arm-resources-profile-hybrid-2020-09-01
Nyckelvalv @azure/arm-keyvault-profile-2020-09-01-hybrid

Om du vill använda den senaste API-versionen av en tjänst använder du den senaste profilen för det specifika klientbiblioteket. Om du till exempel vill använda den senaste API-versionen av resurstjänsten ensam använder du profilen azure-arm-resource för resource management-klientbiblioteket.

Använd de specifika API-versioner som definierats i paketet för de specifika API-versionerna av en resursprovider.

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

    Senaste profil som skapats för Azure Stack Hub. Använd den här profilen för att tjänster ska vara mest kompatibla med Azure Stack Hub så länge du har 1808-stämpel eller längre.

  • @azure-arm-resource

    Profilen består av de senaste versionerna av alla tjänster. Använd de senaste versionerna av alla tjänster i Azure.

Profiler

För profiler som innehåller datum kan du ersätta datumet i om du vill använda en annan SDK-profil eller version.@azure/arm-keyvault-profile-<date>-hybrid För 2008-versionen är 2019-03-01till exempel profilen och strängen blir @azure/arm-keyvault-profile-2019-03-01-hybrid. Observera att SDK-teamet ibland ändrar namnet på paketen, så att helt enkelt ersätta datumet för en sträng med ett annat datum kanske inte fungerar. Se följande tabell för association av profiler och Azure Stack-versioner.

Azure Stack-version 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

Mer information om Azure Stack Hub- och API-profiler finns i Sammanfattning av API-profiler.

Installera Node.js SDK

  1. Installera Git. Anvisningar finns i Komma igång – Installera Git.

  2. Installera eller uppgradera till den aktuella versionen av Node.js. Node.js innehåller även javascript-pakethanteraren npm .

  3. Installera eller uppgradera Visual Studio Code och installera Node.js-tillägget för Visual Studio Code.

  4. Installera klientpaketen för Azure Stack Hub Resource Manger. Mer information finns i installera klientbibliotek.

  5. Vilka paket som behöver installeras beror på vilken profilversion du vill använda. Du hittar en lista över resursprovidrar i avsnittet Paket i npm .

Prenumeration

Om du inte redan har en prenumeration skapar du en prenumeration och sparar prenumerations-ID:t som ska användas senare. Information om hur du skapar en prenumeration finns i det här dokumentet.

Tjänstens huvudnamn

Ett huvudnamn för tjänsten och dess associerade miljöinformation bör skapas och sparas någonstans. Tjänstens huvudnamn med owner roll rekommenderas, men beroende på exemplet kan det räcka med en contributor roll. Se README i exempellagringsplatsen för de värden som krävs. Du kan läsa dessa värden i valfritt format som stöds av SDK-språket, till exempel från en JSON-fil (som våra exempel använder). Beroende på vilket exempel som körs kan inte alla dessa värden användas. Se exempellagringsplatsen för uppdaterad exempelkod eller ytterligare information.

Klientorganisations-ID

Följ anvisningarna i den här artikeln för att hitta katalogen eller klientorganisations-ID:t för din Azure Stack Hub.

Registrera resursprovidrar

Registrera nödvändiga resursprovidrar genom att följa det här dokumentet. Dessa resursprovidrar krävs beroende på vilka exempel du vill köra. Om du till exempel vill köra ett virtuellt datorexempel krävs registrering av Microsoft.Compute resursprovidern.

Azure Stack Resource Manager-slutpunkt

Azure Resource Manager (ARM) är ett hanteringsramverk som gör det möjligt för administratörer att distribuera, hantera och övervaka Azure-resurser. Azure Resource Manager kan hantera dessa uppgifter som en grupp, snarare än individuellt, i en enda åtgärd. Du kan hämta metadatainformationen från Resource Manager slutpunkten. Slutpunkten returnerar en JSON-fil med den information som krävs för att köra koden.

Tänk också på följande:

  • ResourceManagerEndpointUrl i Azure Stack Development Kit (ASDK) är: https://management.local.azurestack.external/.

  • ResourceManagerEndpointUrl i integrerade system är: https://management.region.<fqdn>/, där <fqdn> är ditt fullständigt kvalificerade domännamn.

  • Så här hämtar du de metadata som krävs: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

Exempel på 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"]
      }
}

Exempel

Se exempellagringsplatsen för uppdaterings- och datumexempelkod. Roten README.md beskriver allmänna krav, och varje underkatalog innehåller ett specifikt exempel med egen README.md information om hur du kör exemplet.

Här finns det exempel som gäller för Azure Stack-version 2008 eller -profil 2019-03-01 och nedan.

Nästa steg

Läs mer om API-profiler: