Condividi tramite

Avvio rapido - Eseguire un esempio di carico di lavoro (anteprima)

  • 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 (anteprima), abilitare l'impostazione tenant Gli amministratori e i contributori della capacità possono aggiungere e rimuovere carichi di lavoro aggiuntivi. È possibile abilitarla per l'intera organizzazione o per gruppi specifici.

Configurare il progetto di esempio

  1. Clonare il repository: clonare il repository disponibile qui: https://go.microsoft.com/fwlink/?linkid=2272254

  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 nel portale di amministrazione, nella sezione Carichi di lavoro aggiuntivi (anteprima), attivare l'impostazione del tenant Gli amministratori della capacità possono sviluppare carichi di lavoro aggiuntivi. 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. Clonare il boilerplate: clonare il progetto boilerplate disponibile qui: https://go.microsoft.com/fwlink/?linkid=2272254

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

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

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

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

    • CapacityGuid: l'ID capacità è disponibile nel portale Fabric nella sezione Impostazioni capacità del portale di amministrazione.

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

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

    • AppID
    • ResourceID
    • RedirectURI

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

  8. Eseguire DevGateway: eseguire "Microsoft.Fabric.Workload.DevGateway.exe" ed eseguire l'autenticazione come amministratore della capacità.

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