Configuración del modo de nube de carga de trabajo

Artículo
11/25/2024

En este artículo, aprenderá los requisitos para implementar una carga de trabajo que funcione en un servidor remoto con acceso a Internet en Microsoft Fabric.

La implementación tiene dos partes principales:

Código de cliente de carga: código del frontend que se inserta como un iFrame en la interfaz de usuario de Microsoft Fabric.
Back-end de la carga de trabajo: el back-end, el componente del lado del servidor que procesa su carga de trabajo.

Implemente ambos componentes como servicios en la nube. Puede hospedar los dos componentes en servidores independientes si es necesario.

Para trabajar con la carga de trabajo en modo de nube, debe configurar correctamente la información y los dominios de la aplicación.

Formato de resourceId de la aplicación Microsoft Entra ID

El valor de la aplicación Microsoft Entra ID resourceId debería tener el siguiente formato:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>

Dominio verificado del inquilino de ISV: una coincidencia exacta del dominio verificado en el inquilino del editor sin prefijos ni subdominios. Descubra cómo agregar un nombre de dominio personalizado a Microsoft Entra.
Servidor front-end de carga de trabajo: el nombre del servidor front-end tal como aparece en la dirección URL de front-end (el segmento adicional de la dirección URL de front-end en la parte superior del dominio comprobado).
Servidor back-end de carga de trabajo: el nombre del servidor back-end tal como aparece en la dirección URL de back-end (el segmento adicional de la dirección URL de back-end en la parte superior del dominio comprobado).
Id. de carga de trabajo: el identificador de carga de trabajo tal como aparece en el manifiesto de carga de trabajo.
Id. del recurso: se puede agregar una cadena opcional al final del valor resourceId.

Nota:

No se permiten subdominios *.onmicrosoft en direcciones URL.
La cadena opcional debe contener caracteres alfanuméricos (inglés) o guiones únicamente y no pueden superar una longitud de 36 caracteres.

Dominios front-end y back-end

Las direcciones URL de front-end y back-end deben ser subdominios del valor resourceId, con un máximo de un segmento adicional.
El dominio de host de la dirección URL de respuesta debe ser el mismo que el dominio de host del front-end.

Ejemplos

Valor resourceId de la aplicación Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
Dominio front-end: https://feserver.datafactory.contoso.com
Dominio back-end: https://beserver.datafactory.contoso.com
URI de redirección: https://feserver.datafactory.contoso.com/close

Configuración de los puntos de conexión de la carga de trabajo

Para configurar los puntos de conexión de la carga de trabajo:

Agregue la dirección URL de back-end de la carga de trabajo a la sección CloudServiceConfiguration del manifiesto y asígnele el nombre Workload.
Agregue la dirección URL de front-end de la carga de trabajo a la sección CloudServiceConfiguration del manifiesto y asígnele el nombre Frontend.

Este es un ejemplo:

<CloudServiceConfiguration>
    <Cloud>Public</Cloud>
    ...
    <Endpoints>
        <ServiceEndpoint>
        <Name>Workload</Name>
        <Url>https://beserver.datafactory.contoso.com/workload</Url>
        </ServiceEndpoint>
        <ServiceEndpoint>
        <Name>Frontend</Name>
        <Url>https://feserver.datafactory.contoso.com</Url>
        </ServiceEndpoint>
    </Endpoints>
</CloudServiceConfiguration>

Configurar su aplicación en Microsoft Entra ID

Para configurar su aplicación en Microsoft Entra:

La dirección URL de redireccionamiento debe apuntar a la dirección URL de front-end anexada con /close. Por ejemplo, feserver.datafactory.contoso.com/close.
El URI del identificador de aplicación debe coincidir con el dominio comprobado de la aplicación.

Nota:

Todas las demás configuraciones de aplicación en Microsoft Entra ID son las mismas que en el modo para desarrolladores.

Configuración de la carga de trabajo (back-end)

En el ejemplo del back-end, abra src/appsettings.json y establezca la siguiente configuración:
- En PublisherTenantId, seleccione el identificador de inquilino del publicador.
- En ClientId, escriba el id. de su aplicación (que encontrará en la información general de Microsoft Entra ID).
- En ClientSecret, escriba el secreto que creó cuando configuró la aplicación Microsoft Entra ID.
- En Audiencia, escriba el URI de id. que configuró en la aplicación Microsoft Entra ID.
Abra src/Packages/manifest/WorkloadManifest.xml.
En AADApp, establezca AppId, redirectUri y ResourceId (el URI de id.).

Tenga en cuenta los requisitos que se especifican en el archivo XSD y en la información general del manifiesto de back-end.

Configuración de la aplicación de front-end

.En el archivo .env.test, establezca WORKLOAD_BE_URL en la dirección URL de back-end de su carga de trabajo (por ejemplo, establézcala en beserver.datafactory.contoso.com).