Partager via

Démarrage rapide : exécuter un exemple de charge de travail (préversion)

  • Article

Ce guide de démarrage rapide vous montre comment créer et exécuter une charge de travail Microsoft Fabric à l'aide d'un exemple de charge de travail.

Prérequis

Avant de commencer, assurez-vous que les éléments suivants sont installés sur votre système :

Guide pas à pas

Activer les charges de travail personnalisées

Configurez le portail d’administration comme suit :

  1. Connectez-vous à Fabric avec un compte Administration.

  2. Depuis Paramètres, allez au portail d’administration.

    Capture d’écran montrant comment accéder au portail d’administration de Fabric.

  3. Dans la section Charges de travail supplémentaires (préversion), activez le paramètre de locataire Les administrateurs de capacité et les contributeurs peuvent ajouter et supprimer des charges de travail supplémentaires. Vous pouvez l'activer pour l'ensemble de l'organisation ou pour des groupes spécifiques.

Configurer l’exemple de projet

  1. Clonez le référentiel : clonez le référentiel trouvé ici : Exemple de répertoire de projet

  2. Installer les dépendances : accédez au répertoire Frontend dans le référentiel cloné et exécutez la commande suivante :

    npm install

  3. Démarrez le serveur local : lancez un serveur Node.js local à l’aide de webpack en exécutant :

    npm start

    Le serveur s’exécute généralement sur le port 60006. Vérifiez que le serveur est opérationnel en accédant à 127.0.0.1:60006/manifests et en vérifiant le fichier de configuration .env.dev dans le dossier front-end.

  4. Activer le mode développeur front-end : dans les paramètres du locataire dans le portail d’administration, sous la section Charges de travail supplémentaires (préversion) et activer les administrateurs de capacité peuvent développer des charges de travail supplémentaires. Ce paramètre permet de connecter votre serveur local et de conserver les sessions de navigateur.

Exécuter un exemple de charge de travail

Une fois que le serveur local est en cours d’exécution et que le mode développeur est activé, la nouvelle charge de travail exemple s’affiche dans le menu.

  1. Accédez à l'exemple de charge de travail : pour démarrer l'expérience Créer, accédez à la page d'accueil de l'échantillon de charge de travail.

Préparer l’environnement de développement

  1. Clonez le modèle : Clonez le projet modèle que vous trouverez ici : Répertoire du projet exemple

  2. Ouvrez la solution : ouvrez la solution dans Visual Studio 2022 pour garantir la compatibilité avec net7.

  3. Inscription d’application : suivez le guide d'authentification pour configurer l'authentification Microsoft Entry ID afin de sécuriser les interactions au sein de l'architecture.

  4. Mettre à jour l’URL de base One Lake DFS : modifiez le fichier EnvironmentConstants.cs dans le dossier src/Constants/ pour qu’il corresponde à votre environnement.

  5. Configurer le Paramètres de charge de travail : mettre à jour src/Config/workload-dev-mode.json et src/appsettings.json avec vos détails de configuration spécifiques :

    • Copiez workload-dev-mode.json de src/Config vers C:\ et mettez à jour les champs suivants pour qu'ils correspondent à votre configuration :

    Remarque

    Vous pouvez la copier vers n’importe quel autre chemin d’accès et configurer l’argument de ligne de commande « -DevMode :LocalConfigFilePath » dans votre projet pour spécifier le chemin d'accès.

    • CapacityGuid : votre ID de capacité peut être trouvé dans le portail Fabric sous les Paramètres de capacité du portail d'administration.

    • ManifestPackageFilePath : l’emplacement du package de manifeste. Lorsque vous générez la solution, elle enregistre le package de manifeste dans src\bin\Debug. Vous trouverez plus d’informations sur le package de manifeste dans les étapes ultérieures.

    • WorkloadEndpointURL : URL du point de terminaison de la charge de travail.

    • Dans le fichier src/appsettings.json, mettez à jour les champs suivants pour qu’ils correspondent à votre configuration :

      • PublisherTenantId : ID du client de l’éditeur de la charge de travail.
      • ClientId : ID client (AppID) de l’application Microsoft Entra de la charge de travail.
      • ClientSecret : secret de l’application Microsoft Entra de la charge de travail.
      • Audience : l’audience des jetons Microsoft Entra entrants se trouve dans l’inscription de votre application que vous avez créée sous la section « Exposer une API ». Il s’agit également de l’URI d’ID d’application.

  6. Configurez le fichier WorkloadManifest.xml : configurez le fichier WorkloadManifest.xml avec les détails de l’application Microsoft Entra suivants :

    • AppID
    • ResourceID
    • RedirectURI

  7. Générer le package de manifeste : générez la solution pour créer le fichier de package de manifeste, ce qui inclut la validation et l’empaquetage des fichiers XML et JSON nécessaires.

    • Déclenchez Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe sur workloadManifest.xml dans Packages\Manifest\files\ (vous pouvez trouver le code du processus de validation dans le répertoire \WorkloadManifestValidator). En cas d’échec de la validation, un fichier d’erreur est généré en spécifiant la validation ayant échoué.
    • Si le fichier d’erreur existe, la version échoue avec « Erreur de validation WorkloadManifest ». Vous pouvez double-cliquer sur l’erreur dans VS Studio et le fichier d’erreur s’affiche.
    • Une fois la validation réussie, empaquetez les fichiers WorkloadManifest.xml et FrontendManifest.json dans ManifestPackage.1.0.0.nupkg. Le package obtenu se trouve dans src\bin\Debug.

    Copiez le fichier ManifestPackage.1.0.0.nupkg dans le chemin défini dans le fichier de configuration workload-dev-mode.json.

  8. Exécutez DevGateway : exécutez « Microsoft.Fabric.Workload.DevGateway.exe » et authentifiez-vous en tant qu’administrateur de capacité.

  9. Démarrez le projet : définissez le projet « texte réutilisable » comme projet de démarrage dans Visual Studio et exécutez-le.

Étapes supplémentaires

  • Mettez à jour les fichiers de configuration de la charge de travail en fonction des besoins.
  • Générez la solution pour vous assurer que toutes les dépendances sont correctement liées.
  • Exécutez le front-end et devgateway pour établir la communication avec le back-end Fabric.
  • Créez des éléments et exécutez des travaux pour tester les fonctionnalités complètes de votre charge de travail.

Contenu connexe