Rychlý start: Spuštění ukázky úloh (Preview)
V této úvodní příručce se dozvíte, jak vytvořit a spustit úlohu Microsoft Fabric pomocí ukázkové úlohy.
Požadavky
Než začnete, ujistěte se, že máte v systému nainstalovanou následující:
- Přístup k tenantovi Fabric s povolenou funkcí úloh a režimem vývojáře Další informace najdete v tématu Úvod k úlohám .
- Node.js.
- npm.
- Modul runtime .NET 6.0
- ASP.NET Core Runtime 6.0.
- Visual Studio 2022.
- DevGateway pro úlohy Fabric
Podrobný průvodce
Povolení vlastních úloh
Portál pro správu nakonfigurujte následujícím způsobem:
Přihlaste se k Prostředkům infrastruktury pomocí účtu správce.
V Nastavení přejděte na portál pro správu.
V části Další úlohy (Preview) povolte správcům a přispěvatelům kapacity přidávat a odebírat další nastavení tenanta úloh. Můžete ho povolit pro celou organizaci nebo konkrétní skupiny.
Nastavení ukázkového projektu
Naklonujte úložiště: Naklonujte úložiště, které najdete tady: Ukázkový adresář projektu
Instalace závislostí: Přejděte do
Frontend
adresáře v klonovaném úložišti a spusťte následující příkaz:npm install
Spusťte místní server: Spuštěním následujícího příkazu spusťte místní Node.js server
webpack
:npm start
Server obvykle běží na portu
60006
. Ověřte, že je server funkční, a127.0.0.1:60006/manifests
zkontrolujte konfigurační soubor .env.dev ve front-endové složce.Povolte front-endový vývojářský režim: V nastavení tenanta na portálu pro správu v části Další úlohy (Preview) a aktivace správců kapacity může vyvíjet další úlohy. Nastavení tenanta. Toto nastavení umožňuje připojení k místnímu serveru a zachovává se napříč relacemi prohlížeče.
Spuštění ukázkové úlohy
Po spuštění místního serveru a povolení vývojářského režimu se nová ukázková úloha zobrazí v nabídce.
- Přístup k ukázkové úloze: Pokud chcete spustit prostředí Pro vytvoření , přejděte na domovskou stránku ukázkové úlohy.
Příprava vývojového prostředí
Klonujte často používaný projekt: Naklonujte často používaný projekt zde: Ukázkový adresář projektu
Otevřete řešení: Otevřete řešení v sadě Visual Studio 2022 , abyste zajistili kompatibilitu s net7.
Registrace aplikace: Postupujte podle průvodce ověřováním a nastavte ověřování POMOCÍ ID microsoftu pro zabezpečené interakce v architektuře.
Aktualizujte základní adresu URL oneLake DFS: Upravte
EnvironmentConstants.cs
soubor ve složce tak, aby odpovídal vašemusrc/Constants/
prostředí.Konfigurace nastavení úloh: Aktualizujte
src/Config/workload-dev-mode.json
asrc/appsettings.json
aktualizujte konkrétní podrobnosti konfigurace:- Zkopírujte workload-dev-mode.json z nástroje src/Config
C:\
a aktualizujte následující pole tak, aby odpovídala vaší konfiguraci:
Poznámka:
Můžete ho zkopírovat do jakékoli jiné cesty a nastavit argument příkazového řádku -DevMode:LocalConfigFilePath v projektu tak, aby určil cestu.
CapacityGuid: ID vaší kapacity najdete na portálu Fabric v části Nastavení kapacity portálu pro správu.
ManifestPackageFilePath: Umístění balíčku manifestu. Při sestavování řešení uloží balíček manifestu do souboru src\bin\Debug. Další podrobnosti o balíčku manifestu najdete v dalších krocích.
WorkloadEndpointURL: Adresa URL koncového bodu úlohy
V souboru src/appsettings.json aktualizujte následující pole tak, aby odpovídala vaší konfiguraci:
- PublisherTenantId: ID tenanta vydavatele úloh.
- ClientId: ID klienta (AppID) aplikace Microsoft Entra úlohy.
- ClientSecret: Tajný kód pro aplikaci Microsoft Entra pro úlohu.
- Cílová skupina: Cílová skupina příchozích tokenů Microsoft Entra najdete v registraci vaší aplikace, kterou jste vytvořili v části Vystavit rozhraní API. Označuje se také jako identifikátor URI ID aplikace.
- Zkopírujte workload-dev-mode.json z nástroje src/Config
Nakonfigurujte soubor WorkloadManifest.xml: Nakonfigurujte soubor WorkloadManifest.xml s následujícími podrobnostmi o aplikaci Microsoft Entra:
- APPID
- RESOURCEID
- Identifikátor REDIRECTURI
Vygenerovat balíček manifestu: Vytvořte řešení pro vytvoření souboru balíčku manifestu, který zahrnuje ověřování a zabalení potřebných souborů XML a JSON.
- Aktivace Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe na workloadManifest.xml v packages\manifest\files\ (kód ověřovacího procesu najdete v adresáři \workloadManifestValidator). Pokud se ověření nezdaří, vygeneruje se chybový soubor, který určuje neúspěšné ověření.
- Pokud soubor chyby existuje, sestavení selže s chybou ověření WorkloadManifest. V nástroji VS Studio můžete dvakrát kliknout na chybu a zobrazí se vám soubor s chybou.
- Po úspěšném ověření zabalte soubory WorkloadManifest.xml a FrontendManifest.json do manifestPackage.1.0.0.nupkg. Výsledný balíček najdete v souboru src\bin\Debug.
Zkopírujte soubor ManifestPackage.1.0.0.nupkg do cesty definované v konfiguračním souboru workload-dev-mode.json.
Spusťte DevGateway: Spusťte Microsoft.Fabric.Workload.DevGateway.exe a ověřte se jako správce kapacity.
Spusťte projekt: Nastavte často používaný projekt jako spouštěný projekt v sadě Visual Studio a spusťte ho.
Další kroky
- Podle potřeby aktualizujte konfigurační soubory úloh.
- Sestavte řešení, abyste zajistili správné propojení všech závislostí.
- Spuštěním front-endu a devgateway navazujte komunikaci s back-endem Fabric.
- Vytvořte položky a spusťte úlohy, abyste otestování všech funkcí vaší úlohy.