Miten IPv6-VPN:n osoitesuunnitelma pysyy luettavana vuoden päästä
Luettava suunnitelma kertoo, mikä etuliite kuuluu millekin sivustolle ja miten vastaukset palaavat. Kirjaa roolit, merkintätapa, delegointi ja paluureitit jokaisen merkinnän viereen.
Kaksi kysymystä ratkaisee, ansaitseeko osoitesuunnitelma paikkansa: mikä etuliite kuuluu millekin sivustolle ja miten vastaus pääsee ulos siltä sivustolta. Vastaa molempiin yhdellä kertaa, niin ylläpitäjä voi vaihtaa vertaiskohdetta ketään kuulustelematta. Kaikki muu asiakirjassa on olemassa näiden kahden vastauksen tukemiseksi. Se mikä ei tue kumpaakaan, on koristelua.
Mihin lukijan on vastattava ennen kuin koskee vertaiskohteeseen
Pakkaaminen saa osoitteet näyttämään siisteiltä, eikä siisteys ole rakennetta. Rakenne on sitä, että tietää minkä alueen palveluntarjoaja delegoi, minkä sinä valitsit, mikä on asiakaspooli ja mikä on sivuston takana.
Kirjoita kollegalle, joka liittyy seuraavalla neljänneksellä ja joutuu lisäämään toisen sivuston. Mikään sivulla ei kerro hänelle, mistä etuliite tuli, ellei merkintä kerro. Jätä se tekemättä, niin ensimmäinen muutos muuttuu arkeologiaksi.
Mitä suunnitelman jokaisen rivin on kannettava
Neljä kenttää tekee merkinnästä tarkistettavan: etuliitteen pituus, sen omistaja, minne liikenne menee seuraavaksi ja mikä komponentti jakaa arvon. Vertaa niitä käynnissä olevaan kokoonpanoon, niin ristiriita paljastuu itsestään. Viime kuussa poistettuun tunneliin osoittava seuraava hyppy näyttää heti väärältä sen sijaan että sulautuisi joukkoon.
Pidä roolit eri riveillä, vaikka kaksi niistä jakaisi etuliitteen tänään. Niiden yhdistäminen tekee myöhemmästä erottelusta uudelleenjaon näköisen, ei korjauksen.
| 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 |
Missä kanoninen teksti ja kokoonpanon syntaksi eroavat
RFC 5952 kiinnittää osoitteelle yhden tekstimuodon: pienet kirjaimet, ei etunollia ja pisin nollaryhmien sarja pakattuna täsmälleen kerran. Käytä sitä muistiinpanoissa, tiketeissä ja muutoskirjauksissa, jotta kaksi asiakirjaa vertautuu ilman muuntoa. Lukijat, jotka kohtaavat yhden osoitteen kaksi kirjoitusasua, alkavat etsiä eroa jota ei ole. Johdonmukaisuus on tässä halpaa ja poistaa kokonaisen luokan väärähälytyksiä.
Kokoonpanotiedostot noudattavat omia sääntöjä, eivätkä ne ole luettavuussääntöjä. Portin kanssa pariin liitetty osoite tarvitsee hakasulut, vaikka paljas osoite ei tarvitsisi, ja kopiointi muistiinpanosta kokoonpanotiedostoon kadottaa tämän eron varoittamatta. Nimeä muoto, jota kukin kenttä käyttää, tai suunnitelma aiheuttaa juuri sen siirtovirheen, jonka se oli tarkoitettu estämään.
Kaksi merkintätapaa käy, kunhan kumpikin on merkitty. Merkitsemätön sekoittaminen juuri kutsuu virheen.
Missä päällekkäiset alueet ja puuttuvat paluupolut näkyvät
Päällekkäisyys elää muita virheitä pidempään, koska mikään ei näytä väärältä ennen kuin kaksi sivustoa vastaa samasta alueesta. Merkitse sivusto ja luo paikalliset yksilölliset etuliitteet dokumentoidulla menettelyllä sen sijaan että kopioit esimerkin.
Asiakasluettelo ei koskaan kerro, mihin suuntaan vastaus kulkee. Kirjaa lähiverkon yhdyskäytävän paluupolku sen vertaisalueen viereen, jota tunneli kuljettaa, niin merkintä selittää etäaliverkon, joka vastaanottaa pyyntöjä ja pysyy vaiti. Aja alla olevat tarkistukset koneella ja vertaa niitä merkintään. Suunnitelma, joka on ristiriidassa ip -6 route kanssa, on suunnitelma jota ihmiset lakkaavat lukemasta.
ip -6 route show default
ip -6 route get 2001:db8:2::10
ip -6 addr show dev wg0Tavoitettavuus ei ole valtuutus, eikä etuliite koskaan merkitse käytäntöä. Kirjoita aiottu pääsy sen reitin viereen, jota se koskee. Muuten seuraava lukija pitää suunnitelman osoitetta lupana päästä kaikkiin sen takana oleviin palveluihin.
Miten suunnitelma selviää kolmannesta sivustosta
Merkitse jokainen etuliite delegoiduksi, paikallisesti osoitetuksi tai muuten reititetyksi. Nimeä prosessi, joka siirtää asian, jos se voi siirtyä. Listaa sitten DNS-tietueet ja palomuurisäännöt, joiden on muututtava samassa ikkunassa, koska reitittimeen pysähtyvä etuliitepäivitys on puoliksi tehty.
Muutoksen jälkeen saavuta resurssi jokaisen muutoksen koskeman rajan takaa ennen kuin muokkaat asiakirjaa. Viime kuun verkkoa kuvaava suunnitelma on huonompi kuin ei mitään, koska ihmiset luottavat siihen. Pidä peruutetut varaukset listattuna sen päivämäärän kanssa, jolloin ne poistuivat, ettei kukaan myönnä niitä uudelleen vahingossa. Salaisuudet pysyvät tiedoston ulkopuolella; suunnitelma selittää verkon, se ei avaa sitä.
Säilytä suunnitelma siellä missä muutokset tarkistetaan, kuvaamansa kokoonpanon vieressä. Asiakirja, jota kukaan ei lue uudelleen, mätänee nopeammin kuin verkko, jonka se kartoittaa.