Συμβατότητα προς τα εμπρός

Τι είναι συμβατό προς τα εμπρός

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

Το μέλλον διαφέρει από τη συμβατότητα προς τα πίσω (όταν το νέο σύστημα υποστηρίζει παλαιούς πελάτες) προς την κατεύθυνση της ευθύνης: σχεδιάζουμε πρωτόκολλα και πελάτες με τέτοιο τρόπο ώστε να «επιβιώνουν» μελλοντικές επεκτάσεις χωρίς συνολική αναβάθμιση ολόκληρου του οικοσυστήματος.

Βασικές αρχές

1. Ανεκτικός αναγνώστης & ανεκτικός συγγραφέας

Ο αναγνώστης αγνοεί άγνωστα πεδία/κεφαλίδες και επιτρέπει νέες τιμές enum με τη σωστή οπισθοδρόμηση.
Ο συγγραφέας δεν στέλνει τίποτα που ο εξυπηρετητής δεν έχει δηλώσει ρητά ως υποστηριζόμενο (δυνατότητες).

2. Διαπραγμάτευση δυνατοτήτων

Ρητή ανταλλαγή δυνατοτήτων (χαρακτηριστικά/εκδόσεις/τύποι μέσων) στο στάδιο της χειραψίας. Ο πελάτης προσαρμόζει τη συμπεριφορά του στην απόκριση του εξυπηρετητή.

3. Προεπιλεγμένη υποβάθμιση

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

4. Σταθερό πυρήνα (MGC)

Η σύμβαση ελάχιστης εγγύησης παραμένει αμετάβλητη. οι καινοτομίες ζουν ως επεκτάσεις.

5. Συμβάσεις σφάλματος στο πλαίσιο του πρωτοκόλλου

Προβλέψιμοι κωδικοί/λόγοι («μη υποστηριζόμενο χαρακτηριστικό», «άγνωστος τύπος πολυμέσων») επιτρέπουν στον πελάτη να επανέλθει αυτόματα σε υποστηριζόμενη λειτουργία.

6. Εκδόσεις χωρίς εκπλήξεις

Διαχωρισμένες κύριες γραμμές. μικρές επεκτάσεις δεν απαιτούν αναβάθμιση διακομιστή/καταναλωτή.

Όπου έχει σημασία

Δημόσιες API με μακροχρόνια ενσωμάτωση (εταίροι, SDK σε εφαρμογές κινητής τηλεφωνίας).
Πλατφόρμες εκδηλώσεων με πολλούς ανεξάρτητους καταναλωτές.
Πελάτες κινητής τηλεφωνίας που ενημερώνουν πιο αργά από το backend.
Edge/IoT, όπου μέρος του στόλου συσκευών σπάνια αναβοσβήνει.

Πρότυπα εφαρμογής ανά στυλ

REST/HTTP

Διαπραγμάτευση:

'Αποδοχή '/τύποι μέσων με παραμέτρους (' εφαρμογή/vnd. παράδειγμα. παραγγελία + json· v = 1· προφίλ = κίνδυνος ").
'Προτιμήστε: συμπεριλάβετε =... "προαιρετικά μπλοκ.
Τίτλος "X-Ικανότητες: risk_score,item_details_v2'.

Συμπεριφορά πελάτη:

Αποστολή αιτήματος σε βασική μορφή, επεκτάσεις - μόνο εάν ο εξυπηρετητής έχει επιβεβαιωμένη ικανότητα (μέσω του τελικού σημείου ΕΠΙΛΟΓΗΣ/desc/μολύβδου).
Όταν το '415/406/501' επανέρχεται αυτόματα σε υποστηριζόμενη μορφή/μέθοδο.
Απόκριση εξυπηρετητή: άγνωστες παράμετροι - αγνοήστε. επιτρέπονται επιπλέον πεδία· σταθερή μορφή σφάλματος ('τύπος/κωδικός/λεπτομέρεια/ίχνος _ id').

gRPC/Protobuf

Σταθερές υπηρεσίες: νέες μέθοδοι/πεδία - πρόσθετα· ο παλαιός διακομιστής αγνοεί αθόρυβα άγνωστα πεδία αιτήσεων.
Ανακάλυψη χαρακτηριστικών: Η μέθοδος 'GetPactives ()' επιστρέφει καταλόγους χαρακτηριστικών/ορίων. Ο πελάτης δεν καλεί τη μέθοδο v2 εκτός εάν το δηλώσει ο εξυπηρετητής.
Ροή: καθορίστε τη σειρά του ελάχιστου συνόλου μηνυμάτων. σημειώνουν νέα «πλαίσια» με επεκτάσεις/τύπους που αγνοεί ο παλιός πελάτης.

GraphQL

Φιλικά προς το μέλλον: νέα πεδία/τύποι εμφανίζονται στον εξυπηρετητή - οι παλιοί πελάτες απλώς δεν τα ζητούν.
Οι εικασίες απαγορεύονται: ο πελάτης πρέπει να διατηρεί το σύστημα (ενδοσκόπηση/κωδικοποίηση) και να μην αποστέλλει άγνωστες οδηγίες/μεταβλητές.
Υποβάθμιση: εάν ο εξυπηρετητής δεν γνωρίζει την οδηγία προσαρμοσμένων/χαρακτηριστικών, ο πελάτης δημιουργεί ένα αίτημα χωρίς αυτό.

Οδηγούμενη από συμβάντα (Kafka/NATS/Pulsar, Avro/JSON/Proto)

ΠΡΟΘΕΣΜΙΑ συμβατότητας του συστήματος στο μητρώο: οι παλαιοί καταναλωτές μπορούν να διαβάζουν μηνύματα γραμμένα από το νέο σύστημα.
Πρόσθετα πεδία με αθέτηση υποχρέωσης: οι νέοι παραγωγοί δεν σπάνε τους παλαιούς καταναλωτές.
Core vs Εμπλουτισμένος: ο πυρήνας παραμένει ο ίδιος, οι νέες πληροφορίες δημοσιεύονται σε «.εμπλουτισμένα» ή ως προαιρετικά πεδία.

Πρακτικές σχεδιασμού

1. Σύμβαση ελάχιστης ζήτησης (MGC)

Η λειτουργία θα πρέπει να έχει ένα «στενό λαιμό» που όλοι οι εξυπηρετητές θα υποστηρίζουν για πολλά χρόνια.

2. Σημαίες χαρακτηριστικών σε επίπεδο σύμβασης

Περιγράψτε τα χαρακτηριστικά ως ονομαστικά χαρακτηριστικά: 'risk _ score', 'pricing _ v2', 'strong _ idempotency'. Ο πελάτης τις περιλαμβάνει ρητά.

3. Σαφείς κωδικοί σφάλματος για το «μη υποστηριζόμενο»

HTTP: '501 Not Applied', '415 Unsported Media Type', детальные 'problem + json'.
gRPC: 'UNIMPLEMENTED '/' FAILED _ PREDITION'.
Εκδηλώσεις: διαδρομή σε DLQ με 'reason = μη υποστηριζόμενη _ feature'.

4. Μη βασίζεστε σε καταλόγους εντολών/πλήρων

Ο πελάτης πρέπει να είναι έτοιμος για νέες τιμές enum, χωρίς νέα πεδία και «πρόσθετες» ιδιότητες.

5. Σταθερά αναγνωριστικά και μορφότυπα

Μην αλλάξετε τη μορφή των κλειδιών ID/κατάτμησης εντός της γραμμής - αυτό σπάει προς τα εμπρός στην πλευρά των αναγνωστών.

6. «Αναγνώσιμη από μηχάνημα» τεκμηρίωση

Περιγραφές υποδοχής: OpenAPI/AsyncAPI/Proto περιγραφές/GraphQL SDL. Οι πελάτες μπορούν να επαληθεύσουν την υποστήριξη για το χαρακτηριστικό.

Δοκιμή συμβατότητας προς τα εμπρός

Schema-diff σε λειτουργία FORWARD/FULL: το νέο σχήμα επικυρώνει τον παλιό καταναλωτή/εξυπηρετητή.
Δοκιμές συμβάσεων πελατών: Ένας νέος πελάτης εκτελείται έναντι ενός παλιού διακομιστή με ενεργοποιημένα/απενεργοποιημένα χαρακτηριστικά.
Χρυσά αιτήματα: ένα σύνολο «νέων» αιτημάτων εκτελείται μέσω του «παλαιού» εξυπηρετητή. αναμενόμενη υποβάθμιση χωρίς κρίσιμα σφάλματα.
Χάος/καθυστέρηση: timeout/retray check - ο νέος πελάτης πρέπει να επιβιώσει σωστά από τις χειρότερες SLA του παλιού εξυπηρετητή.
Κανάριος: μερικοί από τους νέους πελάτες δουλεύουν με την προηγούμενη έκδοση του διακομιστή - συλλέγουμε τηλεμετρία σφαλμάτων/υποβάθμισης.

Παρατηρησιμότητα και λειτουργικές μετρήσεις

Το ποσοστό αιτήσεων/μηνυμάτων με μη υποστηριζόμενα χαρακτηριστικά και οι αυτόματες ανατροπές τους.
Διανομή ανά έκδοση πελάτη (πράκτορας/μεταδεδομένα/απαιτήσεις).
'UNIMPLEMENTED/501/415' λάθη και διαδρομές σε DLQ με 'μη υποστηριζόμενο _ χαρακτηριστικό'.
Χρόνος αποικοδόμησης: p95/p99 για MGC έναντι «παρατεταμένης» απόκρισης.

Τρόποι συμβατότητας στο μητρώο σχήματος

FORWARD: η νέα καταχώριση είναι συμβατή με τον παλαιό αναγνώστη (απαιτούνται προεπιλογές, προαιρετικότητα).
FULL: и ΠΡΩ, и ΟΠΙΣΘΟΔΡΟΜΟΣ. βολικό για δημόσιες συμβάσεις.
Σύσταση: για εκδηλώσεις - BACKWARD για τον παραγωγό και FORWARD για τον καταναλωτή (μέσω ενός ανεκτικού αναγνώστη), για εξωτερικές API - FULL.

Παραδείγματα

REST (ικανότητες + υποβάθμιση)

1. Ο πελάτης κάνει 'GET/meta/ικανότητες' → '{"risk _ score": false, "price_v2": true}'.
2. Στο 'POST/παραγγελίες' αποστέλλονται βασικά πεδία. «risk _ score» δεν ζητά, επειδή ο διακομιστής δεν μπορεί να το κάνει.
3. Αν κατά λάθος αποσταλεί 'Προτιμήστε: συμπεριλάβετε = risk _ score', ο εξυπηρετητής απαντά με 200 χωρίς το πεδίο 'risk _ score' (ή 'Preference-Applied: no') - ο πελάτης δεν συντρίβεται.

gRPC (ανακάλυψη)

'GetPactives ()' returned method list/feature. Ο πελάτης δεν καλεί το 'CaptureV2' αν δεν υπάρχει - αντ 'αυτού χρησιμοποιώντας το' Capture 'και μετατρέποντας τοπικά την είσοδο σε υποστηριζόμενη προβολή.

Γεγονότα (ΠΡΟΘΕΣΜΙΑ στο μητρώο)

Ο παραγωγός πρόσθεσε το πεδίο «risk _ score» (ακυρώσιμο εξ ορισμού). Ο παλιός καταναλωτής τον αγνοεί. η λογική του χρησιμοποιεί μόνο σταθερά πεδία πυρήνα.

Αντιπατερίδια

Σκληρός πελάτης: φιλτράρει την απόκριση από λευκά πεδία και πέφτει σε άγνωστη ιδιοκτησία.
Έμμεσα χαρακτηριστικά: Ο πελάτης αρχίζει να στέλνει μια νέα παράμετρο χωρίς να ελέγχει τις δυνατότητες.
Αλλαγή ταυτότητας/μορφότυπου κλειδιού εντός της γραμμής → οι παλαιοί διακομιστές/καταναλωτές δεν κατανοούν πλέον νέα αιτήματα/μηνύματα.
Hardwired υποθέσεις σχετικά με την πλήρη λίστα enum (διακόπτη χωρίς προεπιλογή).
Καταγραφή ως έλεγχος ροής: συμβολοσειρές σφάλματος ανάλυσης αντί των κωδικών σύμβασης.

Κατάλογος ελέγχου εφαρμογής

Προσδιορισμός MGC. τα νέα χαρακτηριστικά επισημαίνονται ως προαιρετικά.
Περιγράφεται και υλοποιείται η διαπραγμάτευση δυνατοτήτων (τελικό σημείο/μεταδεδομένα/χειραψία).
Οι πελάτες αγνοούν άγνωστα πεδία και χειρίζονται σωστά νέο enum (εφεδρικό).
Οι συμβάσεις σφάλματος αποτυπώνουν «μη υποστηριζόμενα» προβλέψιμα (HTTP/gRPC/Event).
Το μητρώο σχήματος έχει οριστεί στο FORWARD/FULL για τα αντίστοιχα τεχνουργήματα.
Autotests: schema-diff (FORWARD), πελάτης έναντι παλαιών δοκιμών σύμβασης διακομιστή, καναρίνι.
Μετρήσεις: έκδοση πελάτη, αποτυχία χαρακτηριστικών, ρυθμός υποβάθμισης, p95 MGC.
Η τεκμηρίωση/SDK δημοσιεύει κατάλογο χαρακτηριστικών και παραδειγμάτων υποβάθμισης.

ΣΥΧΝΈΣ ΕΡΩΤΉΣΕΙΣ

Πώς διαφέρει η πρόοδος από την καθυστέρηση στην πράξη

Πίσω: ο νέος διακομιστής δεν σπάει τους παλιούς πελάτες. Προς τα εμπρός: ο παλαιός διακομιστής δεν αποσπάται από νέους πελάτες (ή ο παλαιός καταναλωτής από νέα μηνύματα). Ιδανικά, φτάνεις στο πλήρες.

Χρειάζεται πάντα να μπω σε δυνατότητες

Αν περιμένετε ενεργό εξέλιξη χωρίς συγχρονισμένες κυκλοφορίες, ναι. Είναι φθηνότερο από το να κρατάς δεκάδες μεγάλες γραμμές.

Τι γίνεται με την ασφάλεια

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

Είναι δυνατόν να «μαντέψετε» την υποστήριξη από την έκδοση του διακομιστή

Ανεπιθύμητες ενέργειες. Είναι προτιμότερο να ζητείται ρητά (δυνατότητες) ή να εξετάζεται το είδος/το σχήμα των μέσων ενημέρωσης.

Σύνολο

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