DevGateway com Microsoft Fabric

O DevGateway é um pequeno auxiliar que você executa durante o desenvolvimento para registrar sua instância de carga de trabalho local com o Fabric. Ele informa ao serviço Fabric onde seu frontend está hospedado (seu DevServer no localhost) e quais itens estão disponíveis, com base em seus manifestos. Com o DevGateway em execução, o Fabric pode carregar sua interface do usuário em um iFrame e chamar seu DevServer local para ler metadados de produtos e itens, sem publicar um pacote para seu locatário.

O que o DevGateway faz

• Registra uma instância de carga de trabalho local em um espaço de trabalho específico para o desenvolvedor conectado atual.
• Informa o Fabric sobre sua identidade de carga de trabalho e ponto de entrada usando seus manifestos.
• Encaminha chamadas de host do Fabric para o seu ambiente local para que a plataforma possa carregar o seu frontend e descobrir itens enquanto você iterar.
• Funciona lado a lado com o DevServer, que realmente hospeda o frontend e expõe endpoints de manifesto.

Como se utilizam os manifestos no desenvolvimento

Sua carga de trabalho é orientada por manifestos tanto no desenvolvimento quanto na produção. Durante o desenvolvimento:

• O DevGateway usa a sua configuração local para anunciar a identidade da carga de trabalho e os pontos de entrada (conforme definido no manifesto da carga de trabalho).
• O Fabric chama então o seu DevServer para obter o manifesto de Produto e os manifestos de Itens através de endpoints locais (por exemplo, a rota /manifests do template), de modo que o serviço possa renderizar a navegação, os tiles e as experiências de criação.

Isso reflete o que acontece no momento da publicação, mas tudo permanece local para iteração rápida.

Fluxo de desenvolvimento típico

1. Inicie seu DevServer para hospedar o frontend no localhost.
2. Inicie o DevGateway e entre com um usuário que seja administrador do espaço de trabalho de destino.
3. Abra o espaço de trabalho do Fabric e use o ponto de entrada da carga de trabalho; O Fabric carrega sua interface do usuário em um iFrame e descobre itens por meio de seus manifestos.
4. Edite a interface do usuário e os arquivos de manifesto, atualize para ver as alterações imediatamente.

Consulte o tutorial de Início para instruções passo a passo para a configuração e o início.

Entradas de configuração

Dependendo do seu modelo, o DevGateway lê uma configuração local que inclui:

• Espaço de trabalho de destino para registro
• Endpoint de frontend local (a sua URL do DevServer)
• Caminhos ou referências para os seus ficheiros/recursos de manifesto usados durante o desenvolvimento

Os scripts de configuração/construção do seu repositório geram ou atualizam esta configuração automaticamente para que o DevGateway e o DevServer permaneçam sincronizados.

Dicas de solução de problemas

• Se a interface não abrir no Fabric, certifique-se de que iniciou tanto o DevGateway como o DevServer, e que iniciou sessão num espaço de trabalho onde tem as permissões necessárias.
• Se o Fabric não conseguir detetar itens, confirme que o endpoint dos manifestos do seu DevServer devolve JSON válido e que o seu DevGateway está a apontar o serviço para a URL correta do localhost.
• Se ícones ou strings estiverem faltando, verifique os caminhos de recursos nos seus ficheiros manifesto e se o seu DevServer os serve.

Consulte também

• DevServer
• Visão geral do manifesto
• Manifesto da carga de trabalho
• Manifesto do produto
• Manifesto do item