Configurer votre environnement (préversion)

Cet article vise les développeurs qui cherchent à créer une charge de travail à l’aide du Kit de développement de charge de travail Microsoft Fabric. L’article vous guide tout au long du processus de configuration de votre environnement de développement afin de commencer à créer votre charge de travail.

Prérequis

Les étapes suivantes sont requises avant de commencer le développement d’une charge de travail.

Git

Système de contrôle de version distribué que nous utilisons pour gérer et suivre les modifications apportées à notre projet.

nmp (Gestionnaire de package Node)

Gestionnaire de package par défaut pour Node.js utilisé pour gérer et partager les packages que vous utilisez dans votre projet.

Node.JS

Un environnement d’exécution JavaScript open source, multiplateforme qui exécute du code JavaScript en dehors d’un navigateur web. Nous allons l’utiliser pour exécuter notre code JavaScript côté serveur.

Webpack

Bundler de modules statiques pour les applications JavaScript modernes. Il permet de regrouper des fichiers JavaScript à des fins d’utilisation dans un navigateur.

Webpack CLI

Interface de ligne de commande pour Webpack. Cela nous permet d’utiliser Webpack à partir de la ligne de commande.

DevGateway

En mode local uniquement, il est nécessaire d’autoriser le back-end de charge de travail, qui est hébergé localement, à communiquer avec le locataire. La charge de travail fonctionne sur l’ordinateur du développeur. Les appels d’API de charge de travail de Fabric à la charge de travail sont canalisés via Azure Relay, avec le côté de la charge de travail du canal Azure Relay géré par l’utilitaire de ligne de commande DevGateway. Les appels d’API de contrôle de charge de travail sont effectués directement à partir de la charge de travail vers Fabric, sans nécessiter le canal Azure Relay. L’utilitaire DevGateway gère également l’inscription de l’instance locale (développement) de la charge de travail auprès de Fabric dans un contexte de capacité spécifique, ce qui rend la charge de travail accessible dans tous les espaces de travail affectés à cette capacité.

Remarque

La fin de l’utilitaire DevGateway supprime automatiquement l’inscription de l’instance de charge de travail.

Créer votre environnement

Suivez les étapes ci-dessous pour créer votre environnement.

Authentification de l’environnement de charge de travail

La configuration de l'accès de la charge de travail au locataire Fabric nécessite la configuration de Microsoft Entra ID pour votre application de charge de travail. Microsoft Entra ID est nécessaire pour garantir l’accès sécurisé et le fonctionnement de l’API de plan de données de votre application.

Les étapes clés incluent :

1. Ajout d’étendues pour l’API de plan de données : ces étendues représentent des groupes d’opérations exposées par votre API de plan de données. Quatre exemples d’étendues sont fournis dans l’exemple principal, couvrant les opérations de lecture et d’écriture pour les éléments de charge de travail et les fichiers Lakehouse.

2. Pré-autorisation de l’application cliente Fabric : l’application cliente Fabric doit être pré-autorisée pour les étendues que vous avez définies. Cela garantit qu’il peut effectuer les opérations nécessaires sur vos éléments de charge de travail et les fichiers Lakehouse.

3. Génération d’un secret pour votre application : ce secret est utilisé pour sécuriser votre application et sera utilisé lors de la configuration de l’exemple principal.

4. Ajout d’une revendication facultative « idtyp » : cette revendication est ajoutée au jeton d’accès et est utilisée à des fins d’identité.

Ces étapes sont requises lors de la configuration de la charge de travail, pour obtenir un guide détaillé sur la façon d’effectuer ces étapes, consultez configuration de l’authentification.

Application web (mode cloud uniquement)

Le déploiement de la charge de travail en mode cloud (conjointement au mode ordinateur local) nécessite la configuration du domaine d’application web pour le front-end (FE) et le back-end (BE). Il doit s’agir de sous-domaines de l’ID de ressource avec un maximum d’un segment supplémentaire. Le domaine hôte d’URL de réponse doit être identique au domaine hôte FE. Pour plus d’informations, consultez Création et déploiement de l'application web backend texte réutilisable.

Configuration d’un client de développement Fabric

Dans le contexte de l’exécution de l’exemple du kit de développement logiciel (SDK) de la charge de travail et de la création d’une charge de travail, il est recommandé d’utiliser un client de développement dédié. Cette pratique garantit un environnement isolé, réduisant ainsi le risque de perturbations ou de modifications accidentelles apportées aux systèmes de production. De plus, il offre une couche additionnelle de sécurité, protégeant les données de production contre l’exposition potentielle ou la compromission. L’adhésion à cette recommandation s’aligne sur les meilleures pratiques du secteur d’activité et contribue à un cycle de vie de développement robuste, fiable et sécurisé.

Paramètres de client et paramètres de développement

1. L’autorisation d’administrateur Fabric est nécessaire pour commencer le développement et se connecter à votre ordinateur local à une capacité Fabric. Seuls les développeurs disposant d’une autorisation d’administrateur de capacité peuvent se connecter et inscrire leur charge de travail sur une capacité. Le développement front-end ne nécessite pas d’autorisations d’administrateur de capacité.

   Pour permettre à un utilisateur de commencer le développement, incluez-le dans le paramètre du locataire Les administrateurs de capacité peuvent développer des charges de travail supplémentaires.

   

2. Une fois l’utilisateur autorisé à l’étape précédente, chaque utilisateur peut activer le mode de développement pour la zone des paramètres de développement en mode développeur Fabric.

   

Contenu connexe

• Guide de démarrage rapide
• Vue d’ensemble de l’authentification