Partilhar via

Configurar o modo de nuvem de carga de trabalho

  • Artigo

Neste artigo, saiba os requisitos para implantar uma carga de trabalho que opera em um servidor remoto com acesso à Internet no Microsoft Fabric.

A implantação tem duas partes principais:

  • Código do cliente de carga de trabalho: código de front-end incorporado como um iFrame na interface do usuário do Microsoft Fabric.
  • Back-end de carga de trabalho: o componente de back-end, do lado do servidor, que processa sua carga de trabalho.

Implante ambos os componentes como serviços de nuvem. Você pode hospedar os dois componentes em servidores separados, se necessário.

Para trabalhar com sua carga de trabalho no modo de nuvem, você deve configurar as informações e os domínios do aplicativo corretamente.

Formato resourceId do aplicativo Microsoft Entra ID

O valor do aplicativo resourceId Microsoft Entra ID deve estar no seguinte formato:

https://<ISV's tenant verified domain>/<workload frontend server>/<workload backend server>/<workload id>/<optional string>
  • Domínio verificado do locatário do ISV: uma correspondência exata do domínio verificado no locatário do editor sem prefixos ou subdomínios. Saiba como adicionar um domínio personalizado aoMicrosoft Entra.
  • Servidor frontend de carga de trabalho: O nome do servidor frontend tal como aparece no URL do frontend (o segmento extra no URL do frontend na parte superior do domínio verificado).
  • Servidor back-end de carga de trabalho: o nome do servidor back-end como aparece na URL de back-end (o segmento extra na URL de back-end na parte superior do domínio verificado).
  • ID da carga de trabalho: a ID da carga de trabalho tal como aparece no manifesto da carga de trabalho.
  • ID do recurso: uma cadeia de caracteres opcional pode ser adicionada ao final do resourceId valor.

Nota

  • *.onmicrosoft subdomínios não são permitidos em URLs.
  • A cadeia de caracteres opcional deve conter caracteres alfanuméricos (inglês) ou apenas hífenes e não pode exceder um comprimento de 36 caracteres.

Domínios de frontend e backend

  • As URLs de frontend e back-end devem ser subdomínios do resourceId valor, com no máximo um segmento extra.
  • O domínio de host da URL de resposta deve ser o mesmo que o domínio do host frontend.

Exemplos

  • Valor do aplicativo resourceId Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
  • Domínio frontend: https://feserver.datafactory.contoso.com
  • Domínio de back-end: https://beserver.datafactory.contoso.com
  • URI de redirecionamento: https://feserver.datafactory.contoso.com/close

Configurar os pontos finais da carga de trabalho

Para configurar os pontos finais da carga de trabalho:

  1. Adicione a URL de back-end da carga de trabalho à CloudServiceConfiguration seção no manifesto e nomeie-a Workload.

  2. Adicione a URL de frontend da carga de trabalho à CloudServiceConfiguration seção no manifesto e nomeie-a Frontend.

Eis um exemplo:

<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>

Configure seu aplicativo no Microsoft Entra ID

Para configurar a sua aplicação no Microsoft Entra:

  1. O URL de redirecionamento deve apontar para o URL de frontend anexado com /close. Por exemplo, feserver.datafactory.contoso.com/close.
  2. O URI do ID do aplicativo deve corresponder ao domínio verificado do seu aplicativo.

Nota

Todas as outras configurações de aplicativos no Microsoft Entra ID são as mesmas do modo de desenvolvedor.

Configure sua carga de trabalho (back-end)

  1. No exemplo de back-end, abra src/appsettings.json e defina as seguintes configurações:

    • Para PublisherTenantId, selecione a ID do locatário do editor.
    • Para ClientId, insira a ID do aplicativo (encontrada na visão geral da ID do Microsoft Entra).
    • Para ClientSecret, insira o segredo que você criou quando configurou o aplicativo Microsoft Entra ID.
    • Em Audiência, insira o URI de ID que você configurou no aplicativo Microsoft Entra ID.

  2. Abra src/Packages/manifest/WorkloadManifest.xml.

  3. Em AADApp, defina AppId, redirectUrie ResourceId (o URI de ID).

Observe os requisitos especificados no arquivo XSD e na visão geral do manifesto de back-end.

Configurar seu aplicativo frontend

No arquivo .env.test, defina WORKLOAD_BE_URL a URL de back-end da carga de trabalho (por exemplo, defina-a como beserver.datafactory.contoso.com).

Eis um exemplo:

WORKLOAD_NAME=Fabric.WorkloadSample
WORKLOAD_BE_URL=beserver.datafactory.contoso.com