Compartir a través de

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

  • Artículo

Perfiles de la versión de API y Node.js

Puede usar el SDK de Node.js para ayudar a crear y administrar la infraestructura de las aplicaciones. Los perfiles de API del SDK de Node.js sirven de ayuda con las soluciones de nube híbrida, ya que permiten cambiar entre los recursos globales de Azure y los recursos de Azure Stack Hub. Puede codificar una vez y, después, seleccionar como destino tanto Azure global como 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 permite ejecutar la aplicación e instalarla 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>.

El SDK de Node.js

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

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

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

  • Para utilizar los servicios compatibles con Azure Stack Hub, use 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 desde el registro npm.

Puede encontrar los siguientes paquetes:

Proveedor de recursos Paquete
App Service @azure/arm-resources-profile-2020-09-01-hybrid
Suscripciones a Azure Resource Manager @azure/arm-subscriptions-profile-hybrid-2020-09-01
Directiva de Azure Resource Manager @azure/arm-policy-profile-hybrid-2020-09-01
DNS de Azure Resource Manager @azure/arm-dns-profile-2020-09-01-hybrid
Autorización @azure/arm-authorization-profile-2020-09-01-hybrid
Proceso @azure/arm-compute-profile-2020-09-01-hybrid
Storage @azure/arm-storage-profile-2020-09-01-hybrid
Network @azure/arm-network-profile-2020-09-01-hybrid
Recursos @azure/arm-resources-profile-hybrid-2020-09-01
KeyVault @azure/arm-keyvault-profile-2020-09-01-hybrid

Para usar la versión más reciente de la API de un servicio, utilice el perfil Más reciente de la biblioteca cliente específica. Por ejemplo, si quiere usar solo la última versión de API del servicio de recursos, utilice el perfil azure-arm-resource del paquete de la biblioteca cliente de Resource Management.

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

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

    Último perfil creado para Azure Stack Hub. Use este perfil para que los servicios sean lo más compatibles posible con Azure Stack Hub, siempre y cuando tenga una marca de versión 1808, o superior.

  • @azure-arm-resource

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

Profiles

En el caso de 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-01 y 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 podría no funcionar simplemente reemplazar la fecha de una cadena por otra fecha. Consulte la tabla siguiente para ver la asociación de perfiles y versiones de Azure Stack.

Versión de Azure Stack Perfil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 01-09-2020
2102 01-09-2020
2008 2019-03-01

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 instrucciones, consulte Introducción: 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 npm de JavaScript.

  3. Instale o actualice Visual Studio Code e instale la extensión de Node.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 el artículo de instalación de las bibliotecas cliente.

  5. Los paquetes que se deben instalar dependerán de la versión del perfil que le gustaría utilizar. Puede encontrar una lista de proveedores de recursos en la sección Paquetes en npm.

Subscription

Si aún no tiene una suscripción, cree una y guarde el ID. de suscripción para usarlo más adelante. Para más información sobre cómo crear una suscripción, vea este documento.

Entidad de servicio

Una entidad de servicio y su información de entorno asociada deben crearse y guardarse en algún lugar. Se recomienda la entidad de servicio con rol owner, pero en función del ejemplo, un rol contributor 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 admitido por el lenguaje SDK, como desde un archivo JSON (que usan nuestros ejemplos). Dependiendo 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 ID. 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 quiere ejecutar un ejemplo de máquina virtual, se requiere el registro del proveedor de recursos Microsoft.Compute.

Punto de conexión del administrador de recursos 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 grupo, en vez de individualmente, en una sola operación. Puede obtener la información de metadatos en el 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.

  • El valor de ResourceManagerEndpointUrl del Kit de desarrollo de Azure Stack (ASDK) es: https://management.local.azurestack.external/.

  • ResourceManagerEndpointUrl en un sistema integrado 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

Ejemplo de 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"]
      }
}

Ejemplos

Consulte el repositorio de ejemplo para obtener código de ejemplo actualizado. 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.

Consulte aquí el ejemplo aplicable a la versión 2008 o el perfil 2019-03-01 de Azure Stack y posteriores.

Pasos siguientes

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