Σημείωμα
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να εισέλθετε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Χρησιμοποιήστε βιβλιοθήκες μεταβλητών στο Fabric για να διαχειριστείτε τις ρυθμίσεις παραμέτρων σε όλα τα στάδια της διοχέτευσης κυκλοφορίας και να αποθηκεύσετε τιμές στο Git. Αυτό το άρθρο εξηγεί τον τρόπο χρήσης βιβλιοθηκών μεταβλητών στο πλαίσιο της διαχείρισης κύκλου ζωής και της συνεχούς ενοποίησης και συνεχούς παράδοσης (CI/CD).
Βιβλιοθήκες μεταβλητών και διοχετεύσεις ανάπτυξης
Μπορείτε να αναπτύξετε βιβλιοθήκες μεταβλητών και τις τιμές τους σε διοχετεύσεις ανάπτυξης για να διαχειριστείτε τιμές μεταβλητών σε διάφορα στάδια.
Θυμηθείτε αυτές τις σημαντικές πληροφορίες:
Όλα τα σύνολα τιμών στη βιβλιοθήκη μεταβλητών είναι διαθέσιμα σε όλα τα στάδια της διοχέτευσης ανάπτυξης, αλλά μόνο ένα σύνολο είναι ενεργό σε ένα στάδιο.
Η ενεργή τιμή που έχει οριστεί για κάθε στάδιο επιλέγεται ανεξάρτητα. Μπορείτε να το αλλάξετε ανά πάσα στιγμή.
Όταν μια βιβλιοθήκη μεταβλητών αναπτύσσεται σε ένα κενό στάδιο, η ανάπτυξη δημιουργεί έναν χώρο εργασίας όπου είναι ενεργό το σύνολο τιμών Προεπιλογή . Εάν το περιβάλλον προορισμού απαιτεί ένα άλλο σύνολο τιμών, ανοίξτε τη βιβλιοθήκη μεταβλητών στον χώρο εργασίας προορισμού, ορίστε την απαιτούμενη τιμή που έχει οριστεί ως ενεργή και αποθηκεύστε τη βιβλιοθήκη μεταβλητών πριν από την εκτέλεση εξαρτώμενων στοιχείων ή ενεργειών σχεδίου ανάπτυξης.
Παρόλο που οι αναπτύξεις δεν επηρεάζουν το επιλεγμένο σύνολο ενεργών τιμών σε κάθε στάδιο, μπορείτε να ενημερώσετε τις ίδιες τις τιμές στη βιβλιοθήκη μεταβλητών. Το στοιχείο καταναλωτή στον χώρο εργασίας του (για παράδειγμα, μια διοχέτευση) λαμβάνει αυτόματα τη σωστή τιμή από το ενεργό σύνολο τιμών.
Οι ακόλουθες λειτουργίες σε μεταβλητές ή σύνολα τιμών σε ένα στάδιο μιας διοχέτευσης ανάπτυξης προκαλούν τον αντικατοπτρισμό της βιβλιοθήκης μεταβλητών ως διαφορετικής προέλευσης φόρμαςσε σύγκριση με το ίδιο στοιχείο σε διαφορετικό στάδιο:
- Προστιθέμενες, διαγραμμένες ή επεξεργασμένες μεταβλητές
- Σύνολα προστιθέμενων ή διαγραμμένων τιμών
- Ονόματα μεταβλητών
- Σειρά μεταβλητών
Μια απλή αλλαγή στο ενεργό σύνολο τιμών δεν καταχωρείται ως Διαφορετική προέλευση φόρμας κατά τη σύγκριση. Το σύνολο ενεργών τιμών αποτελεί μέρος της ρύθμισης παραμέτρων του στοιχείου, αλλά δεν περιλαμβάνεται στον ορισμό. Αυτός είναι ο λόγος για τον οποίο δεν εμφανίζεται στη σύγκριση διοχέτευσης ανάπτυξης και δεν αντικαθίσταται σε κάθε ανάπτυξη.
Χρήση μεταβλητών τιμών βιβλιοθήκης σε ένα σχέδιο ανάπτυξης
Μια ενέργεια σχεδίου ανάπτυξης μπορεί να χρησιμοποιήσει μια αναφορά βιβλιοθήκης μεταβλητών αντί για μια τιμή παραμέτρου σταθερών. Όταν εκτελείται η ανάπτυξη, το Fabric επιλύει την αναφορά χρησιμοποιώντας το ενεργό σύνολο τιμών της βιβλιοθήκης μεταβλητών στον χώρο εργασίας προορισμού. Αυτό επιτρέπει στην ίδια ενέργεια να χρησιμοποιεί τιμές που είναι συγκεκριμένες για κάθε στάδιο ανάπτυξης.
Πριν από την ανάπτυξη, βεβαιωθείτε ότι ο χώρος εργασίας προορισμού περιέχει την αναφερόμενη βιβλιοθήκη μεταβλητών και τη μεταβλητή και ότι το σωστό σύνολο τιμών είναι ενεργό. Η ανάπτυξη δεν αλλάζει το ενεργό σύνολο τιμών. Εάν η ανάπτυξη δημιουργεί τον χώρο εργασίας προορισμού, η Προεπιλογή είναι ενεργή μέχρι να επιλέξετε και να αποθηκεύσετε ένα άλλο σύνολο τιμών.
Για μια ενέργεια σχεδίου ανάπτυξης, μπορείτε να χρησιμοποιήσετε μια αναφορά μεταβλητής ως τιμή μιας παραμέτρου. Για περισσότερες πληροφορίες, δείτε την ενότητα Μεταβίβαση παραμέτρων σε μια ενέργεια.
Εάν το Fabric δεν μπορεί να επιλύσει μια αναφορά, αναφέρει ποιο τμήμα της αναφοράς απέτυχε. Για την ακολουθία ανάλυσης και τις διορθώσεις, ανατρέξτε στην ενότητα Αποτυχίες ανάλυσης μεταβλητής αναφοράς.
Βιβλιοθήκες μεταβλητών και ενοποίηση Git
Όπως και άλλα στοιχεία Fabric, οι βιβλιοθήκες μεταβλητών μπορούν να ενσωματωθούν στο Git για έλεγχο προέλευσης. Τα στοιχεία βιβλιοθήκης μεταβλητών αποθηκεύονται ως φάκελοι που μπορείτε να διατηρήσετε και να συγχρονίσετε μεταξύ του Fabric και του παρόχου Git.
Τα δικαιώματα στοιχείων ελέγχονται κατά την ενημέρωση και την ολοκλήρωση του 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.
- Το όνομα κάθε συνόλου τιμών πρέπει να είναι μοναδικό μέσα σε μια βιβλιοθήκη μεταβλητών.
- Τα ονόματα μεταβλητών πρέπει να είναι μοναδικά μέσα σε μια βιβλιοθήκη μεταβλητών. Μπορείτε να έχετε δύο μεταβλητές με το ίδιο όνομα σε έναν χώρο εργασίας, εάν βρίσκονται σε διαφορετικά στοιχεία.
- Υπάρχει πάντα μία (και μόνο μία) ενεργή τιμή που έχει οριστεί σε μια βιβλιοθήκη μεταβλητών κάθε φορά. Δεν μπορείτε να διαγράψετε ένα σύνολο τιμών ενώ είναι ενεργό. Για να το διαγράψετε, ρυθμίστε πρώτα μια άλλη τιμή που έχει οριστεί ώστε να είναι ενεργή. Μπορείτε να ορίσετε διαφορετική ενεργή τιμή για κάθε στάδιο μιας διοχέτευσης ανάπτυξης.