Condividi tramite

Avvio rapido - Eseguire un esempio di carico di lavoro

  • Articolo

Questa guida introduttiva illustra come creare ed eseguire un carico di lavoro di Microsoft Fabric usando un carico di lavoro di esempio.

Prerequisiti

Prima di iniziare, assicurarsi di aver installato quanto segue:

Guida dettagliata

Abilitare carichi di lavoro personalizzati

Configurare il portale di amministrazione come segue:

  1. Accedere a Fabric con un account amministratore.

  2. Dalle Impostazioni, accedere al portale di amministrazione.

    Screenshot che mostra come accedere al portale di amministrazione di Fabric.

  3. Nella sezione Carichi di lavoro aggiuntivi abilitare l'impostazione Tenant Per amministratori e collaboratori della capacità è possibile aggiungere e rimuovere altri carichi di lavoro . È possibile abilitarla per l'intera organizzazione o per gruppi specifici.

Configurare il progetto di esempio

  1. Clonare il repository: Clonare il repository disponibile qui: Directory del progetto di esempio

  2. Installare le dipendenze: spostarsi alla directory Frontend nel repository clonato ed eseguire il comando seguente:

    npm install

  3. Avviare il server locale: avviare un server Node.js locale usando webpack eseguendo:

    npm start

    Il server viene in genere eseguito sulla porta 60006. Verificare che il server sia operativo accedendo a 127.0.0.1:60006/manifests e verificando il file di configurazione env.dev nella cartella front-end.

  4. Abilitare la modalità sviluppatore front-end: nelle impostazioni del tenant del portale di amministrazione, nella sezione Carichi di lavoro aggiuntivi e attivare l'impostazione Capacity admins can develop additional workloads (Amministratori capacità). Questa impostazione consente le connessioni al server locale e viene mantenuta tra le sessioni del browser.

Eseguire un carico di lavoro di esempio

Quando il server locale è in esecuzione e la modalità sviluppatore è abilitata, il nuovo carico di lavoro di esempio viene visualizzato nel menu.

  1. Accedere al carico di lavoro di esempio: per avviare l'esperienza Crea, spostarsi alla home page del carico di lavoro di esempio.

Preparare l'ambiente di sviluppo

  1. Aprire la soluzione: aprire la soluzione in Visual Studio 2022 per garantire la compatibilità con net7.

  2. Registrazione dell'app: seguire la guida all'autenticazione per configurare l'autenticazione di Microsoft Entra ID per le interazioni sicure all'interno dell'architettura.

  3. Aggiornare l'URL di base di OneLake DFS: modificare il file EnvironmentConstants.cs nella cartella src/Constants/ in modo che corrisponda all'ambiente in uso.

  4. Configurare le impostazioni del carico di lavoro: aggiornare src/Config/workload-dev-mode.json e src/appsettings.json con i dettagli di configurazione specifici:

    • Copiare workload-dev-mode.json da src/Config in C:\ e aggiornare i campi seguenti in modo che corrispondano alla configurazione:

    Nota

    È possibile copiarlo in qualsiasi altro percorso e configurare l'argomento della riga di comando "-DevMode:LocalConfigFilePath" nel progetto per specificare il percorso.

    • WorkspaceGuid: ID dell'area di lavoro. Trovarlo nell'URL del browser quando si seleziona un'area di lavoro in Fabric, ad esempio https://app.fabric.microsoft.com/groups/{WorkspaceID}/.

    • ManifestPackageFilePath: percorso del pacchetto manifesto. Quando si compila la soluzione, il pacchetto manifesto viene salvato all'interno di src\bin\Debug. Altri dettagli sul pacchetto manifesto sono disponibili nei passaggi successivi.

    • WorkloadEndpointURL: URL dell'endpoint del carico di lavoro.

    • Nel file src/appsettings.json, aggiornare i campi seguenti in modo che corrispondano alla configurazione:

      • PublisherTenantId: ID del tenant del server di pubblicazione del carico di lavoro.
      • ClientId: ID client (AppID) dell'applicazione Microsoft Entra del carico di lavoro.
      • ClientSecret: il segreto usato per l'app Microsoft Entra del carico di lavoro.
      • Destinatari: il gruppo di destinatari per i token Microsoft Entra in ingresso è disponibile nella registrazione dell'app creata nella sezione "Esporre un'API". Questa operazione è nota anche come URI ID applicazione.

  5. Configurare il file WorkloadManifest.xml: configurare il file WorkloadManifest.xml con i dettagli dell'applicazione Microsoft Entra seguenti:

    • AppID
    • ResourceID
    • RedirectURI

  6. Genera pacchetto manifesto: compilare la soluzione per creare il file del pacchetto manifesto, che include la convalida e la compressione dei file XML e JSON necessari.

    • Attivare Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe workloadManifest.xml in Packages\manifest\files\ (è possibile trovare il codice del processo di convalida nella directory \workloadManifestValidator). Se la convalida non riesce, viene generato un file di errore che specifica la convalida non riuscita.
    • Se il file di errore esiste, la build non riesce con "Errore di convalida WorkloadManifest". È possibile fare doppio clic sull'errore in VS Studio per visualizzare il file di errore.
    • Dopo la convalida, comprimere i file WorkloadManifest.xml e FrontendManifest.json in ManifestPackage.1.0.0.nupkg. Il pacchetto risultante è disponibile in src\bin\Debug.

    Copiare il file ManifestPackage.1.0.0.nupkg nel percorso definito nel file di configurazione workload-dev-mode.json.

  7. Eseguire DevGateway: eseguire "Microsoft.Fabric.Workload.DevGateway.exe" e accedere con un utente con privilegi di amministratore dell'area di lavoro per l'area di lavoro specificata nel WorkspaceGuid campo di workload-dev-mode.json.

  8. Avviare il progetto: impostare il progetto "Boilerplate" come progetto di avvio in Visual Studio ed eseguirlo.

Passaggi aggiuntivi

  • Aggiornare i file di configurazione del carico di lavoro in base alle esigenze.
  • Compilare la soluzione per assicurarsi che tutte le dipendenze siano collegate correttamente.
  • Eseguire il front-end e devgateway per stabilire la comunicazione con il back-end di Fabric.
  • Creare elementi ed eseguire processi per testare le funzionalità complete del carico di lavoro.

Contenuto correlato