Μεταβλητή βιβλιοθήκη CI/CD

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

Βιβλιοθήκες μεταβλητών και διοχετεύσεις ανάπτυξης

Μπορείτε να αναπτύξετε βιβλιοθήκες μεταβλητών και τις τιμές τους σε διοχετεύσεις ανάπτυξης για να διαχειριστείτε τιμές μεταβλητών σε διάφορα στάδια.

Θυμηθείτε αυτές τις σημαντικές πληροφορίες:

• Όλα τα σύνολα τιμών στη βιβλιοθήκη μεταβλητών είναι διαθέσιμα σε όλα τα στάδια της διοχέτευσης ανάπτυξης, αλλά μόνο ένα σύνολο είναι ενεργό σε ένα στάδιο.

• Η ενεργή τιμή που έχει οριστεί για κάθε στάδιο επιλέγεται ανεξάρτητα. Μπορείτε να το αλλάξετε ανά πάσα στιγμή.

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

  

• Παρόλο που οι αναπτύξεις δεν επηρεάζουν το επιλεγμένο σύνολο ενεργών τιμών σε κάθε στάδιο, μπορείτε να ενημερώσετε τις ίδιες τις τιμές στη βιβλιοθήκη μεταβλητών. Το στοιχείο καταναλωτή στον χώρο εργασίας του (για παράδειγμα, μια διοχέτευση) λαμβάνει αυτόματα τη σωστή τιμή από το ενεργό σύνολο τιμών.

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

• Προστιθέμενες, διαγραμμένες ή επεξεργασμένες μεταβλητές
• Σύνολα προστιθέμενων ή διαγραμμένων τιμών
• Ονόματα μεταβλητών
• Σειρά μεταβλητών

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

Βιβλιοθήκες μεταβλητών και ενοποίηση Git

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

Τα δικαιώματα στοιχείων ελέγχονται κατά την ενημέρωση και την ολοκλήρωση του Git.

Το σχήμα για το στοιχείο βιβλιοθήκης μεταβλητών είναι ένα αντικείμενο JSON που περιέχει τέσσερα μέρη:

• Φάκελος για σύνολα τιμών
• Ρυθμίσεις
• Platform.json, ένα αρχείο που δημιουργείται αυτόματα
• Μεταβλητές

Σύνολα τιμών

Ο φάκελος βιβλιοθήκης μεταβλητών περιέχει έναν υποφάκελο που ονομάζεται valueSets. Αυτός ο φάκελος περιέχει ένα αρχείο JSON για κάθε σύνολο τιμών. Αυτό το αρχείο JSON περιέχει μόνο τις τιμές μεταβλητών για μη προεπιλεγμένες τιμές σε αυτό το σύνολο τιμών.

Για περισσότερες πληροφορίες σχετικά με το αρχείο συνόλου τιμών, ανατρέξτε στο θέμα Σύνολα τιμών και παράδειγμα συνόλου τιμών.

Οι τιμές για μεταβλητές που δεν βρίσκονται σε αυτό το αρχείο λαμβάνονται από το προεπιλεγμένο σύνολο τιμών.

Ρυθμίσεις

Το settings.json αρχείο περιέχει ρυθμίσεις για τη βιβλιοθήκη μεταβλητών.

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα μεταβλητές και το settings.json παράδειγμα.

Μεταβλητές

Το variables.json αρχείο περιέχει τα ονόματα των μεταβλητών και τις προεπιλεγμένες τιμές τους.

Για περισσότερες πληροφορίες, ανατρέξτε στο variables.json παράδειγμα.

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

Περιορισμοί για τις μεταβλητές

• Μπορούν να υπάρχουν έως 1.000 μεταβλητές και έως 1.000 σύνολα τιμών, εφόσον πληροίτε και τις δύο αυτές απαιτήσεις:

  • Ο συνολικός αριθμός κελιών στα εναλλακτικά σύνολα τιμών είναι μικρότερος από 10.000.
  • Το μέγεθος του στοιχείου δεν υπερβαίνει το 1 MB.

  Αυτές οι απαιτήσεις επικυρώνονται όταν αποθηκεύετε αλλαγές.

• Το πεδίο σημείωσης μπορεί να έχει έως 2.048 χαρακτήρες.

• Το πεδίο περιγραφής συνόλου τιμών μπορεί να έχει έως 2.048 χαρακτήρες.

Περιορισμοί για εναλλακτικά σύνολα τιμών

• Τα εναλλακτικά σύνολα τιμών σε μια βιβλιοθήκη μεταβλητών εμφανίζονται με τη σειρά με την οποία τα προσθέσατε. Προς το παρόν, δεν μπορείτε να τις αναδιατάξετε στο περιβάλλον εργασίας χρήστη. Για να αλλάξετε τη σειρά, επεξεργαστείτε απευθείας το αρχείο JSON.
• Το όνομα κάθε συνόλου τιμών πρέπει να είναι μοναδικό μέσα σε μια βιβλιοθήκη μεταβλητών.
• Τα ονόματα μεταβλητών πρέπει να είναι μοναδικά μέσα σε μια βιβλιοθήκη μεταβλητών. Μπορείτε να έχετε δύο μεταβλητές με το ίδιο όνομα σε έναν χώρο εργασίας, εάν βρίσκονται σε διαφορετικά στοιχεία.
• Υπάρχει πάντα μία (και μόνο μία) ενεργή τιμή που έχει οριστεί σε μια βιβλιοθήκη μεταβλητών κάθε φορά. Δεν μπορείτε να διαγράψετε ένα σύνολο τιμών ενώ είναι ενεργό. Για να το διαγράψετε, ρυθμίστε πρώτα μια άλλη τιμή που έχει οριστεί ώστε να είναι ενεργή. Μπορείτε να ορίσετε διαφορετική ενεργή τιμή για κάθε στάδιο μιας διοχέτευσης ανάπτυξης.

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

• μορφή πηγαίου κώδικα ενοποίησης Git