DevGateway com o 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 o front-end 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 dentro de um iFrame e chamar seu DevServer local para ler metadados de produto e item sem publicar um pacote para o seu tenant.

O que o DevGateway faz

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

Como usar manifestos no desenvolvimento

Sua carga de trabalho é baseada em manifesto tanto no desenvolvimento quanto na produção. Durante o desenvolvimento:

• O DevGateway usa sua configuração local para anunciar a identidade e os pontos de entrada da carga de trabalho (conforme definido no manifesto da carga de trabalho).
• Em seguida, o Fabric chama o DevServer para buscar o manifesto do produto e os manifestos de item por meio de pontos de extremidade locais (por exemplo, a rota do /manifests modelo), para que o serviço possa renderizar experiências de navegação, blocos e criação.

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

Fluxo de desenvolvimento típico

1. Inicie o DevServer para hospedar o front-end no localhost.
2. Inicie o DevGateway e entre com um usuário que seja um administrador do workspace de destino.
3. Abra o workspace do Fabric e utilize o ponto de entrada de workload; o Fabric carrega sua interface do usuário em um iFrame e identifica 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.

Confira o tutorial de Introdução para obter instruções passo a passo de configuração e início.

Entradas de configuração

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

• Workspace de destino para registro
• Ponto de extremidade de front-end local (sua URL do DevServer)
• Caminhos ou referências aos arquivos/ativos de manifesto usados durante o desenvolvimento

Os scripts de instalação/build do repositório geram ou atualizam essa configuração automaticamente para que o DevGateway e o DevServer permaneçam em sincronia.

Dicas de solução de problemas

• Se a interface do usuário não abrir no Fabric, verifique se você iniciou o DevGateway e o DevServer e se você está conectado a um workspace em que você tem as permissões necessárias.
• Se o Fabric não puder descobrir itens, confirme se o ponto de extremidade de manifestos do DevServer retorna JSON válido e seu DevGateway está apontando o serviço para a URL de localhost correta.
• Se ícones ou strings estiverem ausentes, verifique os caminhos dos recursos em seus manifestos e se o DevServer os serve.

Consulte também

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