Podręcznik instalacji ręcznej

Zalecamy korzystanie z Przewodnika instalacji zamiast przestrzegać tych instrukcji. Jeśli interesuje Cię szczegółowe informacje lub spróbuj pominąć niektóre kroki, możesz znaleźć informacje na temat ręcznego konfigurowania repozytorium w tym artykule.

Tworzenie plików konfiguracji

Repozytorium pobiera wartości konfiguracji z plików .env.{ENVIROMENT} w repozytorium. W tym celu należy najpierw skopiować plik .env.template do .env.dev.env.test, i .env.prod w tym samym katalogu i wypełnić wartości. Wartości w tych plikach są używane podczas tworzenia manifestu. W przypadku lokalnego programowania wymagany jest tylko plik .env.dev.

Zdecyduj się na wartość WorkloadName i wypełnij go w pliku .env.dev.

Zarejestruj aplikację front endową Microsoft Entra

Możesz użyć CreateDevAADApp.ps1, aby utworzyć aplikację Microsoft Entra albo skorzystać z instrukcji krok po kroku.

1. Przejdź do pozycji Rejestracje aplikacji w portalu Microsoft Entra IDmin.
2. Utwórz nową aplikację multitenantową.

3. Dodaj następujące URI przekierowania SPA do manifestu aplikacji:

• 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}

Wybierz element {WORKLOAD_NAME} w procesie instalacji. Zapoznaj się ze strukturą projektu w repozytorium.

Czy szukasz swojego {TENANT_ID}? Wykonaj te kroki:

1. Otwórz aplikację Microsoft Fabric i wybierz swój obraz profilu w prawym górnym rogu.
2. Wybierz pozycję Informacje z menu rozwijanego.
3. W oknie dialogowym Informacje znajdziesz identyfikator dzierżawcy oraz region dzierżawcy.

Po utworzeniu aplikacji otwórz plik "Workload/.env.dev" i wstaw nazwę Workload w właściwości konfiguracji "WORKLOAD_NAME", a identyfikator klienta aplikacji frontend w właściwości konfiguracji "FRONTEND_APPID".

DevGateway

Repozytorium wymaga więcej oprogramowania, które należy pobrać. W tym celu pobierz DevGateway i rozpakuj do katalogu tools.

Aby uruchomić usługę DevGateway, plik konfiguracji o nazwie workload-dev-mode.json musi być dostępny w build/DevGateway/ katalogu. Ten plik informuje DevGateway, jak zlokalizować i obsłużyć zadanie.

Przykładowa konfiguracja:

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

Wyjaśnienia pól:

• WorkspaceGuid: identyfikator GUID przestrzeni roboczej Fabric, w której jest dostępne obciążenie.
• ManifestPackageFilePath: ścieżka do skompilowanego pakietu manifestu obciążenia (plik nupkg).
• WorkloadEndpointURL: adres URL, pod którym jest hostowane zaplecze obciążenia (zazwyczaj lokalny serwer deweloperski).