Sdílet prostřednictvím

Rychlý start: Spuštění ukázky úloh (Preview)

  • Článek

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í:

Podrobný průvodce

Povolení vlastních úloh

Portál pro správu nakonfigurujte následujícím způsobem:

  1. Přihlaste se k Prostředkům infrastruktury pomocí účtu správce.

  2. V Nastavení přejděte na portál pro správu.

    Snímek obrazovky znázorňující, jak se dostat na portál pro správu prostředků infrastruktury

  3. 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

  1. Naklonujte úložiště: Naklonujte úložiště, které najdete tady: Ukázkový adresář projektu

  2. 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

  3. 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í, a 127.0.0.1:60006/manifests zkontrolujte konfigurační soubor .env.dev ve front-endové složce.

  4. 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.

  1. 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í

  1. Klonujte často používaný projekt: Naklonujte často používaný projekt zde: Ukázkový adresář projektu

  2. Otevřete řešení: Otevřete řešení v sadě Visual Studio 2022 , abyste zajistili kompatibilitu s net7.

  3. 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.

  4. Aktualizujte základní adresu URL oneLake DFS: Upravte EnvironmentConstants.cs soubor ve složce tak, aby odpovídal vašemu src/Constants/ prostředí.

  5. Konfigurace nastavení úloh: Aktualizujte src/Config/workload-dev-mode.json a src/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.

  6. Nakonfigurujte soubor WorkloadManifest.xml: Nakonfigurujte soubor WorkloadManifest.xml s následujícími podrobnostmi o aplikaci Microsoft Entra:

    • APPID
    • RESOURCEID
    • Identifikátor REDIRECTURI

  7. 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.

  8. Spusťte DevGateway: Spusťte Microsoft.Fabric.Workload.DevGateway.exe a ověřte se jako správce kapacity.

  9. 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.

Související obsah