Πώς να κρατήσετε ένα σχέδιο διευθύνσεων IPv6 VPN αναγνώσιμο ένα χρόνο αργότερα
Ένα αναγνώσιμο σχέδιο λέει ποιο πρόθεμα ανήκει σε ποιον χώρο και πώς επιστρέφουν οι απαντήσεις. Καταγράψτε ρόλους, συμβολισμό, ανάθεση και διαδρομές επιστροφής δίπλα σε κάθε εγγραφή.
Δύο ερωτήσεις κρίνουν αν ένα σχέδιο διευθύνσεων αξίζει τη θέση του: ποιο πρόθεμα ανήκει σε ποιον χώρο και πώς μια απάντηση βγαίνει πίσω από αυτόν τον χώρο. Απαντήστε και στις δύο με μία κίνηση και ένας συντηρητής μπορεί να αλλάξει έναν ομότιμο χωρίς να ανακρίνει κανέναν. Όλα τα άλλα στο έγγραφο υπάρχουν για να στηρίξουν αυτές τις δύο απαντήσεις. Ό,τι δεν στηρίζει καμία από τις δύο είναι διακόσμηση.
Τι πρέπει να απαντήσει ένας αναγνώστης πριν αγγίξει έναν ομότιμο
Η συμπίεση κάνει τις διευθύνσεις να φαίνονται τακτοποιημένες, και η τακτοποίηση δεν είναι δομή. Δομή είναι να ξέρεις ποιο εύρος ανέθεσε ο πάροχος, ποιο διάλεξες εσύ, ποιο είναι δεξαμενή πελατών και ποιο κάθεται πίσω από έναν χώρο.
Γράψε για τον συνάδελφο που έρχεται το επόμενο τρίμηνο και πρέπει να προσθέσει δεύτερο χώρο. Τίποτα στη σελίδα δεν του λέει από πού ήρθε ένα πρόθεμα αν δεν το κάνει η εγγραφή. Παράλειψέ το και η πρώτη αλλαγή γίνεται αρχαιολογία.
Τι πρέπει να φέρει κάθε γραμμή του σχεδίου
Τέσσερα πεδία κάνουν μια εγγραφή ελέγξιμη: πόσο μακρύ είναι το πρόθεμα, ποιος το κατέχει, πού πάει μετά η κίνηση και ποιο στοιχείο παραδίδει την τιμή. Βάλ' τα δίπλα στη ρέουσα διαμόρφωση και κάθε ασυμφωνία αναδύεται μόνη της. Ένα επόμενο άλμα προς σήραγγα που αφαιρέθηκε τον περασμένο μήνα φαίνεται λάθος αμέσως αντί να σμίγει με το φόντο.
Κράτα τους ρόλους σε χωριστές σειρές ακόμη κι όταν δύο από αυτούς μοιράζονται σήμερα ένα πρόθεμα. Η συγχώνευσή τους κάνει έναν μεταγενέστερο διαχωρισμό να διαβάζεται σαν νέα κατανομή και όχι σαν διόρθωση.
| Entry | Fields to record | Why a reviewer needs it |
|---|---|---|
| Endpoint addresses | Prefix, owning side, session initiator | Firewall rules and peer config both read it |
| Tunnel interfaces | Prefix and length, next hop, interface name | Shows the path a packet actually takes |
| Client allocations | Pool range, size, distributing component | Shows room left before a redesign |
| Downstream networks | Prefix, site label, return route | Explains a reply that never arrives |
Πού αποκλίνουν το κανονικό κείμενο και η σύνταξη διαμόρφωσης
Το RFC 5952 καθορίζει μία μορφή κειμένου για μια διεύθυνση: πεζά, χωρίς αρχικά μηδενικά και η μεγαλύτερη σειρά μηδενικών ομάδων συμπιεσμένη ακριβώς μία φορά. Χρησιμοποίησέ την σε σημειώσεις, δελτία και αρχεία αλλαγών ώστε δύο έγγραφα να συγκρίνονται χωρίς μετατροπή. Ο αναγνώστης που συναντά δύο ορθογραφίες της ίδιας διεύθυνσης αρχίζει να ψάχνει μια διαφορά που δεν υπάρχει. Η συνέπεια εδώ είναι φτηνή και αφαιρεί μια ολόκληρη κατηγορία ψευδών συναγερμών.
Τα αρχεία διαμόρφωσης υπακούουν σε δικούς τους κανόνες, και δεν είναι οι κανόνες αναγνωσιμότητας. Μια διεύθυνση με θύρα χρειάζεται αγκύλες ακόμη κι όταν η γυμνή διεύθυνση δεν χρειάζεται, και ένα αντίγραφο από σημείωση σε αρχείο διαμόρφωσης χάνει αυτή τη διάκριση χωρίς προειδοποίηση. Ονόμασε τη μορφή που χρησιμοποιεί κάθε πεδίο, αλλιώς το σχέδιο προκαλεί το σφάλμα αντιγραφής που έπρεπε να αποτρέψει.
Δύο συμβολισμοί είναι εντάξει αρκεί ο καθένας να επισημαίνεται. Η ανάμειξη χωρίς σήμανση είναι αυτή που προσκαλεί το λάθος.
Πού εμφανίζονται επικαλυπτόμενα εύρη και διαδρομές επιστροφής που λείπουν
Η επικάλυψη επιβιώνει άλλων λαθών γιατί τίποτα δεν φαίνεται λάθος μέχρι δύο χώροι να απαντήσουν για το ίδιο εύρος. Σημείωσε τον χώρο και δημιούργησε μοναδικά τοπικά προθέματα με τη τεκμηριωμένη διαδικασία αντί να αντιγράψεις ένα παράδειγμα.
Μια λίστα πελατών δεν εξηγεί ποτέ προς ποια κατεύθυνση ταξιδεύει η απάντηση. Κατέγραψε την επιστροφή της πύλης LAN δίπλα στο εύρος ομοτίμου που μεταφέρει η σήραγγα, και η εγγραφή εξηγεί ένα απομακρυσμένο υποδίκτυο που δέχεται αιτήματα και μένει σιωπηλό. Εκτέλεσε τους ελέγχους παρακάτω στο μηχάνημα και σύγκρινέ τους με την εγγραφή. Ένα σχέδιο που διαφωνεί με το ip -6 route είναι σχέδιο που ο κόσμος σταματά να διαβάζει.
ip -6 route show default
ip -6 route get 2001:db8:2::10
ip -6 addr show dev wg0Η προσβασιμότητα δεν είναι εξουσιοδότηση, και ένα πρόθεμα δεν συνεπάγεται ποτέ πολιτική. Γράψε την προβλεπόμενη πρόσβαση δίπλα στη διαδρομή στην οποία εφαρμόζεται. Αλλιώς ο επόμενος αναγνώστης θεωρεί μια διεύθυνση στο σχέδιο άδεια να φτάσει κάθε υπηρεσία πίσω της.
Πώς το σχέδιο επιβιώνει στον τρίτο χώρο
Σημείωσε κάθε πρόθεμα ως ανατεθειμένο, τοπικά εκχωρημένο ή δρομολογημένο με άλλο τρόπο. Για ό,τι μπορεί να μετακινηθεί, ονόμασε τη διαδικασία που το μετακινεί. Έπειτα απαρίθμησε τις εγγραφές DNS και τους κανόνες τείχους προστασίας που πρέπει να αλλάξουν στο ίδιο παράθυρο, γιατί μια ενημέρωση προθέματος που σταματά στον δρομολογητή είναι μισοτελειωμένη.
Μετά από μια αλλαγή, φτάσε σε έναν πόρο πίσω από κάθε όριο που άγγιξε η αλλαγή πριν επεξεργαστείς το έγγραφο. Ένα σχέδιο που περιγράφει το δίκτυο του περασμένου μήνα είναι χειρότερο από κανένα, αφού ο κόσμος το εμπιστεύεται. Κράτα τις ανακλημένες εκχωρήσεις στη λίστα με την ημερομηνία που έφυγαν ώστε κανείς να μην τις επανεκδώσει κατά λάθος. Τα μυστικά μένουν έξω από το αρχείο· ένα σχέδιο εξηγεί το δίκτυο, δεν το ανοίγει.
Αποθήκευσε το σχέδιο εκεί όπου οι αλλαγές ελέγχονται, δίπλα στη διαμόρφωση που περιγράφει. Ένα έγγραφο που κανείς δεν ξαναδιαβάζει σαπίζει γρηγορότερα από το δίκτυο που χαρτογραφεί.