Einrichten Ihrer Umgebung (Vorschau)

Dieser Artikel richtet sich an Entwickler, die eine Workload mit dem Microsoft Fabric Workload Development Kit erstellen möchten. Der Artikel führt Sie durch den Prozess der Einrichtung Ihrer Entwicklungsumgebung, damit Sie mit der Erstellung Ihrer Workload beginnen können.

Voraussetzungen

Vor Beginn der Workloadentwicklung sind die folgenden Schritte erforderlich.

Git

Ein verteiltes Versionskontrollsystem, das wir zum Verwalten und Nachverfolgen von Änderungen an unserem Projekt einsetzen.

npm (Node-Paket-Manager)

Standardpaketmanager für Node.js zum Verwalten und Freigeben der in Ihrem Projekt verwendeten Pakete.

Node.js

Eine plattformübergreifende Open-Source-JavaScript-Laufzeitumgebung, die JavaScript-Code außerhalb eines Webbrowsers ausführt. Sie wird von uns zum Ausführen unseres serverseitigen JavaScript-Codes eingesetzt.

Webpack

Ein statischer Modul-Bundler für moderne JavaScript-Anwendungen. Es ist hilfreich, JavaScript-Dateien zur Verwendung in einem Browser zu bündeln.

Webpack CLI

Die Befehlszeilenschnittstelle für Webpack. Sie ermöglicht uns die Verwendung von Webpack über die Befehlszeile.

DevGateway

Nur im lokalen Modus ist erforderlich, damit das Workload-Back-End, das lokal gehostet ist, mit dem Mandanten kommunizieren kann. Die Workload wird auf dem Computer des Entwicklers ausgeführt. Workload-API-Aufrufe von Fabric an die Workload werden über Azure Relay geleitet, wobei der Workload-Anteil des Azure Relay-Kanals vom Befehlszeilen-Hilfsprogramm DevGateway verwaltet wird. API-Aufrufe über Workload-Kontrolle werden direkt von der Workload an Fabric getätigt und erfordern keinen Azure Relay-Kanal. Das DevGateway-Dienstprogramm verwaltet auch die Registrierung der lokalen (Entwicklungs-)Instanz der Workload bei Fabric innerhalb eines bestimmten Kapazitätskontexts, damit die Workload in allen Arbeitsbereichen zugänglich ist, die dieser Kapazität zugewiesen sind.

Hinweis

Durch das Beenden des DevGateway-Dienstprogramms wird die Workloadinstanz-Registrierung automatisch entfernt.

Erstellen der Umgebung

Führen Sie die folgenden Schritte aus, um Ihre Umgebung zu erstellen.

Workload-Umgebungsauthentifizierung

Für das Einrichten des Workloadzugriffs auf den Fabric-Mandanten ist die Konfiguration der Microsoft Entra-ID für Ihre Workload-Anwendung erforderlich. Microsoft Entra-ID ist erforderlich, um den sicheren Zugriff und den Betrieb der Datenebenen-API Ihrer Anwendung sicherzustellen.

Die wichtigsten Schritte dabei sind:

1. Hinzufügen von Bereichen für die Datenebenen-API: Diese Bereiche stellen Gruppen von Vorgängen dar, die von der Datenebenen-API verfügbar gemacht werden. Im Back-End-Beispiel werden vier Beispielbereiche bereitgestellt, einschließlich Lese- und Schreibvorgängen für Workloadelemente und Lakehouse-Dateien.

2. Vorautorisierung der Fabric-Client-Anwendung: Die Fabric-Client-Anwendung muss für die von Ihnen definierten Bereiche vorautorisiert werden. Dadurch wird sichergestellt, dass sie die erforderlichen Vorgänge für Ihre Workloadelemente und Lakehouse-Dateien ausführen kann.

3. Generieren eines geheimen Schlüssels für Ihre Anwendung: Dieser geheime Schlüssel wird verwendet, um Ihre Anwendung zu schützen und wird beim Konfigurieren des Back-End-Beispiels verwendet.

4. Hinzufügen eines optionalen Anspruchs "idtyp": Dieser Anspruch wird dem Zugriffstoken hinzugefügt und wird zu Identitätszwecken verwendet.

Diese Schritte sind beim Einrichten der Workload erforderlich. Eine ausführliche Anleitung zum Ausführen dieser Schritte finden Sie unter Authentifizierungseinrichtung.

Web-App (nur Cloudmodus)

Für die Workloadbereitstellung im Cloudmodus (in Verbindung mit dem lokalen Computermodus) muss eine Web-App-Domäne für das Front-End (FE) und das Back-End (BE) eingerichtet werden. Dabei muss es sich um Unterdomänen der Ressourcen-ID mit maximal einem weiteren Segment handeln. Die Hostdomäne der Antwort-URL sollte mit der FE-Hostdomäne übereinstimmen. Weitere Informationen finden Sie unter Erstellen und Bereitstellen der Back-End-Web-App.

Einrichten eines Fabric-Entwicklungsmandanten

Im Zusammenhang mit der Ausführung des Workload-SDK-Beispiels und der Erstellung einer Workload empfiehlt sich der Einsatz eines dedizierten Entwicklungsmandanten. Diese Methode garantiert eine isolierte Umgebung und minimiert dadurch das Risiko versehentlicher Unterbrechungen oder Änderungen an Produktionssystemen. Darüber hinaus sorgt sie für eine zusätzliche Sicherheitsebene zum Schutz von Produktionsdaten vor potenzieller Gefährdung oder Kompromittierung. Die Einhaltung dieser Empfehlung entspricht den bewährten Methoden der Branche und trägt zu einem robusten, zuverlässigen und sicheren Security Development Lifecycle bei.

Mandanteneinstellung und Entwicklungseinstellungen

1. Für den Beginn der Entwicklung und das Herstellen einer Verbindung mit einer Fabric-Kapazität über Ihren lokalen Computer ist eine Berechtigung als Fabric-Administrator erforderlich. Nur Entwickler mit einer Berechtigung als Kapazitätsadministrator können ihre Workload mit einer Kapazität verbinden und dafür registrieren. Für die Front-End-Entwicklung sind keine Berechtigungen als Kapazitätsadministrator erforderlich.

   Damit ein Benutzer mit der Entwicklung beginnen kann, beziehen Sie ihn in die Mandanteneinstellung Kapazitätsadministratoren können zusätzliche Workloads entwickeln ein.

   

2. Nachdem dem Benutzer im vorherigen Schritt die Berechtigung erteilt wurde, kann jeder Benutzer den Entwicklungsmodus für den Bereich der Entwicklungseinstellungen im Fabric-Entwicklermodus aktivieren.

   

Zugehöriger Inhalt

• Kurzanleitung
• Übersicht über die Authentifizierung