Παρουσίαση φόρτων εργασίας (προεπισκόπηση)
Αυτό το κεφάλαιο παρουσιάζει τα βασικά στοιχεία του συστήματός μας και παρέχει μια επισκόπηση της αρχιτεκτονικής. Αυτά τα στοιχεία συνεργάζονται για να δημιουργήσουν μια ισχυρή και ευέλικτη πλατφόρμα για τις ανάγκες ανάπτυξής σας. Ας εμβαθύνουμε σε αυτά τα στοιχεία και τους ρόλους τους μέσα στην αρχιτεκτονική μας.
Αρχιτεκτονική φόρτου εργασίας Fabric
Ορισμένες από τις βασικές πτυχές της αρχιτεκτονικής φόρτου εργασίας Fabric είναι οι εξής:
Χειρίζεται την επεξεργασία, τον χώρο αποθήκευσης και τη διαχείριση δεδομένων. Επικυρώνει τα διακριτικά αναγνωριστικού Microsoft Entra πριν από την επεξεργασία τους και αλληλεπιδρά με εξωτερικές υπηρεσίες Azure, όπως το Lakehouse.
Ο φόρτος εργασίας Frontend (FE) προσφέρει ένα περιβάλλον εργασίας χρήστη για τη δημιουργία, τη σύνταξη, τη διαχείριση και την εκτέλεση εργασιών.
Οι αλληλεπιδράσεις χρήστη μέσω της FE προετοιμάζουν αιτήσεις προς την BE, είτε άμεσα είτε έμμεσα μέσω του παρασκηνίου Fabric (Fabric BE).
Για πιο λεπτομερή διαγράμματα που απεικονίζουν την επικοινωνία και τον έλεγχο ταυτότητας των διαφόρων στοιχείων, ανατρέξτε στο θέμα Επισκόπηση ελέγχου ταυτότητας και εξουσιοδότησης παρασκηνίου και διαγράμματα επισκόπησης ελέγχου ταυτότητας.
Προσκηνίου (FE)
Το προσκήνιο χρησιμεύει ως η βάση της εμπειρίας χρήστη (UX) και της συμπεριφοράς, που λειτουργεί μέσα σε ένα iframe στην πύλη Fabric. Παρέχει στον συνεργάτη Fabric μια συγκεκριμένη εμπειρία περιβάλλοντος εργασίας χρήστη, συμπεριλαμβανομένου ενός προγράμματος επεξεργασίας στοιχείων. Το SDK του προγράμματος-πελάτη επέκτασης εξοπλίζει τις απαραίτητες διασυνδέσεις, API και συναρτήσεις bootstrap για τη μετατροπή μιας κανονικής εφαρμογής Web σε μια εφαρμογή Web Micro Frontend που λειτουργεί απρόσκοπτα εντός της πύλης Fabric.
Παρασκήνιο (BE)
Το παρασκήνιο είναι η δύναμη για την επεξεργασία δεδομένων και την αποθήκευση μετα-δεδομένων. Χρησιμοποιεί λειτουργίες CRUD για τη δημιουργία και διαχείριση στοιχείων φόρτου εργασίας μαζί με μετα-δεδομένα και εκτελεί εργασίες για τη συμπλήρωση δεδομένων στον χώρο αποθήκευσης. Η γέφυρα επικοινωνίας μεταξύ προσκηνίου και παρασκηνίου καθορίζεται μέσω δημόσιων API.
Οι φόρτοι εργασίας μπορούν να εκτελεστούν σε δύο περιβάλλοντα: τοπικό και cloud. Στις τοπικές ρυθμίσεις (devmode), ο φόρτος εργασίας εκτελείται στον υπολογιστή του προγραμματιστή, με τις κλήσεις API διαχειριζόμενες από το βοηθητικό πρόγραμμα DevGateway. Αυτό το βοηθητικό πρόγραμμα χειρίζεται επίσης την καταχώρηση φόρτου εργασίας με το Fabric. Σε λειτουργία cloud, ο φόρτος εργασίας εκτελείται στις υπηρεσίες συνεργατών, με κλήσεις API που γίνονται απευθείας σε ένα τελικό σημείο HTTPS.
Περιβάλλον ανάπτυξης
- Πακέτο φόρτου εργασίας λειτουργίας ανάπτυξης: Κατά τη δημιουργία της λύσης παρασκηνίου στο Visual Studio, χρησιμοποιήστε τη ρύθμιση παραμέτρων δόμησης εντοπισμού σφαλμάτων για να δημιουργήσετε ένα πακέτο BE NuGet, το οποίο μπορεί να φορτωθεί στον μισθωτή Fabric χρησιμοποιώντας την εφαρμογή DevGateway.
- Πακέτο φόρτου εργασίας λειτουργίας cloud: Κατά τη δημιουργία της λύσης BE στο Visual Studio, χρησιμοποιήστε τη ρύθμιση παραμέτρων δόμησης έκδοσης για να δημιουργήσετε ένα μεμονωμένο πακέτο φόρτου εργασίας (BE και FE). Αυτό το πακέτο μπορεί να αποσταλεί απευθείας στον μισθωτή.
- Για περισσότερες λεπτομέρειες σχετικά με τον εντοπισμό σφαλμάτων και την έκδοση ρυθμίσεων παραμέτρων δόμησης, ανατρέξτε στο θέμα Αλλαγή της ρύθμισης παραμέτρων δόμησης
Δομή πακέτου NuGet φόρτου εργασίας
Ο φόρτος εργασίας συνδυάζεται ως πακέτο NuGet, συνδυάζοντας στοιχεία παρασκηνίου και προσκηνίου. Η δομή συμμορφώνεται με συγκεκριμένες συμβάσεις ονοματοθεσίας και επιβάλλεται από το Fabric για συνέπεια σε όλα τα σενάρια αποστολής. Το πακέτο NuGet που έχει σχεδιαστεί για να αντιπροσωπεύει φόρτους εργασίας είναι δομημένο ώστε να περιλαμβάνει στοιχεία παρασκηνίου και προσκηνίου.
Δομή παρασκηνίου
Το τμήμα παρασκηνίου αποτελείται από .xml αρχεία που ορίζουν τον φόρτο εργασίας και τα σχετικά στοιχεία του, τα οποία είναι απαραίτητα για την καταχώρηση με το Fabric.
Βασικά στοιχεία
WorkloadManifest.xml
- Το αρχείο ρύθμισης παραμέτρων φόρτου εργασίας, που απαιτείται για να έχει αυτό ακριβώς το όνομα για την επαλήθευση του Fabric.Item1.xml
, ,Item2.xml
...
- Εκδηλώνει για μεμονωμένα στοιχεία με ευέλικτη ονοματοθεσία, ακολουθώντας τη μορφή XML.
Δομή προσκηνίου
Η ενότητα προσκηνίου περιέχει .json αρχεία που περιγράφουν λεπτομερώς το προϊόν και τα στοιχεία για το προσκήνιο, μαζί με έναν κατάλογο "assets" για εικονίδια.
Βασικά στοιχεία
Product.json
- Η κύρια διακήρυξη για το προσκήνιο του προϊόντος σας, η οποία πρέπει να ονομάζεται ακριβώς για την επαλήθευση του Fabric.Item1.json
, ,Item2.json
...
- Εκδηλώσεις για μεμονωμένα στοιχεία με ευέλικτη ονοματοθεσία, ακολουθώντας τη μορφή JSON. Κάθε json αντιστοιχεί σε μια διακήρυξη παρασκηνίου (π.χ. Item1.json σε Item1.xml).assets
φάκελος - Αποθηκεύει όλα τα εικονίδιαicon1.jpg
,icon2.png
,...
που χρησιμοποιούνται από το προσκήνιο.
Υποχρεωτική συμμόρφωση δομής
Η δομή, συμπεριλαμβανομένων των συγκεκριμένων ονομάτων υποφακέλου ("BE", "FE", "assets"), είναι υποχρεωτική και επιβάλλεται από το Fabric για όλα τα σενάρια αποστολής, συμπεριλαμβανομένων πακέτων δοκιμής και ανάπτυξης. Η δομή καθορίζεται στα .nuspec
αρχεία που βρίσκονται στο αποθετήριο στον Backend/src/Packages/manifest
κατάλογο.
Όρια
Τα ακόλουθα όρια ισχύουν για όλους τους τύπους πακέτων NuGet, τόσο σε λειτουργία ανάπτυξης όσο και σε λειτουργία cloud:
- Επιτρέπονται μόνο
BE
οι υποφάκελοι καιFE
. Οποιοιδήποτε άλλοι υποφάκελοι ή αρχεία που βρίσκονται έξω από αυτούς τους φακέλους έχουν ως αποτέλεσμα ένα σφάλμα αποστολής. - Ο
BE
φάκελος δέχεται μόνο.xml
αρχεία. Οποιοσδήποτε άλλος τύπος αρχείου έχει ως αποτέλεσμα ένα σφάλμα αποστολής. - Επιτρέπονται έως και 10 αρχεία στοιχείων, το οποίο σημαίνει ότι ο
BE
φάκελος μπορεί να περιέχει έναWorkloadManifest.xml
έως και 10Item.xml
αρχεία. Η ύπαρξη περισσότερων από 10 αρχείων στοιχείων στον φάκελο έχει ως αποτέλεσμα ένα σφάλμα αποστολής. - Ο
Assets
υποφάκελος πρέπει να βρίσκεται κάτω από τονFE
φάκελο. Μπορεί να περιέχει έως και 15 αρχεία, με κάθε αρχείο να μην είναι μεγαλύτερο από 1,5 MB. - Μόνο οι ακόλουθοι τύποι αρχείων επιτρέπονται στον
Assets
υποφάκελο:.jpeg
,.jpg
,.png
. - Ο
FE
φάκελος μπορεί να περιέχει έως και 10 αρχεία στοιχείων συν έναproduct.json
αρχείο. - Κάθε στοιχείο μέσα στον
Assets
φάκελο πρέπει να αναφέρεται μέσα στα αρχεία του στοιχείου. Οποιοδήποτε στοιχείο στο οποίο γίνεται αναφορά από ένα αρχείο στοιχείου που λείπει από τονAssets
φάκελο θα έχει ως αποτέλεσμα ένα σφάλμα αποστολής. - Τα ονόματα αρχείων για τα στοιχεία πρέπει να είναι μοναδικά. Τα διπλότυπα ονόματα αρχείων έχουν ως αποτέλεσμα ένα σφάλμα αποστολής.
- Τα ονόματα αρχείων πρέπει να περιέχουν αλφαριθμητικούς (Αγγλικούς) χαρακτήρες ή ενωτικά μόνο και δεν μπορούν να υπερβαίνουν το μήκος των 32 χαρακτήρων. Η χρήση άλλων χαρακτήρων ή η υπέρβαση αυτού του μήκους έχει ως αποτέλεσμα ένα σφάλμα αποστολής.
- Το συνολικό μέγεθος του πακέτου δεν πρέπει να υπερβαίνει τα 20 MB.
- Ανατρέξτε στη διακήρυξη φόρτου εργασίας για συγκεκριμένους περιορισμούς διακήρυξης.
Λειτουργία τοπικής ανάπτυξης (devmode)
Το παρασκήνιο φόρτου εργασίας (BE) λειτουργεί στον υπολογιστή του προγραμματιστή. Οι κλήσεις API φόρτου εργασίας μεταδίδονται μέσω της αναμετάδοσης Azure, με την πλευρά του φόρτου εργασίας του καναλιού αναμετάδοσης Azure διαχειριζόμενη από ένα εξειδικευμένο βοηθητικό πρόγραμμα γραμμής εντολών DevGateway. Οι κλήσεις API ελέγχου φόρτου εργασίας αποστέλλονται απευθείας από τον φόρτο εργασίας στο Fabric, παρακάμπτοντας το κανάλι αναμετάδοσης Azure. Το βοηθητικό πρόγραμμα DevGateway επιβλέπει επίσης την εγγραφή της τοπικής παρουσίας ανάπτυξης του φόρτου εργασίας με το Fabric, στο πλαίσιο ενός συγκεκριμένου συνόλου εκχωρημένων πόρων. Αυτό εξασφαλίζει τη διαθεσιμότητα του φόρτου εργασίας σε όλους τους χώρους εργασίας που έχουν εκχωρηθεί σε αυτό το σύνολο εκχωρημένων πόρων. Μετά τον τερματισμό του βοηθητικού προγράμματος DevGateway, η εγγραφή της παρουσίας φόρτου εργασίας ανακαλείται αυτόματα. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Οδηγός υλοποίησης παρασκηνίου.
Σχήμα DevMode BE
Λειτουργία ανάπτυξης cloud (λειτουργία cloud)
Το παρασκήνιο φόρτου εργασίας (BE) λειτουργεί στις υπηρεσίες του συνεργάτη. Οι κλήσεις API φόρτου εργασίας γίνονται απευθείας στο τελικό σημείο HTTPS, όπως καθορίζεται στη διακήρυξη φόρτου εργασίας. Σε αυτό το σενάριο, το βοηθητικό πρόγραμμα DevGateway δεν απαιτείται. Η καταχώρηση του φόρτου εργασίας με το Fabric επιτυγχάνεται με την αποστολή του πακέτου NuGet φόρτου εργασίας στο Fabric και, στη συνέχεια, την ενεργοποίηση του φόρτου εργασίας για τον μισθωτή. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Διαχείριση φόρτου εργασίας στο Fabric.