Guia de configuração manual

É recomendável usar o Guia de Instalação em vez de seguir estas instruções. Caso esteja interessado nos detalhes ou tente ignorar algumas etapas, você pode encontrar as informações sobre como configurar o repositório manualmente neste artigo.

Criar os arquivos de configuração

O repositório usa os valores de configuração dos arquivos .env.{ENVIROMENT} no repositório. Para isso, primeiro você precisa copiar o arquivo .env.template para .env.dev, .env.teste .env.prod no mesmo diretório e preencher os valores. Os valores nesses arquivos são usados na criação do Manifesto. Para desenvolvimento local, somente o arquivo .env.dev normalmente é necessário.

Decida um WorkloadName e preencha-o no arquivo .env.dev.

Registrar um aplicativo de front-end do Microsoft Entra

Você pode usar o CreateDevAADApp.ps1 para criar um novo aplicativo do Microsoft Entra ou seguir as etapas.

1. Navegue até Registros de Aplicativos no Portal de Administração do Microsoft Entra.
2. Crie um novo aplicativo multilocatário.

3. Adicione os seguintes redirectURIs do SPA ao manifesto do aplicativo:

• https://app.fabric.microsoft.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
• https://app.powerbi.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
• https://msit.fabric.microsoft.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}
• https://msit.powerbi.com/workloadSignIn/{TENANT_ID}/{WORKLOAD_NAME}

Escolha o {WORKLOAD_NAME} no processo de instalação. Dê uma olhada na Estrutura do Projeto no repositório.

Procurando seu {TENANT_ID}? Siga estas etapas:

1. Abra o Microsoft Fabric e selecione na sua imagem de perfil no canto superior direito.
2. Selecione Sobre no menu dropdown.
3. Na caixa de diálogo Sobre, você encontra a ID do Locatário e a Região do Locatário.

Depois que o aplicativo for criado, abra o arquivo "Workload/.env.dev" e insira o nome do Workload no "WORKLOAD_NAME" e o ID do cliente do aplicativo Front-End na propriedade de configuração "FRONTEND_APPID".

DevGateway

O repositório exigia mais software que precisasse ser baixado. Para isso, você precisa baixar o DevGateway e descompactá-lo no tools diretório.

Para iniciar o DevGateway, um arquivo de configuração nomeado workload-dev-mode.json precisa estar disponível no build/DevGateway/ diretório. Esse arquivo informa ao DevGateway como localizar e atender sua carga de trabalho.

Configuração de exemplo:

{
    "WorkspaceGuid": "your-workspace-guid-here",
    "ManifestPackageFilePath": "path/to/Your/Repo/build/Manifest/[WorkloadName].[Version].nupkg",
    "WorkloadEndpointURL": "http://127.0.0.1:5000/workload"
}

Explicações de campo:

• WorkspaceGuid: o GUID do workspace do Fabric em que a carga de trabalho está disponível.
• ManifestPackageFilePath: caminho para o pacote de manifesto do workload compilado (arquivo .nupkg).
• WorkloadEndpointURL: URL em que o back-end da carga de trabalho está hospedado (normalmente o servidor de desenvolvimento local).