Σημείωση
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να συνδεθείτε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Μάθετε πώς οι διοχετεύσεις ενοποίησης και ανάπτυξης Git λειτουργούν με το API για GraphQL στο Microsoft Fabric. Αυτό το άρθρο σάς βοηθά να κατανοήσετε πώς μπορείτε να ρυθμίσετε μια σύνδεση στο αποθετήριο δεδομένων σας, να διαχειριστείτε το API σας για GraphQL και να την αναπτύξετε σε διαφορετικά περιβάλλοντα.
Σημείωση
Το API για τον έλεγχο προέλευσης και την ανάπτυξη του GraphQL είναι προς το παρόν σε προεπισκόπηση.
Προαπαιτούμενα στοιχεία
- Πρέπει να έχετε ένα API για το GraphQL στο Fabric. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία API για το GraphQL στο Fabric και προσθήκη δεδομένων.
Επισκόπηση
Το Fabric προσφέρει ισχυρά εργαλεία για CI/CD (συνεχή ενοποίηση και συνεχή ανάπτυξη) και διαχείριση του κύκλου ζωής ανάπτυξης μέσω δύο κύριων στοιχείων: ενοποίηση Git (CI) και διοχετεύσεις ανάπτυξης (CD). Οι χώροι εργασίας χρησιμεύουν ως κεντρικά στοιχεία τόσο για τα στάδια συγχρονισμού Git όσο και για τα στάδια ανάπτυξης.
Ενοποίηση Git (CI): Συγχρονίζει στοιχεία χώρου εργασίας (π.χ. κώδικας, ρυθμίσεις παραμέτρων, API) με αποθετήρια ελέγχου εκδόσεων, ενεργοποιώντας τον έλεγχο εκδόσεων και την παρακολούθηση αλλαγών μέσω Git.
Διοχετεύσεις ανάπτυξης (CD): Επιτρέπει τη δημιουργία σταδίων (π.χ. Ανάπτυξη, Δοκιμή, Παραγωγή) με συνδεδεμένους χώρους εργασίας. Τα στοιχεία που υποστηρίζονται σε κάθε στάδιο αναπαράγονται αυτόματα στα επόμενα στάδια και οι αλλαγές σε μια ανάπτυξη εναύσματος χώρου εργασίας σε μια διοχέτευση έκδοσης. Μπορείτε να ρυθμίσετε τις παραμέτρους της διοχέτευσης για να διασφαλίσετε ότι οι αλλαγές ελέγχονται και αναπτύσσονται αποτελεσματικά σε όλα τα περιβάλλοντα.
Το Fabric υποστηρίζει διάφορες ροές εργασιών CI/CD προσαρμοσμένες σε συνήθη σενάρια. Για περισσότερες λεπτομέρειες, ανατρέξτε στο θέμα Επιλογές ροής εργασιών CI/CD στο Fabric.
Σημείωση
Μόνο τα μετα-δεδομένα αντιγράφονται κατά τη διάρκεια της ανάπτυξης. και τα δεδομένα δεν αντιγράφονται.
Τα στοιχεία από τον χώρο εργασίας αποθηκεύονται στο σχετικό αποθετήριο δεδομένων Git ως Infrastructure as Code (IaC). Οι αλλαγές κώδικα στο αποθετήριο μπορούν να ενεργοποιήσουν την ανάπτυξη σε διοχετεύσεις. Αυτή η μέθοδος σάς επιτρέπει να κάνετε αυτόματη αναπαραγωγή των αλλαγών κώδικα σε όλα τα στάδια για σκοπούς δοκιμής και έκδοσης παραγωγής.
Μέθοδοι ελέγχου ταυτότητας προέλευσης δεδομένων
Σε αυτή την ενότητα, θα μάθετε σχετικά με τις μεθόδους ελέγχου ταυτότητας για να συνδέσετε προελεύσεις δεδομένων στο API σας για GraphQL και να κατανοήσετε τις επιπτώσεις τους στην αυτόματη σύνδεση μεταξύ του API για GraphQL και των συνδεδεμένων προελεύσεων δεδομένων του σε διοχετεύσεις ανάπτυξης. Μπορείτε να μάθετε περισσότερα σχετικά με την αυτόματη σύνδεση στη διαδικασία διοχέτευσης ανάπτυξης.
Υπάρχουν δύο διαθέσιμες επιλογές για τη σύνδεση προελεύσεων δεδομένων στο API για GraphQL:
Σύνδεση σε προελεύσεις δεδομένων Fabric με έλεγχο ταυτότητας καθολικής σύνδεσης (SSO)
Σύνδεση σε προελεύσεις δεδομένων Fabric Ή εξωτερικές προελεύσεις δεδομένων με χρήση αποθηκευμένων διαπιστευτηρίων
Η πρώτη επιλογή, Single Sign-On (SSO), επιτρέπει τις συνδέσεις σε προελεύσεις δεδομένων εντός του Fabric. Σε αυτή την περίπτωση, όταν συνδέετε μια προέλευση δεδομένων στο GraphQL χρησιμοποιώντας τη μέθοδο καθολικής σύνδεσης στον αρχικό χώρο εργασίας (για παράδειγμα, στάδιο ανάπτυξης), η προέλευση δεδομένων και το στοιχείο GraphQL θα αναπτυχθούν στον χώρο εργασίας προορισμού (για παράδειγμα, Στάδιο δοκιμής) στη διοχέτευση και το GraphQL στον χώρο εργασίας προορισμού θα συνδεθεί αυτόματα με την αναπτυγμένη τοπική προέλευση δεδομένων στον χώρο εργασίας προορισμού (δείτε το παρακάτω διάγραμμα). Υπάρχουν συγκεκριμένοι περιορισμοί κατά τη χρήση SSO και τη σύνδεση σε μια προέλευση δεδομένων μέσω τελικού σημείου SQL Analytics, για περισσότερες λεπτομέρειες ανατρέξτε στην ενότητα **Τρέχοντες περιορισμοί.
Η δεύτερη επιλογή, Αποθηκευμένα διαπιστευτήρια, επιτρέπει τις συνδέσεις σε εξωτερικές προελεύσεις δεδομένων εκτός του Fabric και προελεύσεις δεδομένων εντός του Fabric. Ωστόσο, η αυτόματη σύνδεση δεν υποστηρίζεται για την προσέγγιση Αποθηκευμένα διαπιστευτήρια. Αυτό σημαίνει ότι εάν συνδέσετε μια προέλευση δεδομένων στο GraphQL χρησιμοποιώντας αποθηκευμένα διαπιστευτήρια στον αρχικό χώρο εργασίας (στάδιο ανάπτυξης), η προέλευση δεδομένων θα αναπτυχθεί στον χώρο εργασίας προορισμού (στάδιο δοκιμής) στη διοχέτευση. Ωστόσο, το στοιχείο GraphQL στον χώρο εργασίας προορισμού θα παραμείνει συνδεδεμένο με την προέλευση δεδομένων στον αρχικό χώρο εργασίας (στάδιο ανάπτυξης) μέσω των Αποθηκευμένων διαπιστευτηρίων, αντί να συνδέεται αυτόματα με μια τοπική προέλευση δεδομένων στον χώρο εργασίας προορισμού. (δείτε το παρακάτω διάγραμμα)
Επιπλέον, εάν χρησιμοποιείται η μέθοδος Αποθηκευμένα διαπιστευτήρια για τη σύνδεση σε προελεύσεις δεδομένων, οι προγραμματιστές πρέπει να έχουν πρόσβαση στις πληροφορίες αποθηκευμένων διαπιστευτηρίων, προκειμένου να αναπτύξουν με επιτυχία το στοιχείο GraphQL.
Σημείωση
Εάν ένα API για GraphQL στον αρχικό χώρο εργασίας (στάδιο ανάπτυξης) συνδέεται σε μια προέλευση δεδομένων που βρίσκεται σε διαφορετικό χώρο εργασίας, το ανεπτυγμένο API για GraphQL στον χώρο εργασίας προορισμού (στάδιο δοκιμής) θα παραμείνει συνδεδεμένο στην προέλευση δεδομένων που βρίσκεται σε διαφορετικό χώρο εργασίας, ανεξάρτητα από τη μέθοδο ελέγχου ταυτότητας που χρησιμοποιείται για τη σύνδεση των προελεύσεων δεδομένων με το API για GraphQL. (δείτε το παρακάτω διάγραμμα)
API για ενοποίηση GraphQL Git
Το API Fabric για GraphQL προσφέρει ενοποίηση Git για τον έλεγχο προέλευσης. Με την ενοποίηση Git, μπορείτε να δημιουργήσετε ένα αντίγραφό ασφαλείας και να δημιουργήσετε μια έκδοση του API σας για το GraphQL, να επιστρέψετε στα προηγούμενα στάδια ανάλογα με τις ανάγκες, να συνεργαστείτε ή να εργαστείτε μόνοι σας χρησιμοποιώντας κλάδους Git και να διαχειριστείτε τον κύκλο ζωής του GraphQL για τον κύκλο ζωής GraphQL εξ ολοκλήρου εντός του Fabric.
Ρύθμιση σύνδεσης:
Από τις ρυθμίσεις χώρου εργασίας σας, μπορείτε εύκολα να ρυθμίσετε μια σύνδεση στο αποθετήριο δεδομένων σας για τη δέσμευση και τον συγχρονισμό αλλαγών. Για να ρυθμίσετε τη σύνδεση, ανατρέξτε στο θέμα Γρήγορα αποτελέσματα με την ενοποίηση του Git. Αφού συνδεθείτε, τα στοιχεία σας, συμπεριλαμβανομένου του API για GraphQL, εμφανίζονται στον πίνακα ελέγχου Προέλευση .
Μετά την επιτυχή δέσμευση του API για παρουσίες GraphQL στο αποθετήριο δεδομένων Git, θα δείτε τη δομή φακέλου GraphQL στο αποθετήριο δεδομένων. Τώρα, μπορείτε να εκτελέσετε μελλοντικές λειτουργίες, όπως Δημιουργία αιτήματος έλξης.
Αναπαράσταση GraphQL στο Git:
Η παρακάτω εικόνα είναι ένα παράδειγμα της δομής αρχείων κάθε API για το στοιχείο GraphQL στο αποθετήριο Git:
Όταν τοποθετείτε το API για το στοιχείο GraphQL στο αποθετήριο Git, αποθηκεύεται το API για τον ορισμό GraphQL. Αυτή η προσέγγιση υποστηρίζει ακριβή ανάκτηση όταν συγχρονίζετε ξανά σε έναν χώρο εργασίας Fabric:
Μπορείτε να βρείτε περισσότερες πληροφορίες σχετικά με τη μορφή ορισμού API GraphQL, τη σύνταξη και παραδείγματα στην τεκμηρίωση των API επιπέδου ελέγχου Fabric:
API για GraphQL σε διοχέτευση ανάπτυξης
Ακολουθήστε τα παρακάτω βήματα για να ολοκληρώσετε το API για την ανάπτυξη GraphQL χρησιμοποιώντας τη διοχέτευση ανάπτυξης.
Δημιουργήστε μια νέα διοχέτευση ανάπτυξης ή ανοίξτε μια υπάρχουσα διοχέτευση ανάπτυξης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Γρήγορα αποτελέσματα με τις διοχετεύσεις ανάπτυξης.
Αναθέστε χώρους εργασίας σε διαφορετικά στάδια σύμφωνα με τους στόχους ανάπτυξής σας.
Επιλέξτε, προβάλετε και συγκρίνετε στοιχεία, συμπεριλαμβανομένου του API για GraphQL μεταξύ διαφορετικών σταδίων, όπως φαίνεται στο παρακάτω παράδειγμα. Οι επισημασμένες περιοχές που υποδεικνύουν πλήθος αλλαγμένων στοιχείων μεταξύ του προηγούμενου σταδίου και του τρέχοντος σταδίου.
- Επιλέξτε τα στοιχεία που πρέπει να αναπτυχθούν. Επιλέξτε Ανάπτυξη για να αναπτύξετε τα επιλεγμένα στοιχεία (API για GraphQL και την προέλευση Συνδεδεμένων δεδομένων του) στα στάδια Ανάπτυξη, Δοκιμή και Παραγωγή.
Εμφανίζεται το επόμενο μήνυμα που επιβεβαιώνει τα στοιχεία που πρόκειται να αναπτύξετε. Επιλέξτε Ανάπτυξη για να επιβεβαιώσετε και να συνεχίσετε τη διαδικασία ανάπτυξης.
Τρέχοντες περιορισμοί
Το CI/CD fabric δεν υποστηρίζει την αυτόματη σύνδεση των θυγατρικών στοιχείων. Αυτό σημαίνει ότι εάν το API για GraphQL συνδέεται σε ένα τελικό σημείο sql Analytics ως θυγατρικό στοιχείο μιας προέλευσης δεδομένων στον αρχικό χώρο εργασίας (π.χ. στάδιο ανάπτυξης), η καταγωγή δεν μεταφέρεται στον χώρο εργασίας προορισμού (π.χ., στάδιο δοκιμής). Κατά συνέπεια, το αναπτυγμένο API για GraphQL στον χώρο εργασίας προορισμού (π.χ. στάδιο δοκιμής) παραμένει συνδεδεμένο στο τελικό σημείο της ανάλυσης SQL στον αρχικό χώρο εργασίας (π.χ. στάδιο ανάπτυξης).
Η αυτόματη σύνδεση δεν υποστηρίζεται όταν η προσέγγιση Αποθηκευμένα διαπιστευτήρια χρησιμοποιείται για συνδέσεις προέλευσης δεδομένων. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα μέθοδοι ελέγχου ταυτότητας προέλευσης δεδομένων που περιγράφεται παραπάνω.