Compartir a través de

Inicio rápido: Ejecución de una carga de trabajo de muestra

  • Artículo

Esta guía de inicio rápido le muestra cómo crear y ejecutar una carga de trabajo de Microsoft Fabric mediante una carga de trabajo de muestra.

Requisitos previos

Antes de empezar, asegúrese de que tiene instalado lo siguiente en su sistema:

Guía paso a paso

Habilitar cargas de trabajo personalizadas

Configure el portal de administración de la manera siguiente:

  1. Inicie sesión en Fabric con una cuenta de administrador.

  2. En Configuración, vaya a Portal de administración.

    Captura de pantalla en la que se muestra cómo ir al Portal de administración de Fabric.

  3. En la sección Cargas de trabajo adicionales, habilite la configuración de inquilino y los administradores y contribuyentes de capacidad pueden agregar y eliminar cargas de trabajo adicionales. Puede habilitarla para toda la organización o para un grupo específico.

Configuración del proyecto de ejemplo

  1. Clone el repositorio: clone el repositorio que se encuentra aquí: Directorio de proyecto de ejemplo

  2. Instalar dependencias: vaya al directorio Frontend dentro del repositorio clonado y ejecute el sisguiente comando:

    npm install

  3. Inicie el servidor local: inicie un servidor de Node.js local mediante webpack la ejecución de:

    npm start

    Normalmente, el servidor se ejecuta en el puerto 60006. Confirme que el servidor está operativo accediendo a 127.0.0.1:60006/manifests y compruebe el archivo de configuración .env.dev en la carpeta front-end.

  4. Habilitar el modo de desarrollador de front-end: en la configuración del inquilino del portal de administración, en la sección Cargas de trabajo adicionales y activar los administradores de capacidad de pueden desarrollar cargas de trabajo adicionales. configuración de inquilino. Esta configuración permite las conexiones al servidor local y se conserva en las sesiones del explorador.

Ejecución de una carga de trabajo de muestra

Una vez que el servidor local esté funcionando y el modo para desarrolladores esté activado, la nueva carga de trabajo de muestra aparecerá en el menú.

  1. Acceder a la carga de trabajo de muestra: para iniciar la experiencia Crear, vaya hasta la página principal de la carga de trabajo de muestra.

Preparación del entorno de desarrollo

  1. Abrir la solución: abra la solución en Visual Studio 2022 para garantizar la compatibilidad con net7.

  2. Registro de aplicaciones: siga la guía de autenticación para configurar la autenticación de Microsoft Entra ID para interacciones seguras dentro de la arquitectura.

  3. Configure los ajustes de la carga de trabajo: actualización de src/Config/workload-dev-mode.json y src/appsettings.json con los detalles de configuración específicos:

    • Copie workload-dev-mode.json de src/Config a C:\ y actualice los campos siguientes para que coincidan con la configuración:

    Nota:

    Puede copiarlo en cualquier otra ruta y configurar el argumento de línea de comandos "-DevMode:LocalConfigFilePath" en su proyecto para especificar la ruta.

    • WorkspaceGuid: identificador del área de trabajo. Busque en la dirección URL del explorador al seleccionar un área de trabajo en Fabric, por ejemplo, https://app.fabric.microsoft.com/groups/{WorkspaceID}/.

    • ManifestPackageFilePath: ubicación del paquete de manifiesto. Cuando cree la solución, se guardará el paquete de manifiesto en src\bin\Debug. Más detalles sobre el paquete de manifiesto se puede encontrar en los pasos posteriores.

    • WorkloadEndpointURL: dirección URL del punto de conexión de carga de trabajo.

    • En el archivo src/appsettings.json, actualice los siguientes campos para que coincidan con su configuración:

      • PublisherTenantId: id. del inquilino del publicador de la carga de trabajo.
      • ClientId: id. de cliente (AppID) de la aplicación de Microsoft Entra de la carga de trabajo.
      • ClientSecret: secreto de cliente para la aplicación de Microsoft Entra de la carga de trabajo.
      • Audiencia: la audiencia de los tokens entrantes de Microsoft Entra se puede encontrar en el registro de la aplicación que creó en la sección "Exponer una API". Esto también se conoce como URI de identificador de aplicación.

  4. Configurar el archivo WorkloadManifest.xml: configure el archivo WorkloadManifest.xml con los siguientes detalles de la aplicación Microsoft Entra:

    • AppID
    • ResourceID
    • RedirectURI

  5. Generar paquete de manifiesto: compile la solución para crear el archivo de paquete de manifiesto, que incluye validar y empaquetar los archivos XML y JSON necesarios.

    • Desencadene Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe en workloadManifest.xml en Packages\manifest\files\ (puede encontrar el código del proceso de validación en el directorio \workloadManifestValidator). Si se produce un error en la validación, se genera un archivo de error que especifica la validación fallida.
    • Si el archivo de error existe, la compilación falla con "Error de validación WorkloadManifest". Puede hacer doble clic en el error en VS Studio y se le mostrará el archivo de error.
    • Después de la validación, empaquete los archivos WorkloadManifest.xml y FrontendManifest.json en ManifestPackage.1.0.0.nupkg. El paquete resultante se encuentra en src\bin\Debug.

    Copie el archivo ManifestPackage.1.0.0.nupkg en la ruta definida en el archivo de configuración workload -dev -mode.json.

  6. Ejecute DevGateway: ejecute "Microsoft.Fabric.Workload.DevGateway.exe" e inicie sesión con un usuario que tenga privilegios de administrador del área de trabajo para el área de trabajo especificada en el WorkspaceGuid campo de workload-dev-mode.json.

  7. Inicie el proyecto: establezca el proyecto "Reutilizable" como proyecto de inicio en Visual Studio y ejecútelo.

Pasos adicionales

  • Actualice los archivos de configuración de la carga de trabajo según sea necesario.
  • Compile la solución para asegurarse de que todas las dependencias están correctamente vinculadas.
  • Ejecute el frontend y devgateway para establecer la comunicación con el backend de Fabric.
  • Cree elementos y ejecute trabajos para probar todas las capacidades de su carga de trabajo.

Contenido relacionado