Utiliser des profils de version d’API avec le kit de développement logiciel (SDK) Node.js dans Azure Stack Hub
Node.js et les profils de version d’API
Vous pouvez utiliser le kit de développement logiciel (SDK) Node.js pour créer et gérer facilement l'infrastructure de vos applications. Les profils d’API du kit de développement logiciel (SDK) Node.js simplifient vos solutions cloud hybrides en vous permettant de basculer entre les ressources Azure globales et les ressources Azure Stack Hub. Vous pouvez coder une fois, puis cibler 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 kit de développement logiciel (SDK) Node.js et vous permettre d’exécuter et d’envoyer l’application à votre instance Azure Stack Hub. Vous pouvez déboguer depuis Visual Studio Code ou par le biais d’une fenêtre de terminal exécutant la commande node <nodefile.js>.
Kit de développement logiciel (SDK) Node.js
Le kit de développement logiciel (SDK) Node.js fournit les outils Azure Stack Hub Resource Manager. Le kit de développement logiciel (SDK) comporte des fournisseurs de ressources de calcul, de réseau, de stockage, de 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 aussi télécharger spécifiquement le fournisseur de ressources que vous allez utiliser pour 2020-09-01-profile afin d’optimiser la mémoire pour votre application. Chaque module se compose d’un fournisseur de ressources, de la version d’API correspondante 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 version la plus récente et la plus stable de chaque type de ressource dans un package de fournisseur de ressources.
Pour utiliser les versions les plus récentes de tous les services, utilisez le profil La plus récente des packages.
Pour utiliser les services compatibles avec Azure Stack Hub, utilisez @azure/arm-resources-profile-hybrid-2020-09-01 ou @azure/arm-storage-profile-2020-09-01-hybrid
Packages NPM
Chaque fournisseur de ressources dispose de son propre package. Vous pouvez obtenir le package à partir du registre npm.
Les packages suivants sont disponibles :
| Fournisseur de ressources | Package |
|---|---|
| App Service | @azure/arm-resources-profile-2020-09-01-hybrid |
| Abonnements Azure Resource Manager | @azure/arm-subscriptions-profile-hybrid-2020-09-01 |
| Stratégie Azure Resource Manager | @azure/arm-policy-profile-hybrid-2020-09-01 |
| DNS Azure Resource Manager | @azure/arm-dns-profile-2020-09-01-hybrid |
| Autorisation | @azure/arm-authorization-profile-2020-09-01-hybrid |
| Calcul | @azure/arm-compute-profile-2020-09-01-hybrid |
| Stockage | @azure/arm-storage-profile-2020-09-01-hybrid |
| Réseau | @azure/arm-network-profile-2020-09-01-hybrid |
| Ressources | @azure/arm-resources-profile-hybrid-2020-09-01 |
| Keyvault | @azure/arm-keyvault-profile-2020-09-01-hybrid |
Pour utiliser la dernière version d’API d’un service, utilisez le profil Le plus récent de la bibliothèque de client spécifique. Par exemple, si vous souhaitez utiliser la dernière version d’API d’un service de ressources autonome, utilisez le profil azure-arm-resource du package de la bibliothèque de client Gestion des ressources.
Utilisez les versions d’API spécifiques définies dans le package des versions d'API spécifiques à 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 davantage compatibles avec Azure Stack Hub pour autant que vous utilisiez une version portant le tampon 1808 ou une version ultérieure.
@azure-arm-resource
Profil composé des versions les plus récentes de tous les services. Utilisez les dernières versions de tous les services dans Azure.
Profils
Pour les profils qui contiennent des dates, pour utiliser un autre profil ou une autre 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-01 et la chaîne devient @azure/arm-keyvault-profile-2019-03-01-hybrid. Notez que, parfois, l’équipe du kit de développement modifie le nom des packages. Il est donc possible que le remplacement de la date d’une chaîne par une autre date ne fonctionne pas. Consultez le tableau suivant pour l’association des profils et des versions de Azure Stack.
| Version d’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 |
Pour plus d’informations sur Azure Stack Hub et les profils d’API, voir Résumé des profils d’API.
Installer le kit de développement logiciel (SDK) Node.js
Installez Git. Pour obtenir des instructions, consultez Démarrage rapide - Installation de Git.
Installez ou mettez à niveau la version actuelle de Node.js. Node.js comprend également le gestionnaire de package Javascript npm.
Installez ou mettez à niveau Visual Studio Code et installez l'extension Node.js pour Visual Studio Code.
Installez les packages du client pour Azure Stack Hub Resource Manager. Pour plus d’informations, consultez Installer les bibliothèques de client.
Les packages à installer dépendent de la version de profil que vous souhaitez utiliser. La liste des fournisseurs de ressources est disponible 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 manière de créer un abonnement, consultez ce document.
Principal du service
Le principal de service et ses informations d’environnement associées doivent être créés et enregistrés quelque part. Le principal de service avec rôle owner est recommandé, mais en fonction de l’exemple, un rôle contributor 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 tout format pris en charge par le langage du SDK, par exemple à partir d’un fichier JSON (que nos exemples utilisent). Selon l’exemple en cours d’exécution, toutes ces valeurs peuvent ne pas être utilisées. Consultez l’exemple de référentiel pour obtenir des exemples de code à jour ou des informations supplémentaires.
ID client
Pour rechercher le répertoire ou l’ID de locataire de votre environnement Azure Stack Hub, suivez les instructions fournies dans cet article.
Inscrire des fournisseurs de ressources
Inscrivez les fournisseurs de ressources requis en suivant ce document. Ces fournisseurs de ressources seront nécessaires en fonction des exemples que vous souhaitez exécuter. Par exemple, si vous souhaitez exécuter un exemple de machine virtuelle, l’inscription du fournisseur de ressources Microsoft.Compute 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 superviser les ressources Azure. Azure Resource Manager peut gérer ces tâches en groupe, plutôt qu’individuellement, dans une seule opération. Vous pouvez obtenir les informations de métadonnées du point de terminaison du Gestionnaire des ressources. Le point de terminaison retourne un fichier JSON avec les informations requises pour exécuter votre code.
Tenez compte des éléments suivants :
Le ResourceManagerEndpointUrl dans le kit de développement Azure Stack (ASDK) est :
https://management.local.azurestack.external/.Le ResourceManagerEndpointUrl dans les systèmes intégrés est :
https://management.region.<fqdn>/, où<fqdn>est votre nom de domaine complet.Pour extraire les métadonnées requises :
<ResourceManagerUrl>/metadata/endpoints?api-version=1.0
Exemple de code 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"]
}
}
Exemples
Consultez l’exemple de référentiel pour obtenir un exemple de code de mise à jour. La racine README.md décrit les exigences générales, et chaque sous-répertoire contient un exemple spécifique avec son propre README.md sur la façon d’exécuter cet exemple.
Découvrez ici l’exemple applicable à la version Azure Stack 2008 ou au profil 2019-03-01 et versions antérieures.
Étapes suivantes
Découvrez-en plus sur les profils d’API :