Com mantenir llegible un pla d'adreces IPv6 VPN un any després
Un pla llegible diu quin prefix pertany a quin lloc i com tornen les respostes. Anoteu papers, notació, delegació i rutes de tornada al costat de cada entrada.
Dues preguntes decideixen si un pla d'adreces es guanya el lloc: quin prefix pertany a quin lloc i com surt una resposta d'aquell lloc. Responeu les dues d'una tirada i qui manté el sistema podrà canviar un parell sense interrogar ningú. Tota la resta del document existeix per donar suport a aquestes dues respostes. El que no en dona suport a cap és decoració.
Què ha de respondre un lector abans de tocar un parell
La compressió fa que les adreces semblin polides, i la polidesa no és estructura. Estructura és saber quin rang ha delegat el proveïdor, quin heu triat vosaltres, quin és un pool de clients i quin se seu darrere d'un lloc.
Escriviu per al col·lega que s'incorpora el trimestre que ve i ha d'afegir un segon lloc. Res a la pàgina li diu d'on ve un prefix si no ho diu l'entrada. Ometeu-ho i el primer canvi es converteix en arqueologia.
Què ha de portar cada línia del pla
Quatre camps fan que una entrada sigui revisable: la longitud del prefix, qui el posseeix, on va el trànsit després i quin component reparteix el valor. Contraposeu-los a la configuració en marxa i qualsevol desacord surt sol. Un salt següent apuntat a un túnel retirat el mes passat sembla incorrecte de seguida en lloc de fondre's amb el fons.
Manteniu els papers en files separades encara que avui dos d'ells comparteixin un prefix. Fusionar-los fa que una separació posterior es llegeixi com una assignació nova i no com una correcció.
| 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 |
On divergeixen el text canònic i la sintaxi de configuració
RFC 5952 fixa una forma textual per a una adreça: minúscules, sense zeros inicials i la sèrie més llarga de grups zero compressada exactament una vegada. Feu-la servir en notes, tiquets i registres de canvis perquè dos documents es comparin sense conversió. Qui troba dues grafies d'una mateixa adreça comença a buscar una diferència que no hi és. La consistència aquí és barata i elimina tota una classe de falses alarmes.
Els fitxers de configuració obeeixen les seves pròpies regles, i no són les regles de llegibilitat. Una adreça amb un port necessita claudàtors encara que l'adreça nua no els necessiti, i copiar d'una nota a un fitxer de configuració perd aquesta distinció sense avisar. Anomeneu la forma que fa servir cada camp, o el pla causarà l'error de transcripció que havia de prevenir.
Dues notacions van bé sempre que cadascuna estigui etiquetada. La barreja sense etiquetar és el que convida l'error.
On apareixen rangs superposats i rutes de tornada que falten
La superposició sobreviu més que altres errors perquè res no sembla malament fins que dos llocs responen pel mateix rang. Etiqueteu el lloc i genereu prefixos locals únics pel procediment documentat en lloc de copiar un exemple.
Una llista de clients no explica mai en quina direcció viatja la resposta. Anoteu el camí de tornada de la passarel·la LAN al costat del rang de parell que porta el túnel, i el registre explica una subxarxa remota que rep peticions i calla. Executeu les comprovacions de sota a la màquina i compareu-les amb l'entrada. Un pla que no concorda amb ip -6 route és un pla que la gent deixa de llegir.
ip -6 route show default
ip -6 route get 2001:db8:2::10
ip -6 addr show dev wg0L'abastabilitat no és autorització, i un prefix mai no implica una política. Escriviu l'accés previst al costat de la ruta a la qual s'aplica. Si no, el lector següent tracta una adreça del pla com a permís per arribar a cada servei que hi ha darrere.
Com sobreviu el pla al tercer lloc
Marqueu cada prefix com a delegat, assignat localment o encaminat d'una altra manera. Per a tot el que es pugui moure, anomeneu el procés que el mou. Després llisteu els registres DNS i les regles de tallafoc que han de canviar a la mateixa finestra, perquè una actualització de prefix que s'atura al router està mig feta.
Després d'un canvi, arribeu a un recurs darrere de cada límit que el canvi hagi tocat abans d'editar el document. Un pla que descriu la xarxa del mes passat és pitjor que cap, perquè la gent s'hi fia. Manteniu les assignacions retirades llistades amb la data en què van desaparèixer perquè ningú no les reemeti per accident. Els secrets queden fora del fitxer; un pla explica la xarxa, no l'obre.
Guardeu el pla on es revisen els canvis, al costat de la configuració que descriu. Un document que ningú no rellegeix es podreix més de pressa que la xarxa que dibuixa.