NetBox

Innen: Farkas Attila Wiki
Ugrás a navigációhoz Ugrás a kereséshez

Lásd még: Monitoring (áttekintés) · Zabbix · hogyan köthető össze a NetBox és a Zabbix

Mi az a "Source of Truth" (SoT)?

A Monitoring áttekintő oldalon tárgyalt eszközök (Zabbix, Nagios, Prometheus) mind egy közös dolgot csinálnak: megfigyelik, hogy a hálózat ténylegesen, most éppen milyen állapotban van. A NetBox ehhez képest egy teljesen más kérdésre válaszol: nem azt írja le, hogy "mi van most", hanem azt, hogy minek kellene lennie - ez a Source of Truth (SoT, "az igazság forrása") szerep. A NetBox egy adatbázis (és rá épülő webes felület/API), amiben rögzítjük: milyen eszközök vannak/lesznek a hálózatunkban, milyen interfészekkel, milyen IP-címekkel, melyik rackben, melyik telephelyen.

Ez ugyanaz a "deklaráld a kívánt állapotot, aztán léptesd életbe" gondolat, amit a wiki más oldalain (pl. netplan, VyOS commit, Cumulus net commit - lásd itt) egy-egy eszközön belül már megismertünk - a NetBox ugyanezt az elvet emeli az egész hálózatra, egyetlen, központi adatbázisként.

Története

A NetBox-ot Jeremy Stretch fejlesztette a DigitalOcean-nél, első nyilvános kiadása 2016-ból való - Python/Django alapokon, PostgreSQL-adatbázissal. Azóta a NetBox Labs (a DigitalOcean-től önállósult csapat) gondozza, és mára a hálózat-automatizálási közösség de-facto SoT-szabványa lett.

Fő modulok

Modul Mit tartalmaz
DCIM (DataCenter Infrastructure Management) Telephelyek, rackek, gyártók/eszköztípusok, konkrét eszközök, interfészeik, a köztük lévő fizikai kábelezés
IPAM (IP Address Management) IP-prefixek, egyedi IP-címek, VLAN-ok, VRF-ek, AS-számok
Circuits Külső (ISP/WAN) áramkörök, szolgáltatókkal és szerződés-adatokkal
Virtualization Virtuális gépek, klaszterek
Tenancy Több ügyfél/szervezeti egység elkülönítése ugyanazon a NetBox-példányon belül

Fontos: a NetBox soha nem nyúl élő eszközhöz

Ahogy a Grafana önmagában nem mér semmit, a NetBox önmagában nem konfigurál és nem is monitoroz semmit - pusztán egy adatbázis arról, aminek lennie kellene. A tényleges munkát mindig más eszközök végzik, amik a NetBox adatait olvassák (API-n keresztül), majd ez alapján cselekszenek - pl. Ansible-lel konfigurációt generálnak és osztanak ki (lásd a kapcsolódó oldalon a részletes példát), vagy - fordított irányban - egy monitoring-rendszer host-listáját tartják szinkronban a NetBox-ban rögzített eszközökkel.

Bővíthetőség és integráció

  • REST API és GraphQL API - gyakorlatilag minden adat géppel is lekérdezhető/írható, nem csak a webes felületen keresztül
  • pynetbox - hivatalos Python-kliens az API-hoz
  • Webhooks - a NetBox HTTP-hívást tud küldeni egy általunk megadott címre, valahányszor egy adat (pl. egy eszköz) létrejön/módosul/törlődik - erre épül pl. a Zabbix-szal való összekötés
  • Custom Scripts - a NetBox felületéről indítható, a NetBox saját adatain dolgozó Python-szkriptek
  • netbox.netbox Ansible-gyűjtemény, benne az nb_inventory dinamikus inventory-pluginnal - így egy Ansible-playbook a hoszt-listáját közvetlenül a NetBox-ból is lekérheti, nem csak egy statikus fájlból

Sajátosságai (összefoglalva)

  • Nem monitoring-eszköz - a "mi kellene hogy legyen" (SoT), nem a "mi van most" kérdésre válaszol.
  • A DCIM+IPAM kombináció miatt egyszerre kezeli a fizikai (rack, kábelezés) és logikai (IP, VLAN) hálózati adatokat.
  • Az értékét elsősorban az adja, hogy más eszközök automatizáltan olvassák - önmagában "csak" egy jól strukturált adatbázis/nyilvántartás.
  • Lásd a kapcsolódó, gyakorlati oldalon, hogyan lehet ebből ténylegesen router-konfigurációt generálni és kiosztani, illetve hogyan tartható szinkronban vele egy Zabbix-telepítés host-listája.