Γρήγορη εκκίνηση: Εκτέλεση δείγματος φόρτου εργασίας
Αυτός ο οδηγός γρήγορης εκκίνησης σάς δείχνει πώς μπορείτε να δημιουργήσετε και να εκτελέσετε έναν φόρτο εργασίας Microsoft Fabric χρησιμοποιώντας ένα δείγμα φόρτου εργασίας.
Προαπαιτούμενα στοιχεία
Προτού ξεκινήσετε, βεβαιωθείτε ότι έχετε εγκαταστήσει τα ακόλουθα στο σύστημά σας:
- Πρόσβαση σε έναν μισθωτή Fabric με ενεργοποιημένη τη δυνατότητα φόρτου εργασίας και τη λειτουργία προγραμματιστή. Ανατρέξτε στο θέμα Παρουσίαση φόρτων εργασίας για περισσότερες πληροφορίες.
- Node.js.
- npm.
- .NET 6.0 Χρόνος εκτέλεσης.
- ASP.NET βασικού χρόνου εκτέλεσης 6.0.
- Visual Studio 2022.
- Φόρτος εργασίας Fabric DevGateway
Οδηγός βήματος
Ενεργοποίηση προσαρμοσμένων φόρτων εργασίας
Ρυθμίστε τις παραμέτρους της πύλης διαχείρισης ως εξής:
Συνδεθείτε στο Fabric με έναν λογαριασμό διαχειριστή.
Από την περιοχή Ρυθμίσεις, μεταβείτε στην πύλη διαχείρισης.
Στην ενότητα Πρόσθετοι φόρτοι εργασίας, ενεργοποιήστε τη ρύθμιση μισθωτή Διαχειριστές εκχωρημένων πόρων και συμβάλλοντες στην προσθήκη και κατάργηση επιπλέον φόρτων εργασίας. Μπορείτε να την ενεργοποιήσετε για ολόκληρο τον οργανισμό ή συγκεκριμένες ομάδες.
Ρύθμιση του δείγματος έργου
Κλωνοποιήστε το αποθετήριο: Κλωνοποιήστε το αποθετήριο δεδομένων εδώ: Δείγμα καταλόγου έργου
Εγκατάσταση εξαρτήσεων: Μεταβείτε στον
Frontend
κατάλογο στο κλωνοποιημένο αποθετήριο δεδομένων και εκτελέστε την ακόλουθη εντολή:npm install
Εκκίνηση του τοπικού διακομιστή: Εκκινήστε έναν τοπικό διακομιστή Node.js χρησιμοποιώντας την
webpack
εκτέλεση:npm start
Ο διακομιστής συνήθως εκτελείται στη θύρα
60006
. Επιβεβαιώστε ότι ο διακομιστής λειτουργεί, μεταβαίνοντας και ελέγχοντας127.0.0.1:60006/manifests
το αρχείο ρύθμισης παραμέτρων .env.dev στον φάκελο προσκηνίων.Ενεργοποίηση λειτουργίας προγραμματιστή προσκηνίου: Στις ρυθμίσεις μισθωτή στην πύλη διαχείρισης, στην ενότητα Πρόσθετοι φόρτοι εργασίας και ενεργοποιήστε τους διαχειριστές εκχωρημένων πόρων μπορείτε να αναπτύξετε πρόσθετους φόρτους εργασίας. Ρύθμιση μισθωτή. Αυτή η ρύθμιση επιτρέπει τις συνδέσεις στον τοπικό διακομιστή σας και διατηρείται σε περιόδους λειτουργίας προγράμματος περιήγησης.
Εκτέλεση δείγματος φόρτου εργασίας
Όταν ο τοπικός διακομιστής εκτελεστεί και ενεργοποιηθεί η λειτουργία προγραμματιστή, το νέο δείγμα φόρτου εργασίας εμφανίζεται στο μενού.
- Πρόσβαση στο δείγμα φόρτου εργασίας: Για να ξεκινήσετε την εμπειρία Δημιουργία, μεταβείτε στην αρχική σελίδα δείγματος φόρτου εργασίας.
Προετοιμασία του περιβάλλοντος ανάπτυξης
Ανοίξτε τη λύση: Ανοίξτε τη λύση στο Visual Studio 2022 για να εξασφαλίσετε τη συμβατότητα με το net7.
Καταχώρηση εφαρμογής: Ακολουθήστε τον οδηγό ελέγχου ταυτότητας για να ρυθμίσετε τον έλεγχο ταυτότητας αναγνωριστικού Microsoft Entra για ασφαλείς αλληλεπιδράσεις εντός της αρχιτεκτονικής.
Ενημέρωση διεύθυνσης URL βάσης OneLake DFS: Τροποποιήστε το
EnvironmentConstants.cs
αρχείο στονsrc/Constants/
φάκελο ώστε να ταιριάζει με το περιβάλλον σας.Ρύθμιση παραμέτρων φόρτου εργασίας: Ενημέρωση
src/Config/workload-dev-mode.json
καιsrc/appsettings.json
με συγκεκριμένες λεπτομέρειες ρύθμισης παραμέτρων:- Αντιγράψτε workload-dev-mode.json από το src/Config και
C:\
ενημερώστε τα παρακάτω πεδία ώστε να συμφωνούν με τις ρυθμίσεις παραμέτρων σας:
Σημείωμα
Μπορείτε να το αντιγράψετε σε οποιαδήποτε άλλη διαδρομή και να ρυθμίσετε το όρισμα γραμμής εντολών "-DevMode:LocalConfigFilePath" στο έργο σας για να καθορίσετε τη διαδρομή.
WorkspaceGuid: Το αναγνωριστικό του χώρου εργασίας σας. Βρείτε το στη διεύθυνση URL του προγράμματος περιήγησης όταν επιλέγετε έναν χώρο εργασίας στο Fabric, για παράδειγμα,
https://app.fabric.microsoft.com/groups/{WorkspaceID}/
.ManifestPackageFilePath: Η θέση του πακέτου διακήρυξης. Όταν δημιουργείτε τη λύση, αποθηκεύει το πακέτο διακήρυξης στο src\bin\Debug. Μπορείτε να βρείτε περισσότερες λεπτομέρειες σχετικά με το πακέτο διακήρυξης στα επόμενα βήματα.
Φόρτος εργασίαςEndpointURL: Διεύθυνση URL τελικού σημείου φόρτου εργασίας.
Στο αρχείο src/appsettings.json, ενημερώστε τα παρακάτω πεδία ώστε να συμφωνούν με τις ρυθμίσεις παραμέτρων σας:
- PublisherTenantId: Το αναγνωριστικό του μισθωτή εκδότη φόρτου εργασίας.
- ClientId: Αναγνωριστικό προγράμματος-πελάτη (AppID) της εφαρμογής Microsoft Entra του φόρτου εργασίας.
- ClientSecret: Ο μυστικός κωδικός για την εφαρμογή Microsoft Entra φόρτου εργασίας.
- Κοινό: Το κοινό για τα εισερχόμενα διακριτικά Microsoft Entra βρίσκεται στην καταχώρηση της εφαρμογής σας που δημιουργήσατε στην ενότητα "Έκθεση API". Αυτό αναφέρεται επίσης ως το Αναγνωριστικό εφαρμογής URI.
- Αντιγράψτε workload-dev-mode.json από το src/Config και
Ρύθμιση παραμέτρων του αρχείου WorkloadManifest.xml: Ρυθμίστε τις παραμέτρους του αρχείου WorkloadManifest.xml με τις παρακάτω λεπτομέρειες εφαρμογής Microsoft Entra:
- Αναγνωριστικό εφαρμογής
- ResourceID
- RedirectURI
Δημιουργία πακέτου διακήρυξης: Δημιουργήστε τη λύση για να δημιουργήσετε το αρχείο πακέτου διακήρυξης, το οποίο περιλαμβάνει επικύρωση και συσκευασία των απαραίτητων αρχείων XML και JSON.
- Ενεργοποίηση Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe στον workloadManifest.xml στον κατάλογο Packages\manifest\files\ (μπορείτε να βρείτε τον κώδικα της διαδικασίας επικύρωσης στον κατάλογο \workloadManifestValidator). Εάν αποτύχει η επικύρωση, δημιουργείται ένα αρχείο σφάλματος που καθορίζει την αποτυχημένη επικύρωση.
- Εάν το αρχείο σφάλματος υπάρχει, η δόμηση αποτυγχάνει με "Σφάλμα επικύρωσης workloadManifest". Μπορείτε να κάνετε διπλό κλικ στο σφάλμα στο VS Studio και θα εμφανιστεί το αρχείο σφάλματος.
- Μετά την επιτυχή επικύρωση, συσκευάστε τα αρχεία WorkloadManifest.xml και FrontendManifest.json στο ManifestPackage.1.0.0.nupkg. Το πακέτο που προκύπτει μπορεί να βρεθεί στο src\bin\Debug.
Αντιγράψτε το αρχείο ManifestPackage.1.0.0.nupkg στη διαδρομή που ορίζεται στο αρχείο ρύθμισης παραμέτρων workload-dev-mode.json.
Εκτελέστε το DevGateway: Εκτελέστε "Microsoft.Fabric.Workload.DevGateway.exe" και εισέλθετε με έναν χρήστη που διαθέτει δικαιώματα διαχειριστή χώρου εργασίας για τον χώρο εργασίας που καθορίζεται στο
WorkspaceGuid
πεδίο της workload-dev-mode.json.Ξεκινήστε το Έργο: Ορίστε το έργο "Boilerplate" ως το έργο εκκίνησης στο Visual Studio και εκτελέστε το.
Πρόσθετα βήματα
- Ενημερώστε τα αρχεία ρύθμισης παραμέτρων φόρτου εργασίας, ανάλογα με τις ανάγκες.
- Δημιουργήστε τη λύση για να εξασφαλίσετε ότι όλες οι εξαρτήσεις συνδέονται σωστά.
- Εκτελέστε το frontend και devgateway για να δημιουργήσετε επικοινωνία με το παρασκήνιο Fabric.
- Δημιουργήστε στοιχεία και εκτελέστε εργασίες για να ελέγξετε τις πλήρεις δυνατότητες του φόρτου εργασίας σας.