Configurar o modo de nuvem da carga de trabalho

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

A implantação possui duas partes principais:

• Código do cliente da carga de trabalho: Código front-end que é incorporado como um iFrame na interface do usuário do Microsoft Fabric.
• back-end da carga de trabalho: O back-end, componente 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 corretamente as informações do aplicativo e os domínios.

Formato resourceId do aplicativo Microsoft Entra ID

O valor resourceId do aplicativo 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 quaisquer prefixos ou subdomínios. Saiba como adicionar um domínio personalizado ao Microsoft Entra.
• Servidor de front-end da carga de trabalho: O nome do servidor de front-end conforme aparece na URL do front-end (o segmento extra na URL do front-end além do domínio verificado).
• Servidor deback-end da carga de trabalho: O nome do servidor de back-end conforme aparece na URL do back-end (o segmento extra na URL do back-end além do domínio verificado).
• ID da carga de trabalho: A ID da carga de trabalho conforme aparece no manifesto da carga de trabalho.
• ID do recurso: Uma cadeia de caracteres opcional pode ser adicionada ao final do valor resourceId.

Observação

• Subdomínios com *.onmicrosoft não são permitidos em URLs.
• A sequência opcional deve conter somente caracteres alfanuméricos (em inglês) ou hifens, e não pode exceder 36 caracteres.

Domínios de front-end e de back-end

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

Exemplos

• Valor resourceId do aplicativo Microsoft Entra ID: https://datafactory.contoso.com/feserver/beserver/Fabric.WorkloadSample/123
• Domínio de front-end: 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 de extremidade da carga de trabalho

Para configurar os pontos de extremidade da carga de trabalho:

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

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

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

Configurar seu aplicativo no Microsoft Entra ID

Para configurar seu aplicativo no Microsoft Entra:

1. A URL de redirecionamento deve apontar para sua URL de front-end adicionada com /close. Por exemplo, feserver.datafactory.contoso.com/close.
2. O URI da ID do aplicativo deve corresponder ao domínio verificado do aplicativo.

Observação

Todas as outras configurações do aplicativo no Microsoft Entra ID são as mesmas que no 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 seu aplicativo (encontrado na visão geral do Microsoft Entra ID).
   • Para ClientSecret, insira o segredo que você criou ao configurar o aplicativo Microsoft Entra ID.
   • Para Público-alvo, insira o URI da ID que você configurou no aplicativo Microsoft Entra ID.

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

3. Em AADApp, defina AppId, redirectUri e ResourceId (o URI da ID).

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

Configure seu aplicativo de front-end

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

Veja um exemplo:

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