Uso de perfiles de versión de API con Node.js kit de desarrollo de software (SDK) en Azure Stack Hub

perfiles de versión de Node.js y API

Puede usar Node.js SDK para ayudar a crear y administrar la infraestructura de las aplicaciones. Los perfiles de API del SDK de Node.js ayudan con las soluciones de nube híbrida al permitirle cambiar entre los recursos globales de Azure y los recursos de Azure Stack Hub. Puede codificar una vez y, a continuación, dirigirse tanto a Azure global como a Azure Stack Hub.

En este artículo, puede usar Visual Studio Code como herramienta de desarrollo. Visual Studio Code puede depurar el SDK de Node.js y le permite ejecutar la aplicación e insertarla en la instancia de Azure Stack Hub. Puede depurar desde Visual Studio Code o a través de una ventana de terminal que ejecute el comando node <nodefile.js>.

Sdk de Node.js

El SDK de Node.js proporciona herramientas de Resource Manager de Azure Stack Hub. Los proveedores de recursos del SDK incluyen proceso, redes, almacenamiento, servicios de aplicaciones y KeyVault. Hay 10 bibliotecas cliente del proveedor de recursos que puede instalar en la aplicación node.js. También puede descargar el proveedor de recursos que usará para el perfil 2020-09-01 para optimizar la memoria de la aplicación. Cada módulo consta de un proveedor de recursos, la versión de API correspondiente y el perfil de API.

Un perfil de API es una combinación de proveedores de recursos y versiones de API. Puede usar un perfil de API para obtener la versión más reciente y estable de cada tipo de recurso en un paquete de proveedor de recursos.

• Para usar las versiones más recientes de todos los servicios, use el perfil más reciente de los paquetes.

• Para usar los servicios compatibles con Azure Stack Hub, use el @azure/arm-resources-profile-hybrid-2020-09-01 o @azure/arm-storage-profile-2020-09-01-hybrid

Paquetes de NPM

Cada proveedor de recursos tiene su propio paquete. Puede obtener el paquete del registro de npm.

Puede encontrar los siguientes paquetes:

Para usar la versión más reciente de la API de un servicio, use el perfil Más reciente de la biblioteca cliente específica. Por ejemplo, si desea usar solo la versión más reciente de API del servicio de recursos, use el azure-arm-resource perfil de la biblioteca cliente de Administración de recursos.

Use las versiones de API específicas definidas dentro del paquete para las versiones de API específicas de un proveedor de recursos.

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

  Perfil más reciente creado para Azure Stack Hub. Use este perfil para que los servicios sean más compatibles con Azure Stack Hub siempre y cuando esté en una marca de 1808 o más.

• @azure-arm-resource

  El perfil consta de versiones más recientes de todos los servicios. Use las versiones más recientes de todos los servicios de Azure.

Perfiles

Para los perfiles que contienen fechas, para usar otro perfil o versión del SDK, puede sustituir la fecha en @azure/arm-keyvault-profile-<date>-hybrid. Por ejemplo, para la versión 2008, el perfil es 2019-03-01y la cadena se convierte en @azure/arm-keyvault-profile-2019-03-01-hybrid. Tenga en cuenta que, a veces, el equipo del SDK cambia el nombre de los paquetes, por lo que es posible que no funcione simplemente la fecha de una cadena con una fecha diferente. Consulte la tabla siguiente para obtener una asociación de perfiles y versiones de Azure Stack.

Para más información sobre los perfiles de API y Azure Stack Hub, consulte resumen de perfiles de API.

Instalación del SDK de Node.js

1. Instale Git. Para obtener instrucciones, consulte Introducción a la instalación de Git.

2. Instale o actualice a la versión actual de Node.js. Node.js también incluye el administrador de paquetes de JavaScript de npm .

3. Instale o actualice Visual Studio Code e instale la extensiónNode.js para Visual Studio Code.

4. Instale los paquetes de cliente para resource Manager de Azure Stack Hub. Para obtener más información, consulte cómo instalar bibliotecas cliente.

5. Los paquetes que deben instalarse dependen de la versión del perfil que quiera usar. Puede encontrar una lista de proveedores de recursos en la sección Paquetes en npm .

Suscripción

Si aún no tiene una suscripción, cree una suscripción y guarde el identificador de suscripción que se usará más adelante. Para obtener información sobre cómo crear una suscripción, consulte este documento.

Principal de servicio

Se debe crear y guardar en algún lugar una entidad de servicio y su información de entorno asociada. Se recomienda la entidad de servicio con owner rol, pero dependiendo del ejemplo, un contributor rol puede ser suficiente. Consulte el archivo Léame en el repositorio de ejemplo para conocer los valores necesarios. Puede leer estos valores en cualquier formato compatible con el lenguaje sdk, como desde un archivo JSON (que usan nuestros ejemplos). En función de la ejecución del ejemplo, no se pueden usar todos estos valores. Consulte el repositorio de ejemplo para obtener código de ejemplo actualizado o más información.

Id. de inquilino

Para buscar el directorio o el identificador de inquilino de Azure Stack Hub, siga las instrucciones de este artículo.

Registro de proveedores de recursos

Registre los proveedores de recursos necesarios siguiendo este documento. Estos proveedores de recursos serán necesarios en función de los ejemplos que quiera ejecutar. Por ejemplo, si desea ejecutar un ejemplo de máquina virtual, se requiere el registro del Microsoft.Compute proveedor de recursos.

Punto de conexión de Resource Manager de Azure Stack

Azure Resource Manager (ARM) es un marco de administración que permite a los administradores implementar, administrar y supervisar recursos de Azure. Azure Resource Manager puede controlar estas tareas como un grupo, en lugar de individualmente, en una sola operación. Puede obtener la información de metadatos del punto de conexión de Resource Manager. El punto de conexión devuelve un archivo JSON con la información necesaria para ejecutar el código.

Tenga en cuenta lo siguiente.

• ResourceManagerEndpointUrl en el Kit de desarrollo de Azure Stack (ASDK) es: https://management.local.azurestack.external/.

• ResourceManagerEndpointUrl en sistemas integrados es: https://management.region.<fqdn>/, donde <fqdn> es el nombre de dominio completo.

• Para recuperar los metadatos necesarios: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

JSON de ejemplo:

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

Muestras

Consulte el repositorio de ejemplo para obtener código de ejemplo de actualización a fecha. La raíz README.md describe los requisitos generales y cada subdirectorio contiene un ejemplo específico con su propio README.md modo de ejecutar ese ejemplo.

Pasos siguientes

Más información sobre los perfiles de API:

• Administración de perfiles de la versión de API en Azure Stack Hub
• Versiones de API del proveedor de recursos compatibles con perfiles