Guia de configuração manual

Recomendamos usar o Guia de configuração em vez de seguir estas instruções. Caso você esteja interessado nos detalhes ou tente pular 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 obtém os valores de configuração dos ficheiros .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 o desenvolvimento local, apenas o arquivo .env.dev é normalmente necessário.

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

Registrar uma aplicação front-end do Microsoft Entra

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

1. Navegue para registos de aplicações no Portal Microsoft Entra IDmin.
2. Crie uma nova aplicação Multitenant.

3. Adicione os seguintes URIs de redirecionamento de 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 configuração. Dê uma olhada na Estrutura do Projeto no repositório.

Procurando o seu {TENANT_ID}? Siga estes passos:

1. Abra o Microsoft Fabric e selecione sua foto de perfil no canto superior direito.
2. Selecione Acerca no menu suspenso.
3. Na caixa de diálogo Sobre, encontra-se o ID do Inquilino e a Região do Inquilino.

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

DevGateway

O repositório exigia mais software que precisava 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 chamado 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.

Exemplo de configuração:

{
    "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 espaço de trabalho do Fabric onde a carga de trabalho está disponível.
• ManifestPackageFilePath: Caminho para o pacote de manifesto de carga de trabalho compilado (arquivo .nupkg).
• WorkloadEndpointURL: URL onde o back-end da carga de trabalho está hospedado (normalmente o servidor de desenvolvimento local).