Έκδοση 1.0.0-alpha.1τελευταία
Κεφάλαιο 2.28
Κυκλοφορία της επέκτασής σας
Πώς ένα πρόσθετο ή ένα πακέτο περνά από μια επιτυχημένη δόμηση στις μονάδες που το εκτελούν, και πώς αποσύρεται ξανά. Εκδόσεις, έλεγχος κυκλοφορίας, κανάλια και εγκαταστάσεις, υπογραφή, εγκρίσεις αλλαγών, η εγγραφή ταυτότητας παράδοσης, μεταφορές (migrations), επαναφορά και απόσυρση μιας έκδοσης.
Αυτή η σελίδα μεταφράστηκε με AI από το αγγλικό πρωτότυπο. Εάν οτιδήποτε είναι ασαφές, η αγγλική σελίδα αποτελεί το σημείο αναφοράς. Διαβάστε αυτή τη σελίδα στα αγγλικά

Το Cold chain 0.4.0 ήταν η πρώτη μας έκδοση που ζητούσε περισσότερα από την προηγούμενη. Πρόσθεσε αποστολή αλληλογραφίας και μία εξωτερική διεύθυνση, για ειδοποιήσεις ψυκτικών εμπορευματοκιβωτίων. Η κατασκευή ήταν πράσινη, οι δοκιμές πέρασαν και στους τρεις συνθετικούς κλάδους, και παρ' όλα αυτά παρέμεινε στον χώρο ανάπτυξης για δύο ημέρες, ενώ δύο άτομα διάβαζαν τι ζητούσε και ένα τρίτο ενέκρινε τη διεύθυνση. Έτσι ακριβώς πρέπει να είναι η κυκλοφορία εκδόσεων στο Nexus: ο κώδικας είναι το εύκολο μέρος, και τα τεκμήρια και οι εγκρίσεις είναι η ίδια η έκδοση.
Αυτό το κεφάλαιο καλύπτει όλα όσα μεσολαβούν από μια πράσινη κατασκευή έως μια έκδοση που εκτελείται για κάθε μονάδα, καθώς και τους τρόπους επιστροφής. Η ίδια η διαδρομή προώθησης, από τον χώρο ανάπτυξης στο staging, σε μια πιλοτική μονάδα και σε όλες τις μονάδες, παρουσιάζεται στο κεφάλαιο 2.24, Δημιουργία ενός προσαρμοσμένου κάθετου κλάδου από άκρη σε άκρη, και δεν θα επαναλάβω εδώ τις πύλες της. Ένας κανόνας πλαισιώνει τα πάντα. Η ανάπτυξη γίνεται αποκλειστικά μέσω των καναλιών εκδόσεων της εγκατάστασης. Δεν υπάρχει πλαϊνή πόρτα για μια επείγουσα διόρθωση, και κανείς δεν επεξεργάζεται χειροκίνητα μια εικόνα που εκτελείται.
Εκδόσεις
Σε μια έκδοση πακέτου μετακινούνται τρεις αριθμοί έκδοσης, και αξίζει να τους κρατάτε διακριτούς στο μυαλό σας.
| Τι | Πού βρίσκεται | Παράδειγμα | Κανόνας |
|---|---|---|---|
| Το πρόσθετο | version στο nexus.manifest.json |
0.4.0 |
Σημασιολογική έκδοση· επιτρέπεται επίθημα προέκδοσης όπως -rc.1 |
| Το πακέτο | version στο pack.json |
0.4.0 |
Μετακινείται μαζί με τους φακούς, τις λέξεις και τις συστάδες του πακέτου |
| Το μοντέλο γνώσης | Η δική του έκδοση του μοντέλου | 1.3 έως 1.4 |
Μετακινείται μόνο μέσω αιτήματος αλλαγής γράφου |
Μια κατασκευή ανάπτυξης φέρει επίθημα, 0.4.0-dev, μέχρι να φτάσει στο staging. Διατηρείτε ίσες τις εκδόσεις του πρόσθετου και του πακέτου όταν διατίθενται μαζί· γλιτώνετε έτσι μια διαφωνία σε κάθε αναθεώρηση έκδοσης σχετικά με το σε ποιον αριθμό ανήκουν τα τεκμήρια.
Δύο άλλες εκδόσεις καθηλώνονται αντί να επιλέγονται. Η έκδοση προτύπου του πακέτου (domain-pack@1.6.0 για το Cold chain) ορίζεται κατά τη δημιουργία του πακέτου και μετακινείται μόνο ως αναθεωρημένη αλλαγή. Το SDK (κιτ ανάπτυξης λογισμικού) εγκαθίσταται σε ακριβή έκδοση, ποτέ σε εύρος, ώστε η ίδια κατασκευή να δίνει το ίδιο αποτέλεσμα και τον επόμενο μήνα:
npm install --save-exact @adverant-nexus/plugin-sdk@2.50.0Και οι δεξιότητες του Skills Engine έχουν εκδόσεις, αλλά συμπεριφέρονται διαφορετικά. Κάθε δημοσιευμένη έκδοση είναι σταθερή, και τα live, canary και shadow είναι ετικέτες σε εκδόσεις. Η επιστροφή μετακινεί μια ετικέτα, και οι εκτελέσεις που βρίσκονται ήδη σε εξέλιξη ολοκληρώνονται στην έκδοση με την οποία ξεκίνησαν.
Πριν ζητήσετε έλεγχο: το manifest
Η σελίδα Manifest και δικαιώματα συγκρίνει όσα δηλώνει αυτή η έκδοση με την τελευταία έκδοση: τα εύρη δικαιωμάτων, τους χώρους αποθήκευσης, τις εξερχόμενες διευθύνσεις και το προφίλ sandbox. Διαβάστε την πριν ζητήσετε από οποιονδήποτε αναθεώρηση, διότι σας λέει ακριβώς τι θα κληθούν να αποδεχτούν οι αναθεωρητές.
Μια έκδοση που ζητά περισσότερα από όσα δήλωνε προηγουμένως το manifest της παραμένει εκεί που βρίσκεται, με MANIFEST_SCOPE_WIDENED, μέχρι δύο αναθεωρητές να αποδεχτούν το ευρύτερο manifest. Μια εξωτερική διεύθυνση χρειάζεται επίσης την έγκριση του υπευθύνου για τις εξωτερικές διευθύνσεις στον πελάτη· η έγκριση αυτή δίνεται για ορισμένη διάρκεια, και η δική μας ήταν για 12 μήνες. Έχετε δύο δρόμους: να αφαιρέσετε τις γραμμές ή να ζητήσετε αναθεώρηση. Η σελίδα προσφέρει και τα δύο κουμπιά.
Κάθε γραμμή αυτής της σελίδας επιβάλλεται κατά την εκτέλεση, δεν απλώς αναθεωρείται. Κάθε κλήση εργαλείου ελέγχεται έναντι των δηλωμένων ευρών δικαιωμάτων, μια εξωτερική διεύθυνση αποκλείεται εκτός αν είναι καταχωρισμένη, και το προφίλ sandbox δεν επιτρέπει κανένα άλλο δίκτυο. Ένα πρόσθετο που προσπαθεί να φτάσει σε κάτι που δεν δήλωσε απορρίπτεται, και η μόνη λύση είναι μια νέα έκδοση που το δηλώνει.
Έλεγχος κυκλοφορίας
Η σελίδα Αναθεώρηση έκδοσης συγκεντρώνει τα τεκμήρια μιας έκδοσης σε έναν πίνακα, για έναν αναθεωρητή που δεν είναι ο συντάκτης.
| Τεκμήρια | Τι έδειξε για την 0.4.0 |
|---|---|
| Δοκιμές | 66 από 66, σε τρεις συνθετικούς κλάδους |
| Έλεγχοι ποιότητας | Η τεκμηρίωση και ο κώδικας συμφωνούν |
| Πολιτική | Κάθε φακός μόνο περιορίζει· τα προσωπικά πεδία είναι απενεργοποιημένα από προεπιλογή |
| Υπογραφές | Εικόνα και πακέτο υπογεγραμμένα από τη γραμμή παραγωγής |
| Διαφορά ευρών δικαιωμάτων | Προσθέτει αποστολή αλληλογραφίας και μία εξωτερική διεύθυνση, με την έγκρισή της |
| Συμβατότητα | Η έκδοση πλατφόρμας και η έκδοση του βασικού πακέτου έναντι των οποίων δοκιμάστηκε |
| Αλλαγή μοντέλου | Η δοκιμαστική εκτέλεση του αιτήματος αλλαγής γράφου: 1.284 σύνδεσμοι μετονομάστηκαν, τίποτα δεν αφαιρέθηκε |
Κάτω από τον πίνακα βρίσκονται τα σχόλια για την αλλαγή και η προέλευση: ποια γραμμή παραγωγής την κατασκεύασε, από ποια αλλαγή, το digest της εικόνας και το πρότυπο. Οι αναθεωρητές εγκρίνουν με το passkey τους. Δύο αναθεωρητές που δεν είναι ο συντάκτης εγκρίνουν, και στη συνέχεια η γραμμή παραγωγής μετακινεί την έκδοση στο staging. Ο συντάκτης δεν μετρά ποτέ ως αναθεωρητής, και μια τέτοια απόπειρα απορρίπτεται με NEEDS_SECOND_PERSON. Ένα αίτημα αναθεώρησης λήγει μετά από 3 ημέρες.
Απαντάτε στις ερωτήσεις των αναθεωρητών στα σχόλια, όχι σε ένα παράθυρο συνομιλίας. Κατά την αναθεώρησή μας, ο υπεύθυνος συμμόρφωσης ρώτησε γιατί το ποσό αποζημίωσης είχε ταξινομηθεί ως εμπορικό, και ο δεύτερος αναθεωρητής ζήτησε το σχέδιο επαναφοράς για την αλλαγή μοντέλου. Και οι δύο απαντήσεις αποτελούν πλέον μέρος του αρχείου της έκδοσης, όπου θα κοιτάξει ο επόμενος αναθεωρητής.
Εγκρίσεις πολιτικής αλλαγών
Η αναθεώρηση έκδοσης καλύπτει την έκδοση στο σύνολό της. Το μπλοκ changePolicy στο manifest πηγαίνει παραπέρα: ορίζει ποιες κατηγορίες αλλαγών στα αναπτυσσόμενα στοιχεία του πρόσθετού σας χρειάζονται έγκριση, και από πόσα άτομα.
"changePolicy": {
"enabled": true,
"classes": ["website", "bff", "migration"],
"approvals": { "website": 1, "bff": 1, "migration": 2 }
}Οι τρεις κατηγορίες είναι website (η εφαρμογή web), bff (το backend for frontend) και migration (μια μετάβαση βάσης δεδομένων). Κάθε κατηγορία που αναφέρεται στο classes πρέπει να έχει τη δική της τιμή στο approvals, από 1 έως 10. Μια κατηγορία που παραλείπετε δεν διέπεται από κανόνες, και το σχήμα σάς υποχρεώνει να το γράψετε ως επιλογή αντί να καταλήξετε σε αυτό από παράλειψη. Ζητάμε δύο εγκρίσεις για τις μεταβάσεις, διότι η μετάβαση είναι η μόνη αλλαγή που αναιρείται δύσκολα.
Οι εγκρίσεις μετρώνται σε διακριτά άτομα, και αυτός που προτείνει την αλλαγή δεν είναι ποτέ ένα από αυτά. Αξίζει να γνωρίζετε τους κανόνες που το στηρίζουν, διότι ο καθένας έχει μια απόρριψη:
- Μια έγκριση από το άτομο που πρότεινε την αλλαγή απορρίπτεται με
TRUST_APPROVAL_SELF_APPROVAL. - Ένα άτομο που δεν επιτρέπεται καθόλου να κάνει αλλαγή αυτής της κατηγορίας απορρίπτεται με
CHANGE_CLASS_NOT_PERMITTED. - Όταν οποιοδήποτε commit της αλλαγής είναι υπογεγραμμένο από την ταυτότητα πράκτορα του οργανισμού, η απαρτία είναι το συνήθες ελάχιστο συν ένα, και η ψήφος του ίδιου του πράκτορα δεν μετρά.
- Κάθε έγκριση καταγράφει τη διαφορά και το head που είδε. Αν η αλλαγή μετακινηθεί μετά την τελευταία έγκριση, η συγχώνευσή της απορρίπτεται με
HASH_MISMATCH, και οι εγκρίσεις πρέπει να συγκεντρωθούν ξανά για το νέο περιεχόμενο.
Ο τρίτος αυτός κανόνας έχει σημασία αν αναπτύσσετε με ένα εργαλείο κώδικα AI (τεχνητής νοημοσύνης), όπως περιγράφει το κεφάλαιο 2.26, Ανάπτυξη με εργαλεία κώδικα AI. Η εργασία που έγραψε ένας πράκτορας χρειάζεται μία ανθρώπινη έγκριση περισσότερη από την εργασία που έγραψε ένας άνθρωπος. Προγραμματίστε το.
Υπογραφή και επαλήθευση
Κάθε εικόνα και πακέτο υπογράφεται από τη γραμμή παραγωγής που το κατασκεύασε, και μια υπογεγραμμένη εικόνα είναι μία από τις πύλες προς το staging. Ένας χώρος ανάπτυξης εκτελεί μόνο υπογεγραμμένες εικόνες από την αρχή. Στο Enterprise, ένας διαχειριστής ορίζει κάθε namespace είτε να καταγράφει τις μη υπογεγραμμένες εικόνες είτε να τις απορρίπτει, και μεταφέρει τα namespaces στην απόρριψη ένα κάθε φορά, ώστε τελικά η παραγωγή να εκτελεί μόνο εικόνες που κατασκεύασε και υπέγραψε η γραμμή παραγωγής. Η υπογραφή είναι μέρος της κατασκευής, όχι κάτι που προσθέτετε πριν από μια έκδοση.
Ο κανόνας που διατρέχει τα πάντα είναι ότι μια υπογραφή που αποτυγχάνει αποτελεί απόρριψη, ποτέ προειδοποίηση. Ένας έλεγχος που λαμβάνει SIG_INVALID σταματά. Δεν επιστρέφει στη μη υπογεγραμμένη έκδοση και δεν συνεχίζει με μια σημείωση σε ένα αρχείο καταγραφής, διότι μια προειδοποίηση σε ένα αρχείο καταγραφής κατασκευής ισοδυναμεί με έγκριση για όποιον δεν τη διάβασε.
Ο ίδιος κανόνας ισχύει για οτιδήποτε παραδίδετε σε μέσα αποθήκευσης. Ένα σφραγισμένο πακέτο για πελάτη με απομονωμένο (air-gapped) περιβάλλον επαληθεύεται έναντι του δημόσιου κλειδιού σας πριν αποσυμπιεστεί οτιδήποτε, και το κεφάλαιο 2.25, Ανάπτυξη για κάθε έκδοση προϊόντος, δείχνει την εντολή.
Ταυτότητα παράδοσης
Ένα πρόσθετο παραδίδεται μέσω πολλών στοιχείων που το καθένα έχει όνομα: τα αποθετήριά του, ένα κλειδί υπογραφής, ένα namespace ανάπτυξης, ένα πρόθεμα μητρώου, ένα σχήμα βάσης δεδομένων, ένα σύνολο τομέων και μια πολιτική αλλαγών. Οποιοδήποτε από αυτά είναι σημείο όπου δύο πρόσθετα θα μπορούσαν να συγκρουστούν ή ένα πρόσθετο να αποκλίνει. Η ταυτότητα παράδοσης είναι μία υπογεγραμμένη εγγραφή ανά πρόσθετο που τα περιέχει όλα, ώστε κάθε έλεγχος στη διαδρομή της έκδοσης να διαβάζει την ίδια απάντηση και να απορρίπτει σε περίπτωση αναντιστοιχίας.
Συνεισφέρετε το δικό σας μέρος μέσω του manifest και τίποτε άλλο: schema, db, domains, changePolicy και το URL του αποθετηρίου. Η πλατφόρμα συμπληρώνει την εγγραφή με τα υπόλοιπα και την υπογράφει. Δεν ονομάζετε ποτέ μόνοι σας το namespace, το πρόθεμα μητρώου ή το κλειδί υπογραφής σας. Αυτά σας εκχωρούνται, και ένα manifest που θα προσπαθούσε να τα δηλώσει θα διατύπωνε έναν ισχυρισμό που οι έλεγχοι θα έπρεπε στη συνέχεια να μην πιστέψουν.
Η υπογεγραμμένη εγγραφή περιέχει έντεκα πεδία: το slug του πρόσθετου, τον οργανισμό-κάτοχο, τον οργανισμό που το κατασκευάζει, τα αποθετήριά του, το όνομα του κλειδιού υπογραφής του, το namespace ανάπτυξής του, το πρόθεμα μητρώου του, το σχήμα βάσης δεδομένων του, τους τομείς του, την πολιτική αλλαγών του και μια σύντομη λίστα παλαιότερων ονομάτων εικόνων που χρησιμοποιούσε πριν υπάρξει το πρόθεμα μητρώου του. Αυτή η τελευταία λίστα μπορεί μόνο να μικραίνει. Επειδή είναι υπογεγραμμένη, μια νέα υπογραφή μπορεί να αφαιρέσει μια καταχώριση και τίποτα δεν μπορεί να προσθέσει μία αθόρυβα. Η υπογραφή είναι Ed25519 πάνω στην τυπική κανονική μορφή JSON αυτών των έντεκα πεδίων, ώστε μια εγγραφή που περιέχει "Tomás" ή "Sinéad" να επαληθεύεται με τον ίδιο τρόπο παντού.
Όταν μια έκδοση δεν αντιστοιχεί στην εγγραφή της, υπερισχύει η πρώτη απόρριψη:
| Κωδικός | Πότε | HTTP |
|---|---|---|
DELIVERY_IDENTITY_MISSING |
Δεν υπάρχει εγγραφή για το πρόσθετο | 403 |
DELIVERY_PATH_REFUSED |
Μια ώθηση εικόνας εκτός του προθέματος μητρώου που δεν βρίσκεται στην υπογεγραμμένη λίστα παλαιότερων ονομάτων | 403 |
NAMESPACE_MISMATCH |
Μια ανάπτυξη που στοχεύει άλλο namespace | 403 |
IMAGE_NAME_COLLISION |
Ένα όνομα εικόνας που ήδη διεκδικεί άλλο πρόσθετο | 409 |
CHANGE_CLASS_NOT_PERMITTED |
Μια κατηγορία αλλαγών που δεν διέπεται από την πολιτική | 403 |
Το IMAGE_NAME_COLLISION είναι αυτό που εκπλήσσει. Επιλέξτε άλλο όνομα και μην επαναχρησιμοποιείτε ποτέ κάποιο: ένα κοινό όνομα εικόνας σημαίνει ότι η προώθηση ενός πρόσθετου μπορεί να μετακινήσει τα pods ενός άλλου πρόσθετου.
Μεταφορές, οριστικοποιημένες και εντός εμβέλειας
Μια μετάβαση διατίθεται μέσα στην εικόνα του πρόσθετού σας και εκτελείται πριν ξεκινήσει η νέα έκδοση, μέσω του μοναδικού εκτελεστή μεταβάσεων του SDK, nexus-migrate. Δεν γράφετε δικό σας μηχανισμό εφαρμογής. Πριν μπορέσει να μετακινηθεί οποιαδήποτε έκδοση, ο ίδιος εκτελεστής εφαρμόζει τις μεταβάσεις σας ένα αρχείο τη φορά σε μια προσωρινή βάση δεδομένων, ώστε μια μετάβαση που αποτυγχάνει να αποτύχει εκεί. Η σκιώδης κατασκευή του προτύπου καλεί τον εκτελεστή μία φορά ανά αρχείο, με τη σειρά, και καταγράφει κάθε αρχείο όπως θα το κάνει η παραγωγή.
Οι κανόνες του εκτελεστή είναι αυτοί που ελέγχουν οι πύλες, γραμμένοι ως κώδικας:
- Συνδέεται με τον ρόλο migrator του σχήματός σας και εκτελεί κάθε αρχείο ως κάτοχος του σχήματος. Οποιαδήποτε άλλη σύνδεση, πρωτίστως ενός superuser, απορρίπτεται. Ένα αρχείο που προσπαθεί να αλλάξει ρόλο από μόνο του απορρίπτεται πριν εκτελεστεί οτιδήποτε.
- Το αρχείο μίσθωσης (tenancy), με αριθμό 0, δεν επεξεργάζεται ποτέ αφού εφαρμοστεί. Μια αλλαγή στη μίσθωση αποκτά δικό της αρχείο αναθεώρησης,
000_tenancy_r<N>.sql, το οποίο γράφει για εσάς τοnexus-tenancy render --revision <N>. - Κανονικά ο εκτελεστής κατέχει τη συναλλαγή κάθε αρχείου και απορρίπτει ένα
BEGINήCOMMITμέσα σε αυτήν. Ένα αρχείο που διαχειρίζεται τις δικές του συναλλαγές δηλώνει ότι εκτελείται ανά εντολή, και τότε κάθεBEGINπου ανοίγει πρέπει να έχει το αντίστοιχό του. - Διατηρεί ένα καθολικό, μία γραμμή ανά αρχείο, με το SHA-256 του αρχείου και τον τρόπο εκτέλεσής του. Ένα εφαρμοσμένο αρχείο δεν αλλάζει ποτέ επί τόπου· μια αλλαγή είναι ένα νέο αριθμημένο αρχείο.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-tenancy render --manifest nexus.manifest.json --revision 2 --out migrations/000_tenancy_r2.sqlΟριοθετημένο σημαίνει ότι κάθε νέος πίνακας φέρει τα organization_id, owner_user_id και business_unit_id, καθώς και τη στήλη σήμανσης is_demo εκτός αν το gates/demo-exempt.json εξαιρεί τον πίνακα με αιτιολόγηση, με πρωτεύον κλειδί που ξεκινά με τον οργανισμό και ξένα κλειδιά που τον φέρουν, και με επιβεβλημένη ασφάλεια σε επίπεδο γραμμής. Η πύλη migrations-are-scoped ελέγχει αυτούς τους κανόνες σε κάθε αρχείο, και το migrations-commit-what-they-open μετρά ότι κάθε αρχείο κάνει commit όσα ανοίγει. Η δεύτερη πύλη υπάρχει επειδή κάποτε μια μετάβαση που έκανε σιωπηρά rollback τερμάτισε με 0, και ο πίνακας που έπρεπε να δημιουργήσει δεν υπήρξε ποτέ.
Ένα ακόμη αρχείο ανήκει σε κάθε έκδοση. Το scripts/ci/required-env εκτυπώνει τις μεταβλητές περιβάλλοντος που χρειάζεται η υπηρεσία σας για να εκκινήσει, ως πίνακα JSON που λαμβάνεται από τον φορτωτή ρυθμίσεών σας. Η διαδρομή έκδοσης το εκτελεί και απορρίπτει μια έκδοση της οποίας η ανάπτυξη δεν ορίζει κάθε μία από αυτές, ώστε μια μεταβλητή που λείπει να εντοπίζεται πριν από την έκδοση και όχι από ένα pod που δεν ξεκινά.
node scripts/ci/required-envΚυκλοφορία δεξιοτήτων
Τα δύο είδη δεξιοτήτων φτάνουν στους χρήστες από διαφορετικές διαδρομές, γι' αυτό τα κυκλοφορείτε με διαφορετικό τρόπο.
Μια δεξιότητα manifest, μια τυποποιημένη γραμμή στο skills[] του πρόσθετού σας, διατίθεται μαζί με το πρόσθετο και περνά από την ίδια προώθηση με το υπόλοιπο. Η ενσωμάτωση συγχρονίζει ολόκληρο το σύνολο δεξιοτήτων με το μητρώο σε κάθε έκδοση. Αν αφήσετε μια δεξιότητα εκτός του συνόλου, απενεργοποιείται, και στο Enterprise ένας συγχρονισμός με μία προβληματική δεξιότητα δεν εφαρμόζει καμία από αυτές, ώστε να συνεχίζει να εκτελείται η προηγούμενη έκδοση αντί για τη μισή νέα.
Μια δεξιότητα του Skills Engine δημοσιεύεται από τη βιβλιοθήκη. Στο Enterprise, μια δεξιότητα που προσθέτει εργαλείο εγγραφής περιμένει δύο κατονομαζόμενα πρόσωπα να την εγκρίνουν με τα passkeys τους, και αυτός που την προτείνει δεν μπορεί να είναι ένα από αυτά. Μια εγκεκριμένη έκδοση εκτελείται στη συνέχεια σε λειτουργία shadow, έπειτα σε canary για μία μονάδα πίσω από κατονομαζόμενες πύλες, έπειτα για όλους, και διακόπτεται από μόνη της εάν δεν ικανοποιείται μια πύλη. Εάν το plugin σας και μια δεξιότητα του Skills Engine εξαρτώνται το ένα από το άλλο, δημοσιεύστε πρώτα τη δεξιότητα και αφήστε τη να φτάσει σε όλους πριν η έκδοση του plugin που την καλεί βγει από την πιλοτική φάση.
Κανάλια και εγκαταστάσεις
Μόλις μια έκδοση περάσει την πιλοτική φάση και φτάσει σε όλες τις μονάδες, προσφέρεται σε ένα κανάλι, και κάθε μονάδα επιλέγει το κανάλι της. Ο διαχειριστής της συναινεί σε κάθε μετακίνηση. Η σελίδα Κανάλια και εγκαταστάσεις δείχνει ποιες μονάδες εκτελούν ποια έκδοση, με τα ποσοστά σφαλμάτων μόνο ως αριθμούς: βλέπετε πώς συμπεριφέρεται η επέκτασή σας, ποτέ τι έκανε κάποιος με αυτήν.
Το plugin carrier-sync μας εκτελεί τρεις εκδόσεις ταυτόχρονα, και αυτό είναι φυσιολογικό. Οι περισσότερες μονάδες βρίσκονται στην τρέχουσα έκδοση, μία μονάδα παραμένει σε παλαιότερη έκδοση σε ένα κανάλι που διατηρείται έως μια δηλωμένη ημερομηνία, και μια υποψήφια έκδοση βρίσκεται σε ένα κανάλι που δεν έχει επιλέξει ακόμη κανείς. Μην το πολεμάτε· μια μονάδα που χρειάζεται σταθερότητα για έναν έλεγχο δικαιούται να την έχει.
Τα αρχεία καταγραφής και οι μετρήσεις της επέκτασής σας
Η σελίδα αρχείων καταγραφής και μετρήσεων του πακέτου σας περιορίζεται στα δικά σας φορτία εργασίας, στις μονάδες όπου επιτρέπεται να έχετε πρόσβαση. Μπορείτε να φιλτράρετε ανά μονάδα και περιβάλλον, και βλέπετε αριθμούς, χρόνους και καταστάσεις.
Τα προσωπικά πεδία αντικαθίστανται πριν γραφτεί μια γραμμή, και το περιεχόμενο πελατών, όπως κείμενο αξιώσεων, αλληλογραφία ή περιεχόμενο εγγράφων, δεν γράφεται ποτέ στα αρχεία καταγραφής. Τα αρχεία καταγραφής διατηρούνται 14 ημέρες. Ο οργανισμός ορίζεται από την πύλη, ποτέ από το ερώτημά σας, οπότε ένα ερώτημα που κατονομάζει άλλον οργανισμό απορρίπτεται με TENANT_BOUNDARY. Ο βοηθός στην εργαλειοθήκη μπορεί να διαβάσει τα ίδια αρχεία καταγραφής μαζί σας, και μόνο αυτά: όταν τον ρώτησα γιατί οι εγγραφές αποκλίσεων έφτασαν με καθυστέρηση ένα πρωί, εντόπισε ότι 18 λεπτά επαναλήψεων οφείλονταν σε διπλότυπες μετρήσεις από την τροφοδοσία ρεύματος μιας αποβάθρας.
Επαναφορά
Υπάρχουν δύο είδη επαναφοράς, και αμφότερα είναι αλλαγές που υπόκεινται σε έλεγχο και όχι διακόπτες.
Η επαναφορά ενός περιβάλλοντος χρησιμοποιεί την προηγούμενη έκδοση. Κάθε περιβάλλον τη διατηρεί για 30 ημέρες. Η επαναφορά προετοιμάζεται ως αλλαγή στην έκδοση, παρουσιάζει εκ των προτέρων τι θα κάνει και απαιτεί δεύτερο πρόσωπο· μόλις εγκριθεί, η διοχέτευση εκτελεί την επαναφορά σε περίπου ένα λεπτό. Κάθε επαναφορά χρονομετρείται, όπως και κάθε άσκηση, οπότε εξασκηθείτε σε μία πριν τη χρειαστείτε. Η επαναφορά μίας μονάδας χρησιμοποιεί τη σελίδα Κανάλια και εγκαταστάσεις. Το παράθυρο επαναφοράς αναφέρει τι αλλάζει (η μονάδα εκτελεί ξανά την παλαιότερη έκδοση και το ποσοστό σφαλμάτων της παρακολουθείται για μία ώρα), τι παραμένει (οι άλλες μονάδες, καθώς και οι ρυθμίσεις και οι εγγραφές της μονάδας), την αιτία και ποιο είναι το δεύτερο πρόσωπο: ο διαχειριστής της συγκεκριμένης μονάδας.
Οι ρυθμίσεις και οι εγγραφές διατηρούνται κατά την επαναφορά, οπότε σχεδιάζετε κάθε έκδοση με την παραδοχή ότι η προηγούμενη έκδοση ενδέχεται να εκτελεστεί ξανά στα δεδομένα που έγραψε η νεότερη. Αυτός είναι ο πρακτικός λόγος για να διατηρείτε τις μεταβιβάσεις αθροιστικές μέσα σε μια έκδοση που ενδέχεται να επαναφέρετε, και ο λόγος για τον οποίο ζητάμε από δύο πρόσωπα να εγκρίνουν την καθεμία. Το ίδιο ισχύει για μια αλλαγή μοντέλου: ένας ελεγκτής μπορεί, και πρέπει, να ζητήσει το σχέδιο επαναφοράς ενός αιτήματος αλλαγής γράφου πριν το εγκρίνει.
Οι δεξιότητες επαναφέρονται πιο ήπια. Η μετακίνηση της ετικέτας live πίσω σε προηγούμενη έκδοση είναι ένα βήμα, και οι εκτελέσεις που βρίσκονται ήδη σε εξέλιξη ολοκληρώνονται στην έκδοση με την οποία ξεκίνησαν.
Απόσυρση μιας έκδοσης
Μια έκδοση, μόλις δημιουργηθεί, δεν τροποποιείται ποτέ. Μια έκδοση που δεν πρέπει πλέον να χρησιμοποιείται αποσύρεται, και μια διόρθωση κυκλοφορεί ως νέος αριθμός έκδοσης. Τα ίδια τα κανάλια εκδόσεων του SDK ακολουθούν την ίδια πρακτική: μια προβληματική έκδοση του SDK αποσύρεται, ποτέ δεν αντικαθίσταται με διαφορετικό περιεχόμενο υπό τον ίδιο αριθμό. Αντιγράψτε την, διότι ένας αριθμός έκδοσης που μπορεί να σημαίνει δύο διαφορετικές εκδόσεις κώδικα καθιστά κάθε τεκμήριο σχετικά με αυτόν άνευ αξίας.
Η απόσυρση ενός plugin ή πακέτου σταματά τις νέες εγκαταστάσεις. Οι μονάδες διατηρούν την έκδοση που εκτελούν μέχρι να μετακινηθούν, οπότε η απόσυρση είναι σήμα και προθεσμία, όχι διακόπτης απενεργοποίησης. Ενημερώστε τους διαχειριστές των μονάδων σε ποια έκδοση να μετακινηθούν και έως πότε.
Η κατάργηση μιας δεξιότητας ακολουθεί την ίδια λογική με ένα επιπλέον βήμα. Το Skills Engine μετακινεί κάθε εναπομείναντα καλούντα σε μια αντικατάσταση αφού εκτελέσει τις περιπτώσεις της αντικατάστασης, σταματά τις νέες εκτελέσεις και διατηρεί τις εκδόσεις, τις περιπτώσεις και τις σφραγισμένες εγγραφές εκτελέσεων, ώστε η δεξιότητα να μπορεί να επανέλθει εάν η αντικατάσταση αποδειχθεί λανθασμένη.
Λίστα ελέγχου κυκλοφορίας
Αυτή είναι η λίστα που διαβάζουμε πριν από κάθε έκδοση του Cold chain. Είναι σύντομη, επειδή η πλατφόρμα ελέγχει τα περισσότερα για εμάς.
- Οι εκδόσεις συμφωνούν: το manifest, το
pack.jsonκαι το μοντέλο γνώσης, εάν άλλαξε. - Κάθε πύλη είναι πράσινη τοπικά, από καθαρή κατάσταση, και κάθε νέο τεστ αποδείχθηκε ότι αποτυγχάνει πρώτα.
- Η σελίδα Manifest και δικαιώματα δεν δείχνει καμία διεύρυνση, ή η διεύρυνση είναι αυτή που επιδιώκαμε και οι ελεγκτές γνωρίζουν τον λόγο.
- Κάθε μεταβίβαση είναι ένα νέο αριθμημένο αρχείο, με καθορισμένο εύρος, και εφαρμόζεται χωρίς σφάλματα σε μια προσωρινή βάση δεδομένων.
- Το
scripts/ci/required-envπαραθέτει κάθε μεταβλητή που χρειάζεται η υπηρεσία, και η ανάπτυξη ορίζει την καθεμία. - Το σχέδιο επαναφοράς είναι γραμμένο στην αλλαγή, συμπεριλαμβανομένης οποιασδήποτε αλλαγής μοντέλου.
- Δύο ελεγκτές που δεν είναι ο συντάκτης είναι διαθέσιμοι αυτή την εβδομάδα.
Το τελευταίο στοιχείο ακούγεται ασήμαντο. Είναι αυτό που έχει καθυστερήσει περισσότερες από τις εκδόσεις μας από όλες τις πύλες μαζί.



