Configurar el entorno (versión preliminar)

Este artículo está dirigido a desarrolladores que buscan crear una carga de trabajo mediante el Kit de desarrollo de cargas de trabajo de Microsoft Fabric. El artículo le guiará a través del proceso de configuración del entorno de desarrollo para que pueda empezar a crear la carga de trabajo.

Requisitos previos

Los siguientes pasos son necesarios antes de comenzar a trabajar con el desarrollo de cargas de trabajo.

Git

Sistema de control de versiones distribuido que usamos para administrar y realizar un seguimiento de los cambios en nuestro proyecto.

npm (administrador de paquetes de nodos)

Administrador de paquetes predeterminado para Node.js que se usa para administrar y compartir los paquetes que utiliza en el proyecto.

Node.js

Entorno de tiempo de ejecución de JavaScript multiplataforma y de código abierto que ejecuta código de JavaScript fuera de un navegador web. Lo usaremos para ejecutar el código de JavaScript en el servidor.

Webpack

Paquete de instalación de módulos estáticos para aplicaciones de JavaScript modernas. Ayuda a agrupar archivos JavaScript para su uso en un navegador.

CLI de Webpack

Interfaz de la línea de comandos para Webpack. Esto nos permite usar Webpack desde la línea de comandos.

DevGateway

Solo en el modo local se requiere para permitir que el back-end de carga de trabajo, que se hospeda localmente, se comunique con el inquilino. La carga de trabajo funciona en la máquina del desarrollador. Las llamadas API de carga de trabajo de Fabric a la carga de trabajo se canalizarán a través de Azure Relay, con el lado de la carga de trabajo del canal de Azure Relay administrado por la utilidad de línea de comandos DevGateway. Las llamadas API de control de carga de trabajo se realizan directamente desde la carga de trabajo a Fabric, no requiere el canal de Azure Relay. La utilidad DevGateway también administra el registro de la instancia local (de desarrollo) de la carga de trabajo con Fabric dentro de un contexto de capacidad específico, lo que hace que la carga de trabajo sea accesible en todas las áreas de trabajo asignadas a esa capacidad.

Nota:

Si finaliza la utilidad DevGateway, se quita automáticamente el registro de la instancia de carga de trabajo.

Creación del entorno

Siga estas fases para crear su entorno.

Autenticación del entorno de carga de trabajo

La configuración del acceso de carga de trabajo al inquilino de Fabric requiere la configuración de Microsoft Entra ID para la aplicación de carga de trabajo. Microsoft Entra ID es necesario para garantizar el acceso seguro y el funcionamiento de la API del plano de datos de la aplicación.

Los pasos clave incluyen los siguientes:

1. Adición de ámbitos para la API del plano de datos: estos ámbitos representan grupos de operaciones expuestas por la API del plano de datos. En el ejemplo de back-end se proporcionan cuatro ámbitos de ejemplo, que abarcan operaciones de lectura y escritura para elementos de carga de trabajo y archivos de Lakehouse.

2. Autenticación previa de la aplicación cliente de Fabric: la aplicación cliente de Fabric debe autenticarse previamente para los ámbitos que ha definido. Esto garantiza que puede realizar las operaciones necesarias en los elementos de carga de trabajo y los archivos de Lakehouse.

3. Generación de un secreto para la aplicación: este secreto se usa para proteger la aplicación y se usará al configurar el ejemplo de back-end.

4. Adición de la notificación opcional "idtyp": esta notificación se agrega al token de acceso y se usa para identificarse.

Estos pasos son necesarios al configurar la carga de trabajo. Para obtener una guía detallada sobre cómo realizar estos pasos, consulte Configuración de autenticación.

Aplicación web (solo en modo de nube)

La implementación de cargas de trabajo en el modo nube (junto con el modo de máquina local) requiere la configuración del dominio de una aplicación web para el front-end (FE) y el back-end (BE). Deben ser subdominios del id. de recurso con un máximo de un segmento más. El dominio de host de la dirección URL de respuesta debe ser el mismo que el dominio de host del FE. Para obtener más información, consulte Creación e implementación de la aplicación web de back-end reutilizable.

Configuración de un inquilino de desarrollo de Fabric

En el contexto de la ejecución del SDK de carga de trabajo de muestra y la creación de una carga de trabajo, se recomienda emplear un inquilino de desarrollo dedicado. Esta práctica garantiza un entorno aislado, lo que minimiza el riesgo de interrupciones o modificaciones involuntarias en los sistemas de producción. Además, proporciona una capa adicional de seguridad, lo que protege los datos de producción frente a una posible exposición o peligro. El cumplimiento de esta recomendación se alinea con los procedimientos recomendados del sector y contribuye a un ciclo de vida de desarrollo sólido, confiable y seguro.

Configuración del inquilino y configuración del desarrollo

1. Hace falta el permiso de administradores de Fabric para poder comenzar el desarrollo y conectarse con la máquina local a una capacidad de Fabric. Solo los desarrolladores con permiso de administrador de capacidad pueden conectar y registrar su carga de trabajo en una capacidad. El desarrollo del front-end no requiere permisos de administrador de capacidad.

   Para permitir que un usuario inicie el desarrollo, incluyéndolas en la configuración de inquilino de los administradores de capacidad pueden desarrollar cargas de trabajo adicionales.

   

2. Después de haberse concedido permiso al usuario en el paso anterior, cada usuario puede habilitar el modo para desarrolladores para el área de configuración de desarrollo en Modo para desarrolladores de Fabric.

   

Contenido relacionado

• Guía de inicio rápido
• Información general sobre la autenticación