Utiliser des profils de version d’API avec Node.js kit de développement logiciel (SDK) dans Azure Stack Hub

profils de version de Node.js et d’API

Vous pouvez utiliser Node.js SDK pour créer et gérer l’infrastructure de vos applications. Les profils d’API dans le KIT de développement logiciel (SDK) Node.js aident à utiliser vos solutions cloud hybrides en vous permettant de basculer entre les ressources Azure globales et les ressources Azure Stack Hub. Vous pouvez coder une seule fois, puis cibler à la fois Azure global et Azure Stack Hub.

Dans cet article, vous pouvez utiliser Visual Studio Code comme outil de développement. Visual Studio Code peut déboguer le sdk Node.js et vous permet d’exécuter l’application et d’envoyer (push) l’application à votre instance Azure Stack Hub. Vous pouvez déboguer à partir de Visual Studio Code ou via une fenêtre de terminal exécutant la commande node <nodefile.js>.

Kit de développement logiciel (SDK) Node.js

Le sdk Node.js fournit des outils Azure Stack Hub Resource Manager. Les fournisseurs de ressources du Kit de développement logiciel (SDK) incluent le calcul, la mise en réseau, le stockage, les services d’application et KeyVault. Il existe 10 bibliothèques clientes de fournisseur de ressources que vous pouvez installer dans votre application node.js. Vous pouvez également télécharger le fournisseur de ressources que vous utiliserez pour le profil 2020-09-01 afin d’optimiser la mémoire de votre application. Chaque module se compose d’un fournisseur de ressources, de la version de l’API respective et du profil d’API.

Un profil d’API est une combinaison de fournisseurs de ressources et de versions d’API. Vous pouvez utiliser un profil d’API pour obtenir la dernière version stable de chaque type de ressource dans un package de fournisseur de ressources.

• Pour utiliser les dernières versions de tous les services, utilisez le profil le plus récent des packages.

• Pour utiliser les services compatibles avec Azure Stack Hub, utilisez le @azure/arm-resources-profile-hybrid-2020-09-01 ou @azure/arm-storage-profile-2020-09-01-hybrid

NPM Packages

Chaque fournisseur de ressources a son propre package. Vous pouvez obtenir le package à partir du registre npm.

Vous trouverez les packages suivants :

Pour utiliser la dernière version d’API d’un service, utilisez le profil Le plus récent de la bibliothèque cliente spécifique. Par exemple, si vous souhaitez utiliser la dernière version de l’API du service de ressources seule, utilisez le azure-arm-resource profil de la bibliothèque cliente Resource Management.

Utilisez les versions d’API spécifiques définies à l’intérieur du package pour les versions d’API spécifiques d’un fournisseur de ressources.

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

  Dernier profil créé pour Azure Stack Hub. Utilisez ce profil pour que les services soient les plus compatibles avec Azure Stack Hub tant que vous êtes sur le tampon 1808 ou plus.

• @azure-arm-resource

  Le profil se compose des dernières versions de tous les services. Utilisez les dernières versions de tous les services dans Azure.

Profils

Pour les profils contenant des dates, pour utiliser un autre profil ou version du SDK, vous pouvez remplacer la date dans @azure/arm-keyvault-profile-<date>-hybrid. Par exemple, pour la version 2008, le profil est 2019-03-01et la chaîne devient @azure/arm-keyvault-profile-2019-03-01-hybrid. Notez que parfois l’équipe du Kit de développement logiciel (SDK) modifie le nom des packages. Par conséquent, il se peut que le remplacement de la date d’une chaîne par une date différente ne fonctionne pas. Consultez le tableau suivant pour l’association de profils et de versions d’Azure Stack.

Pour plus d’informations sur les profils Azure Stack Hub et API, consultez le résumé des profils d’API.

Installer le Kit de développement logiciel (SDK) Node.js

1. Installez Git. Pour obtenir des instructions, consultez Prise en main - Installation de Git.

2. Installez ou mettez à niveau vers la version actuelle de Node.js. Node.js inclut également le gestionnaire de package JavaScript npm .

3. Installez ou mettez à niveau Visual Studio Code et installez l’extension Node.js pour Visual Studio Code.

4. Installez les packages clients pour le Gestionnaire de ressources Azure Stack Hub. Pour plus d’informations, consultez comment installer des bibliothèques clientes.

5. Les packages qui doivent être installés dépendent de la version de profil que vous souhaitez utiliser. Vous trouverez la liste des fournisseurs de ressources dans la section Packages dans npm .

Abonnement

Si vous n’avez pas encore d’abonnement, créez un abonnement et enregistrez l’ID d’abonnement à utiliser ultérieurement. Pour plus d’informations sur la création d’un abonnement, consultez ce document.

Service Principal

Un principal de service et ses informations d’environnement associées doivent être créées et enregistrées quelque part. Le principal de service avec owner un rôle est recommandé, mais en fonction de l’exemple, un contributor rôle peut suffire. Reportez-vous au fichier README dans l’exemple de référentiel pour connaître les valeurs requises. Vous pouvez lire ces valeurs dans n’importe quel format pris en charge par le langage sdk, par exemple à partir d’un fichier JSON (que nos exemples utilisent). Selon l’exemple en cours d’exécution, toutes ces valeurs ne peuvent pas être utilisées. Consultez l’exemple de référentiel pour obtenir des informations supplémentaires ou des exemples de code mis à jour.

ID du locataire

Pour rechercher l’ID d’annuaire ou de locataire de votre Azure Stack Hub, suivez les instructions de cet article.

Inscrire des fournisseurs de ressources

Inscrivez les fournisseurs de ressources requis en suivant ce document. Ces fournisseurs de ressources sont requis en fonction des exemples que vous souhaitez exécuter. Par exemple, si vous souhaitez exécuter un exemple de machine virtuelle, l’inscription du Microsoft.Compute fournisseur de ressources est requise.

Point de terminaison Azure Stack Resource Manager

Azure Resource Manager (ARM) est un framework de gestion qui permet aux administrateurs de déployer, gérer et surveiller des ressources Azure. Azure Resource Manager peut gérer ces tâches en tant que groupe, plutôt que individuellement, dans une seule opération. Vous pouvez obtenir les informations de métadonnées à partir du point de terminaison Resource Manager. Le point de terminaison retourne un fichier JSON avec les informations requises pour exécuter votre code.

Tenez compte des éléments suivants :

• ResourceManagerEndpointUrl dans le Kit de développement Azure Stack (ASDK) est : https://management.local.azurestack.external/.

• ResourceManagerEndpointUrl dans les systèmes intégrés est : https://management.region.<fqdn>/, où <fqdn> est votre nom de domaine complet.

• Pour récupérer les métadonnées requises : <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

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

Échantillons

Consultez l’exemple de référentiel pour obtenir un exemple de code de mise à jour à jour. La racine README.md décrit les exigences générales, et chaque sous-répertoire contient un exemple spécifique avec sa propre README.md façon d’exécuter cet exemple.

Étapes suivantes

En savoir plus sur les profils d’API :

• Gérer les profils de version d’API dans Azure Stack Hub
• Versions de l’API fournisseur de ressources prises en charge par les profils