Κοινοποίηση μέσω

Τι είναι η ενοποίηση microsoft Fabric Git;

Αυτό το άρθρο εξηγεί στους προγραμματιστές πώς μπορείτε να ενσωματώσετε τον έλεγχο έκδοσης Git με το εργαλείο διαχείρισης κύκλου ζωής εφαρμογών Microsoft Fabric (ALM).

Σημείωση

Ορισμένα από τα στοιχεία για την ενοποίηση Git βρίσκονται σε προεπισκόπηση. Για περισσότερες πληροφορίες, ανατρέξτε στη λίστα των υποστηριζόμενων στοιχείων.

Η ενοποίηση Git στο Microsoft Fabric επιτρέπει στους προγραμματιστές να ενσωματώνουν τις διαδικασίες ανάπτυξης, τα εργαλεία και τις βέλτιστες πρακτικές τους απευθείας στην πλατφόρμα Fabric. Επιτρέπει στους προγραμματιστές που αναπτύσσουν in Fabric να:

  • Δημιουργία αντιγράφων ασφαλείας και διαχείριση εκδόσεων της εργασίας τους
  • Επαναφορά στα προηγούμενα στάδια, ανάλογα με τις ανάγκες
  • Συνεργασία με άλλους ή εργασία μόνη της με διακλαδώσεις του Git
  • Εφαρμογή των δυνατοτήτων οικείων εργαλείων ελέγχου προέλευσης για τη διαχείριση στοιχείων Fabric

Η ενοποίηση με το στοιχείο ελέγχου προέλευσης βρίσκεται σε επίπεδο χώρου εργασίας. Οι προγραμματιστές μπορούν να εκδόσεων στοιχεία που αναπτύσσουν εντός ενός χώρου εργασίας με μία μόνο διαδικασία, με πλήρη ορατότητα σε όλα τα στοιχεία τους. Η δομή του χώρου εργασίας, συμπεριλαμβανομένων των υποφακέλου, διατηρείται στο αποθετήριο δεδομένων Git.

Δείτε τη λίστα των υποστηριζόμενων στοιχείων.

  • Διαβάστε τις βασικές του Git και έννοιες ελέγχου εκδόσεων.

  • Διαβάστε περισσότερα σχετικά με τη διαδικασία ενοποίησης Git.

  • Διαβάστε σχετικά με τον καλύτερο τρόπο διαχείρισης των διακλαδώσεις σας Git.

Ασφάλεια δικτύου για ενσωμάτωση Git

Η ασφάλεια σε επίπεδο χώρου εργασίας στο Microsoft Fabric παρέχει λεπτομερή έλεγχο της πρόσβασης στα δεδομένα και της συνδεσιμότητας δικτύου, επιτρέποντας στους διαχειριστές να ρυθμίζουν τις παραμέτρους τόσο της εισερχόμενης όσο και της εξερχόμενης προστασίας για μεμονωμένους χώρους εργασίας. Αυτοί οι έλεγχοι διασφαλίζουν ότι τα ευαίσθητα δεδομένα παραμένουν εντός αξιόπιστων ορίων δικτύου και ενσωματώνονται με εργαλεία CI/CD όπως η ενσωμάτωση Git. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Ασφάλεια δικτύου για συνεχή ενοποίηση/συνεχή ανάπτυξη

Πληροφορίες προστασίας προσωπικών δεδομένων

Προτού ενεργοποιήσετε την ενοποίηση Git, βεβαιωθείτε ότι ελέγχετε τις παρακάτω δηλώσεις προστασίας προσωπικών δεδομένων:

Υποστηριζόμενες υπηρεσίες παροχής Git

Υποστηρίζονται οι ακόλουθες υπηρεσίες παροχής Git:

Υποστηριζόμενα στοιχεία

Τα ακόλουθα στοιχεία υποστηρίζουν αυτήν τη στιγμή ενοποίηση του Git:

Εάν ο χώρος εργασίας ή ο κατάλογος Git έχει μη υποστηριζόμενα στοιχεία, μπορεί ακόμα να συνδεθεί, αλλά τα μη υποστηριζόμενα στοιχεία παραβλέπονται. Δεν αποθηκεύονται ή συγχρονίζονται, αλλά δεν διαγράφονται. Εμφανίζονται στον πίνακα ελέγχου προέλευσης, αλλά δεν μπορείτε να τα δεσμεύσετε ή να τα ενημερώσετε.

Ζητήματα προς εξέταση και περιορισμοί

Γενικοί περιορισμοί ενοποίησης Git

  • Η μέθοδος ελέγχου ταυτότητας στο Fabric πρέπει να είναι τουλάχιστον τόσο ισχυρή όσο η μέθοδος ελέγχου ταυτότητας για το Git. Για παράδειγμα, εάν το Git απαιτεί έλεγχο ταυτότητας πολλών παραγόντων, το Fabric πρέπει να απαιτεί επίσης έλεγχο ταυτότητας πολλών παραγόντων.
  • Τα σύνολα δεδομένων Power BI που είναι συνδεδεμένα στις Υπηρεσίες ανάλυσης δεν υποστηρίζονται προς το παρόν.
  • Εάν χρησιμοποιείτε μια ταυτότητα χώρου εργασίας σε ένα αντικείμενο σχεδίασης και την δεσμεύετε στο Git, μπορεί να ενημερωθεί (πίσω σε έναν χώρο εργασίας fabric) μόνο σε έναν χώρο εργασίας που είναι συνδεδεμένος με την ίδια ταυτότητα. Να είστε προσεκτικοί, καθώς αυτό επηρεάζει επίσης δυνατότητες όπως η διακλάδωση.
  • Τα υπομονάδες δεν υποστηρίζονται.
  • Δεν υποστηρίζονται εθνικά cloud.
  • Εάν ο χώρος εργασίας σας περιέχει εκατοντάδες στοιχεία, εξετάστε το ενδεχόμενο να τον διαιρέσετε σε μικρότερα σύνολα αντικειμένων. Κάθε σύνολο θα πρέπει να τοποθετηθεί σε έναν ξεχωριστό χώρο εργασίας και να συνδεθεί με έναν διαφορετικό κλάδο Git ή να συνδεθεί σε έναν μόνο κλάδο οργανωμένο σε διαφορετικούς φακέλους.
  • Το Azure DevOps δεν υποστηρίζεται εάν είναι ενεργοποιημένη Ενεργοποίηση επικύρωσης πολιτικής πρόσβασης υπό όρους IP.
  • Εάν ο χώρος εργασίας και το αποθετήριο Git βρίσκονται σε δύο διαφορετικές γεωγραφικές περιοχές, ο διαχειριστής μισθωτή πρέπει να ενεργοποιήσει τις εξαγωγές μεταξύ γεωγραφικών περιοχών.
  • Εάν ο οργανισμός σας έχει ρυθμίσει πρόσβαση υπό όρους, βεβαιωθείτε ότι η υπηρεσία Power BI έχει τις ίδιες συνθήκες που έχουν οριστεί ελέγχου ταυτότητας ώστε να λειτουργεί με τον αναμενόμενο τρόπο.
  • Εφαρμόζεται το ακόλουθο όριο μεγέθους υποβολής:
    • 25 MB με χρήση της σύνδεσης Azure DevOps με κύρια υπηρεσία.
    • 125 MB με χρήση του προεπιλεγμένου λογαριασμού Microsoft Entra ID καθολικής σύνδεσης (SSO) και της σύνδεσης Azure DevOps με κύριο χρήστη.

Περιορισμοί για το GitHub Enterprise

Ορισμένες εκδόσεις και ρυθμίσεις του GitHub Enterprise δεν υποστηρίζονται. Για παράδειγμα:

  • Εταιρικό cloud GitHub με θέση αποθήκευσης δεδομένων (ghe.com)
  • Ο GitHub Enterprise Server με προσαρμοσμένο τομέα δεν υποστηρίζεται, ακόμη και αν η παρουσία είναι δημόσια προσβάσιμη
  • Ο διακομιστής Github Enterprise server φιλοξενείται σε ιδιωτικό δίκτυο
  • Λίστα επιτρεπόμενων διευθύνσεων IP

Azure DevOps στο GitHub Εξέταση μετεγκατάστασης επιχείρησης

Εάν η ομάδα σας χρησιμοποιεί το Fabric Git Integration και αξιολογεί μια μετεγκατάσταση από το Azure DevOps στο GitHub Enterprise, συνιστάται να εκτελέσετε δοκιμές επικύρωσης για να διασφαλίσετε ότι η λειτουργικότητα του Git Integration παραμένει ανεπηρέαστη. Η ενοποίηση Fabric Git βασίζεται στα υποκείμενα API του παρόχου Git, τα οποία διαφέρουν ως προς τις δυνατότητες και τους περιορισμούς μεταξύ του Azure DevOps και του GitHub Enterprise, όπως περιγράφεται παραπάνω.

Περιορισμοί χώρου εργασίας

  • Μόνο ο διαχειριστής χώρου εργασίας μπορεί να διαχειριστεί τις συνδέσεις στο Git Repo , όπως σύνδεση, αποσύνδεση ή προσθήκη διακλάδωσης.
    Αφού συνδεθεί, οποιοσδήποτε διαθέτει δικαιώματα μπορεί να εργαστεί στον χώρο εργασίας.
  • Δεν είναι δυνατή η σύνδεση χώρων εργασίας με εγκατεστημένες εφαρμογές προτύπου στο Git.
  • το MyWorkspace δεν μπορεί να συνδεθεί σε μια υπηρεσία παροχής Git.

Περιορισμοί διακλάδωσης και φακέλων

  • Το μέγιστο μήκος ονόματος διακλάδωσης είναι 244 χαρακτήρες.
  • Το μέγιστο μήκος πλήρους διαδρομής για τα ονόματα αρχείων είναι 250 χαρακτήρες. Τα μεγαλύτερα ονόματα αποτυγχάνουν.
  • Το μέγιστο μέγεθος αρχείου είναι 25 MB.
  • Η δομή φακέλων διατηρείται σε βάθος έως 10 επιπέδων.
  • Δεν συνιστάται η λήψη μιας αναφοράς/συνόλου δεδομένων ως .pbix από την υπηρεσία μετά την ανάπτυξή τους με ενοποίηση Git, καθώς τα αποτελέσματα δεν είναι αξιόπιστα. Συνιστούμε τη χρήση του PowerBI Desktop για τη λήψη αναφορών/συνόλων δεδομένων ως .pbix.
  • Εάν το εμφανιζόμενο όνομα του στοιχείου έχει οποιοδήποτε από αυτά τα χαρακτηριστικά, ο φάκελος Git μετονομάζεται στο λογικό αναγνωριστικό (Guid) και στον τύπο:
  • Όταν συνδέετε έναν χώρο εργασίας που έχει φακέλους στο Git, πρέπει να καταχωρήσετε αλλαγές στο αποθετήριο Git εάν αυτή δομή φακέλων διαφέρει.

Περιορισμοί ονόματος καταλόγου

  • Το όνομα του καταλόγου που συνδέεται στο αποθετήριο δεδομένων Git έχει τους ακόλουθους περιορισμούς ονοματοθεσίας:

    • Το όνομα του καταλόγου δεν μπορεί να αρχίζει ή να τελειώνει με ένα κενό διάστημα ή καρτέλα.
    • Το όνομα του καταλόγου δεν μπορεί να περιέχει οποιονδήποτε από τους ακόλουθους χαρακτήρες: "/:<>\*?|

  • Ο φάκελος στοιχείου (ο φάκελος που περιέχει τα αρχεία στοιχείων) δεν μπορεί να περιέχει οποιονδήποτε από τους ακόλουθους χαρακτήρες: ":<>\*?|. Εάν μετονομάσετε τον φάκελο σε κάτι που περιλαμβάνει έναν από αυτούς τους χαρακτήρες, το Git δεν μπορεί να συνδεθεί ή να συγχρονιστεί με τον χώρο εργασίας και παρουσιάζεται ένα σφάλμα.

Περιορισμοί διακλάδωσης

  • Η διακλάδωση απαιτεί δικαιώματα που παρατίθενται στον πίνακα δικαιωμάτων.
  • Πρέπει να υπάρχει ένα διαθέσιμο σύνολο εκχωρημένων πόρων για αυτήν την ενέργεια.
  • Όλοι οι περιορισμοί ονοματοθεσίας χώρων εργασίας και διακλαδών ισχύουν κατά τη διακλάδωση σε έναν νέο χώρο εργασίας.
  • Μόνο στοιχεία που υποστηρίζονται από το Git είναι διαθέσιμα στον νέο χώρο εργασίας.
  • Η λίστα σχετικών κλάδων εμφανίζει μόνο κλάδους και χώρους εργασίας για τους οποία έχετε δικαίωμα προβολής.
  • Η ενοποίηση Git πρέπει να ενεργοποιηθεί.
  • Κατά τη διακλάδωση, δημιουργείται ένας νέος κλάδος και οι ρυθμίσεις από τον αρχικό κλάδο δεν αντιγράφονται. Προσαρμόστε τυχόν ρυθμίσεις ή ορισμούς για να διασφαλίσετε ότι ο νέος χρήστης πληροί τις πολιτικές του οργανισμού σας.
  • Κατά τη διακλάδωση σε έναν υπάρχοντα χώρο εργασίας:
    • Ο χώρος εργασίας προορισμού πρέπει να υποστηρίζει μια σύνδεση Git.
    • Ο χρήστης πρέπει να είναι διαχειριστής του χώρου εργασίας προορισμού.
    • Ο χώρος εργασίας προορισμού πρέπει να έχει εκχωρημένους πόρους.
    • Ο χώρος εργασίας δεν μπορεί να έχει εφαρμογές προτύπου.
  • Σημειώστε ότι όταν κάνετε διακλάδωση σε έναν χώρο εργασίας, οποιαδήποτε στοιχεία δεν αποθηκεύονται στο Git μπορεί να χαθούν. Συνιστούμε να δεσμεύσετε στοιχεία που θέλετε να διατηρήσετε πριν από την διακλάδωση.

Περιορισμοί συγχρονισμού και δέσμευσης

  • Μπορείτε να συγχρονίσετε μόνο προς μία κατεύθυνση κάθε φορά. Δεν μπορείτε να πραγματοποιήσετε και να ενημερώσετε ταυτόχρονα.
  • Οι ετικέτες ευαισθησίας δεν υποστηρίζονται και η εξαγωγή στοιχείων με ετικέτες ευαισθησίας μπορεί να είναι απενεργοποιημένη. Για να δεσμεύσετε στοιχεία που έχουν ετικέτες ευαισθησίας χωρίς την ετικέτα ευαισθησίας, ζητήστε βοήθεια από τον διαχειριστή σας.
  • Λειτουργεί με περιορισμένα στοιχεία. Τα μη υποστηριζόμενα στοιχεία στον φάκελο παραβλέπονται.
  • Δεν επιτρέπεται η αντιγραφή ονομάτων. Ακόμη και αν το Power BI επιτρέπει την αντιγραφή ονόματος, η ενέργεια ενημέρωσης, δέσμευσης ή αναίρεσης αποτυγχάνει.
  • Το B2B δεν υποστηρίζεται.
  • Η επίλυση διένεξης πραγματοποιείται εν μέρει στο Git.
  • Κατά τη διαδικασία Δέσμευση στο Git , η υπηρεσία Fabric διαγράφει αρχεία μέσα στον φάκελο στοιχείου που δεν αποτελούν μέρος του ορισμού στοιχείου. Δεν διαγράφονται μη σχετιζόμενα αρχεία που δεν βρίσκονται σε έναν φάκελο στοιχείων.
  • Μετά την πραγματοποίηση αλλαγών, ενδέχεται να παρατηρήσετε ορισμένες μη αναμενόμενες αλλαγές στο στοιχείο που δεν πραγματοποιήσατε. Αυτές οι αλλαγές είναι σημασιολογικά ασήμαντες και μπορούν να συμβούν για διάφορους λόγους. Για παράδειγμα:
    • Αλλαγή με μη αυτόματο τρόπο του αρχείου ορισμού στοιχείου. Αυτές οι αλλαγές είναι έγκυρες, αλλά μπορεί να είναι διαφορετικές από ότι εάν γίνονται μέσω των συντακτών. Για παράδειγμα, εάν μετονομάσετε μια στήλη σημασιολογικού μοντέλου στο Git και εισαγάγετε αυτή την αλλαγή στον χώρο εργασίας, την επόμενη φορά που θα πραγματοποιήσετε αλλαγές στο μοντέλο σημασιολογίας, το αρχείο bim θα καταχωρηθεί όπως έχει αλλάξει και η τροποποιημένη στήλη θα προωθηθεί στο πίσω μέρος του columns πίνακα. Αυτό συμβαίνει επειδή η μηχανή AS που δημιουργεί τα αρχεία bim προωθεί μετονομασμένες στήλες στο τέλος του πίνακα. Αυτή η αλλαγή δεν επηρεάζει τον τρόπο λειτουργίας του στοιχείου.
    • Δέσμευση ενός αρχείου που χρησιμοποιεί αλλαγές γραμμής του CRLF . Η υπηρεσία χρησιμοποιεί αλλαγές γραμμής LF (αλλαγή γραμμής). Εάν είχατε αρχεία στοιχείων στο αποθετήριο Git με αλλαγές γραμμής CRLF , όταν δεσμεύετε από την υπηρεσία, αυτά τα αρχεία αλλάζουν σε LF. Για παράδειγμα, εάν ανοίξετε μια αναφορά στο desktop, αποθηκεύστε το αρχείο έργου (.pbip) και αποστείλετε στο Git χρησιμοποιώντας CRLF .
  • Η ανανέωση ενός σημασιολογικού μοντέλου με χρήση του API Βελτιωμένης ανανέωσης προκαλεί μια διαφορά Git μετά από κάθε ανανέωση.

Σχετικό περιεχόμενο

  • Last updated on