API-verzióprofilok használata Node.js szoftverfejlesztői készlettel (SDK) az Azure Stack Hubban

  • Cikk

Node.js- és API-verzióprofilok

Az Node.js SDK-val felépítheti és kezelheti az alkalmazások infrastruktúráját. A Node.js SDK API-profiljai segítenek a hibrid felhőmegoldásokban azáltal, hogy lehetővé teszi a globális Azure-erőforrások és az Azure Stack Hub-erőforrások közötti váltást. A kód egyszer, majd a globális Azure-ra és az Azure Stack Hubra is megcélzható.

Ebben a cikkben a Visual Studio Code-ot használhatja fejlesztési eszközként. A Visual Studio Code képes hibakeresést végezni a Node.js SDK-ban, és lehetővé teszi az alkalmazás futtatását és leküldését az Azure Stack Hub-példányra. A hibakeresést a Visual Studio Code-ból vagy a parancsot node <nodefile.js>futtató terminálablakban végezheti el.

A Node.js SDK

A Node.js SDK Azure Stack Hub Resource Manager eszközöket biztosít. Az SDK erőforrás-szolgáltatói közé tartozik a számítás, a hálózatkezelés, a tárolás, az alkalmazásszolgáltatások és a KeyVault. A node.js alkalmazásban 10 erőforrás-szolgáltató ügyfélkódtár telepíthető. Letöltheti azt is, hogy melyik erőforrás-szolgáltatót fogja használni a 2020-09-01-profilhoz az alkalmazás memóriájának optimalizálása érdekében. Minden modul egy erőforrás-szolgáltatóból, a megfelelő API-verzióból és az API-profilból áll.

Az API-profil az erőforrás-szolgáltatók és az API-verziók kombinációja. Az API-profilok használatával lekérheti az erőforrás-szolgáltatói csomagokban található egyes erőforrástípusok legújabb, legstabilabb verzióját.

  • Az összes szolgáltatás legújabb verzióinak használatához használja a csomagok legújabb profilját.

  • Az Azure Stack Hubdal kompatibilis szolgáltatások használatához használja a @azure/arm-resources-profile-hybrid-2020-09-01 vagy @azure/arm-storage-profile-2020-09-01-hybrid

NPM-csomagok

Minden erőforrás-szolgáltató saját csomagtal rendelkezik. A csomagot az npm beállításjegyzékéből szerezheti be.

A következő csomagokat találja:

Erőforrás-szolgáltató Csomag
APP SERVICE @azure/arm-resources-profile-2020-09-01-hybrid
Azure Resource Manager-előfizetések @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
Engedélyezés @azure/arm-authorization-profile-2020-09-01-hybrid
Számítás @azure/arm-compute-profile-2020-09-01-hybrid
Storage @azure/arm-storage-profile-2020-09-01-hybrid
Hálózat @azure/arm-network-profile-2020-09-01-hybrid
Erőforrások @azure/arm-resources-profile-hybrid-2020-09-01
Kulcstartó @azure/arm-keyvault-profile-2020-09-01-hybrid

Egy szolgáltatás legújabb API-verziójának használatához használja az adott ügyfélkódtár Legújabb profilját. Ha például az erőforrás-szolgáltatás legújabb API-verzióját szeretné használni, használja az azure-arm-resourceErőforrás-kezelési ügyfélkódtár. csomag profilját.

Használja a csomagban meghatározott API-verziókat az erőforrás-szolgáltató adott API-verzióihoz.

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

    Az Azure Stack Hubhoz készült legújabb profil. Ezzel a profillal a szolgáltatások a legkompatibilisebbek lehetnek az Azure Stack Hubbal, ha 1808-as vagy újabb bélyeget használ.

  • @azure arm-resource

    A profil az összes szolgáltatás legújabb verzióiból áll. Használja az Azure összes szolgáltatásának legújabb verzióit.

Profilok

Dátumokat tartalmazó profilok esetén egy másik SDK-profil vagy -verzió használatához helyettesítheti a dátumot a következőben: @azure/arm-keyvault-profile-<date>-hybrid. A 2008-es verzió esetében például a profil , 2019-03-01a sztring pedig a lesz @azure/arm-keyvault-profile-2019-03-01-hybrid. Vegye figyelembe, hogy előfordulhat, hogy az SDK-csapat megváltoztatja a csomagok nevét, ezért előfordulhat, hogy egy sztring dátumának egy másik dátumra való lecserélése nem fog működni. A profilok és az Azure Stack-verziók társítását az alábbi táblázatban találja.

Azure Stack-verzió 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

További információ az Azure Stack Hubról és az API-profilokról: Az API-profilok összegzése.

A Node.js SDK telepítése

  1. Telepítse a Gitet. Útmutatásért lásd: Első lépések – A Git telepítése.

  2. Telepítse vagy frissítsen a Node.jsaktuális verziójára. Node.js tartalmazza az npm JavaScript-csomagkezelőt is.

  3. Telepítse vagy frissítse a Visual Studio Code-ot , és telepítse a Visual Studio Code Node.js bővítményét .

  4. Telepítse az Azure Stack Hub-erőforrás-kezelő ügyfélcsomagjait. További információ: Ügyfélkódtárak telepítése.

  5. A telepíteni kívánt csomagok a használni kívánt profilverziótól függenek. Az erőforrás-szolgáltatók listáját az npm csomagok szakaszában találja.

Előfizetés

Ha még nem rendelkezik előfizetéssel, hozzon létre egy előfizetést, és mentse a később használni kívánt előfizetés-azonosítót. Az előfizetések létrehozásával kapcsolatos további információkért tekintse meg ezt a dokumentumot.

Szolgáltatásnév

A szolgáltatásnevet és a hozzá tartozó környezeti információkat valahol létre kell hozni és menteni kell. A szerepkörrel rendelkező owner szolgáltatásnév használata ajánlott, de a mintától függően elegendő lehet egy contributor szerepkör. A szükséges értékekért tekintse meg a mintaadattár README elemét. Ezeket az értékeket az SDK nyelv által támogatott bármilyen formátumban elolvashatja, például egy JSON-fájlból (amelyet a minták használnak). A futtatott mintától függően nem minden érték használható. A frissített mintakódért vagy további információkért tekintse meg a mintaadattárat .

Bérlőazonosító

Az Azure Stack Hub címtár- vagy bérlőazonosítójának megkereséséhez kövesse az ebben a cikkben található utasításokat.

Erőforrás-szolgáltatók regisztrálása

Regisztrálja a szükséges erőforrás-szolgáltatókat a dokumentum követésével. Ezekre az erőforrás-szolgáltatókra a futtatni kívánt mintáktól függően lesz szükség. Ha például virtuálisgép-mintát szeretne futtatni, az Microsoft.Compute erőforrás-szolgáltató regisztrációjára van szükség.

Azure Stack Resource Manager-végpont

Az Azure Resource Manager (ARM) egy felügyeleti keretrendszer, amely lehetővé teszi a rendszergazdák számára az Azure-erőforrások üzembe helyezését, kezelését és monitorozását. Az Azure Resource Manager ezeket a feladatokat nem egyenként, hanem csoportként tudja kezelni egyetlen műveletben. A metaadat-adatokat a Resource Manager végpontról szerezheti be. A végpont egy JSON-fájlt ad vissza a kód futtatásához szükséges információkkal.

A következőket ajánljuk figyelmébe:

  • Az Azure Stack Development Kitben (ASDK) található ResourceManagerEndpointUrl a következő: https://management.local.azurestack.external/.

  • Az integrált rendszerekben a ResourceManagerEndpointUrl a következő: https://management.region.<fqdn>/, ahol <fqdn> a teljes tartománynév.

  • A szükséges metaadatok lekérése: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

JSON-minta:

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

Példák

A frissítési mintakódhoz tekintse meg a mintaadattárat . A gyökér README.md általános követelményeket ír le, és minden alkönyvtár tartalmaz egy saját mintát README.md a minta futtatásához.

Lásd itt az Azure Stack-verzióra 2008 vagy -profilra 2019-03-01 vonatkozó mintát, és alább.

Következő lépések

További információ az API-profilokról: