Plaani väärtuse otsustavad kaks küsimust: milline prefiks kuulub millisele saidile ja kuidas vastus sealt saidilt välja jõuab. Vasta mõlemale ühe hooga ja haldaja saab partnerit muuta ilma kelleltki küsimata. Ülejäänu dokumenti toetab neid kahte vastust. Mis ei toeta kumbagi, on kaunistus.

Millele peab lugeja vastama enne partneri puudutamist

Kokkusurumine teeb aadressid korrapäraseks, kuid korrapärasus ei ole struktuur. Struktuur on teadmine, millise vahemiku teenusepakkuja delegeeris, millise valisid sina, milline on kliendipool ja milline asub saidi taga.

Kirjuta kolleegile, kes liitub järgmisel kvartalil ja peab lisama teise saidi. Midagi lehel ei ütle talle, kust prefiks tuli, kui kirje seda ei tee. Jäta see tegemata ja esimene muudatus muutub arheoloogiaks.

Mida peab plaani iga rida kandma

Neli välja teevad kirje ülevaatatavaks: prefiksi pikkus, omanik, kuhu liiklus järgmisena läheb ja milline komponent väärtuse väljastab. Võrdle neid jookseva konfiguratsiooniga ja iga lahknevus tuleb ise välja. Eelmisel kuul eemaldatud tunnelile osutav järgmine hüpe tundub kohe vale, mitte ei sulandu taustaga.

Hoia rollid eraldi ridades ka siis, kui kaks neist jagavad praegu sama prefiksit. Nende ühendamine muudab hilisema eraldamise millekski, mis loeb nagu uus jaotus, mitte parandus.

EntryFields to recordWhy a reviewer needs it
Endpoint addressesPrefix, owning side, session initiatorFirewall rules and peer config both read it
Tunnel interfacesPrefix and length, next hop, interface nameShows the path a packet actually takes
Client allocationsPool range, size, distributing componentShows room left before a redesign
Downstream networksPrefix, site label, return routeExplains a reply that never arrives

Kus kanoniline tekst ja konfiguratsiooni süntaks lahknevad

RFC 5952 määrab aadressile ühe tekstikuju: väiketähed, nullideta algus ja pikim nullgruppide jada surutud täpselt üks kord kokku. Kasuta seda märkmetes, piletites ja muudatuste kirjetes, et kaks dokumenti võrduksid ilma teisendamiseta. Lugejad, kes kohtavad ühe aadressi kaht kirjaviisi, hakkavad otsima erinevust, mida pole olemas. Järjekindlus on siin odav ja eemaldab terve klassi valehäireid.

Konfiguratsioonifailid järgivad oma reegleid ja need ei ole loetavusreeglid. Pordiga paaris olev aadress vajab nurksulge ka siis, kui paljas aadress ei vaja, ja märkmest konfiguratsioonifaili kopeerimine kaotab selle erinevuse hoiatamata. Nimeta vorm, mida iga väli kasutab, muidu põhjustab plaan transkriptsioonivea, mida pidi ära hoidma.

Kaks märkimisviisi sobivad, kui kumbki on märgistatud. Märgistamata segamine kutsubki vea esile.

Kus tulevad välja kattuvad vahemikud ja puuduvad tagasiteed

Kattumine elab teistest vigadest kauem, sest miski ei tundu valesti enne, kui kaks saiti vastavad sama vahemiku eest. Märgista sait ja genereeri kohalikud unikaalsed prefiksid dokumenteeritud protseduuri järgi, mitte näidet kopeerides.

Kliendinimekiri ei selgita kunagi, mis suunas vastus liigub. Kirjuta LAN-i lüüsi tagasitee selle partnerivahemiku kõrvale, mida tunnel veab, ja kirje selgitab kaugalamsuvõrku, mis saab päringuid ja jääb vait. Käivita allolevad kontrollid masinas ja võrdle neid kirjega. Plaan, mis on vastuolus ip -6 route, on plaan, mida inimesed enam ei loe.

ip -6 route show default
ip -6 route get 2001:db8:2::10
ip -6 addr show dev wg0

Kättesaadavus ei ole volitus ja prefiks ei tähenda kunagi poliitikat. Kirjuta kavatsetud juurdepääs selle marsruudi kõrvale, millele see kehtib. Muidu käsitleb järgmine lugeja plaani aadressi loana jõuda igasse selle taga olevasse teenusesse.

Kuidas plaan kolmanda saidi üle elab

Märgi iga prefiks delegeerituks, kohapeal määratuks või muul viisil marsruudituduks. Kõige jaoks, mis võib liikuda, nimeta protsess, mis seda liigutab. Seejärel loetle DNS-kirjed ja tulemüürireeglid, mis peavad samas aknas muutuma, sest ruuteril peatuv prefiksi uuendus on poolik.

Pärast muudatust jõua ressursini iga muudatuse puudutatud piiri taga enne, kui dokumenti muudad. Plaan, mis kirjeldab eelmise kuu võrku, on hullem kui olematu, sest inimesed usaldavad seda. Hoia tühistatud jaotused loetletud koos kuupäevaga, mil need kadusid, et keegi ei annaks neid kogemata uuesti välja. Saladused hoia failist väljas; plaan selgitab võrku, see ei ava seda.

Hoia plaani seal, kus muudatusi üle vaadatakse, selle konfiguratsiooni kõrval, mida see kirjeldab. Dokument, mida keegi uuesti ei loe, mädaneb kiiremini kui võrk, mida see kaardistab.

Seotud artiklid