Cafodd popeth yn y cofnod hwn ei redeg yn erbyn NetBox 4.7.2 ar fy nesg fy hun, gydag ystad go iawn wedi’i llwytho iddo: un safle, un cabinet, pedair ar ddeg o ddyfeisiau, wedi’u ceblo, wedi’u pweru ac wedi’u cyfeirio ar draws tri chwsmer. Yr achos hwnnw yw pob sgrinlun, a phob neges gwall yw un a ges i go iawn.
Mae’n mynd yn y drefn y byddet ti’n dod ar ei draws. Beth yw’r peth, pam y byddet ti eisiau un, y fforc y byddi di’n clywed amdani o fewn wythnos o chwilio, sut i godi un, y drefn y mae’n rhaid i ti ei lenwi, ac yna beth wyt ti’n ei gael yn ôl allan. Mae’r gwaith addasu ac ymestyn ar y diwedd, achos does dim o hynny’n gwneud synnwyr nes dy fod wedi gweld siâp yr hyn rwyt ti’n ei ymestyn.
Beth Yw NetBox
Cronfa ddata yw NetBox gyda barn benodol iawn am beth mae rhwydwaith wedi’i wneud ohono, a rhaglen we ar ei phen. Rhaglen Django ar PostgreSQL yw hi, mae wedi bod yn ffynhonnell agored dan Apache 2.0 ers i DigitalOcean ei rhyddhau ym Mehefin 2016, a NetBox Labs sy’n stiwardio’r prosiect heddiw ochr yn ochr â thîm o gynhalwyr gwirfoddol.12
Oddi tano mae 149 o fodelau ar draws deg rhaglen, a’u cyrraedd drwy 146 o endpoints REST ac un endpoint GraphQL. Wedi’u cyfrif o’r achos a adeiladais i ar gyfer hyn, nid wedi’u darllen oddi ar dudalen nodweddion:
| Rhaglen | Modelau | Rhaglen | Modelau |
|---|---|---|---|
| dcim | 56 | virtualization | 7 |
| extras | 23 | tenancy | 6 |
| ipam | 18 | wireless | 3 |
| circuits | 11 | users | 7 |
| vpn | 10 | core | 8 |
DCIM yw pump deg chwech o’r rheini, yr haen ffisegol: safleoedd, lleoliadau, raciau, mathau o ddyfais, dyfeisiau, a phob math o borth, bae a therfyniad cebl y gall dyfais ei gael. IPAM yw deunaw. Mae’r gweddill yn cwmpasu cylchedau, twneli a pholisïau IKE, peiriannau rhithwir a chlystyrau, cysylltiadau diwifr, tenantiaeth, a’r peirianwaith sy’n gwneud y cyfan yn estynadwy.
Nid y cyfrif yw’r pwynt. Y cysylltiadau rhwng y tablau yw’r pwynt, a’r ffordd gyflymaf o weld hynny yw’r sgrin y mae NetBox yn fwyaf adnabyddus amdani.
Dechreua gyda’r cabinet, achos dyna’r sgrin sy’n gwerthu’r peth.

Mae’r elevation yna wedi’i lunio o’r data, nid wedi’i lanlwytho. Mae pob dyfais yno achos bod rhywbeth yn dweud ei bod yn llenwi’r unedau rac yna, yn wynebu’r ffordd yna, ac mae’r lliwiau’n dod o’r rôl a roddaist ti iddi. Mae’r defnydd gofod yn darllen 28.6% achos bod NetBox wedi’i gyfrifo. Does neb yn cynnal y rhif yna.
Mae dau beth yn dilyn ohono sy’n werth mwy na’r llun.
Galli di ofyn pa unedau sy’n rhydd, a chael ateb y galli di weithredu arno. Galli di hefyd gadw unedau cyn bod dim wedi’i osod ynddyn nhw, a dyna’r gwahaniaeth rhwng gwerthu gofod sydd gen ti a gwerthu gofod rwyt ti’n meddwl sydd gen ti.
Beth na wnaiff e’n fwriadol
Mae cynnyrch sy’n gwybod beth nad yw e’n brinnach nag un sy’n gwneud popeth yn wael, ac mae dogfennaeth NetBox ei hun yn blwmp ac yn blaen am y peth. Dyw e ddim yn darparu monitro rhwydwaith, gwasanaeth DNS, RADIUS, rheoli cyfluniad na rheoli cyfleusterau.1
Yn bwysicach, mae’n dal cyflwr dymunol dy rwydwaith, nid ei gyflwr gweithredol, ac mae’r ddogfennaeth yn dweud bod mewnforio cyflwr byw y rhwydwaith yn awtomatig yn ‘strongly discouraged’, achos y dylai person fod wedi archwilio pob cofnod yn gyntaf.1
Dyna’r penderfyniad y mae popeth arall yn gorffwys arno, a dyna’r un y mae pobl yn dadlau ag e. Mae’r ddadl yn mynd: siawns y dylai ffynhonnell gwirionedd fod yn wir, felly darganfydda’r rhwydwaith a’i lwytho i mewn. Yr ateb yw bod rhwydwaith wedi’i ddarganfod yn dweud wrthot ti beth sydd yno, ac mae beth sydd yno yn cynnwys pob camgymeriad y mae unrhyw un wedi’i wneud erioed. Mae porth switsh a adawyd yn y VLAN anghywir yn 2021 yn ffaith. Nid bwriad yw e.
NetBox sy’n dal y bwriad. Dy fonitro sy’n dal y realiti. Y rhif diddorol yw’r gwahaniaeth rhyngddyn nhw, a alli di ddim cyfrifo gwahaniaeth o un mewnbwn.
Mae’r egwyddor arall wedi’i datgan yr un mor blaen: o gael dewis rhwng ateb wyth deg y cant cymharol syml ac un cyflawn llawer mwy cymhleth, cymer yr un syml.1 Byddi di’n teimlo hynny’r tro cyntaf y byddi di eisiau modelu rhywbeth nad yw’n ei fodelu, ac mae rhes gyfan o adrannau tua’r diwedd am beth i’w wneud pan fyddi di’n taro hynny.
| Mae NetBox yn | Dyw NetBox ddim yn |
|---|---|
| Cofnodi beth ddylai fod yno | Holi beth sydd yno |
| Dal y VLAN bwriadedig ar gyfer porth | Dweud wrthot ti fod y porth i lawr |
| Dweud i ba gwsmer y mae prefix yn perthyn | Codi tâl arnyn nhw amdano |
| Rendro cyfluniad dyfais o dempled | Ei wthio i’r ddyfais |
| Cofnodi’r gylched, y darparwr a’r ymrwymiad | Monitro’r gylched |
| Dweud ym mha rac y mae dyfais, ac ym mha U | Agor y cabinet |
Darllena’r golofn dde yna fel rhestr o offer sydd eu hangen arnat ti o hyd. Darllena hi’n anghywir a byddi di’n ceisio troi NetBox yn bob un ohonyn nhw, a dyna sut mae ffynhonnell gwirionedd yn troi’n system arall nad oes neb yn ymddiried ynddi.
Pam Mae Angen Un Arnat Ti
Gofynna i ddarparwr gwasanaethau a reolir ble mae cofnod awdurdodol rhwydwaith cwsmer yn byw, a chei di ateb. Gofynna i ddau o’u peirianwyr ar wahân a chei di ddau.
Bydd un yn pwyntio at daenlen. Bydd un yn pwyntio at ddiagram a gadwyd ddiwethaf gan rywun a adawodd yn 2023. Bydd rhywun arall yn dweud mai cyfluniad y wal dân yw’r ddogfennaeth, sydd o leiaf yn onest, achos mae cyfluniad yn disgrifio beth mae bocs yn ei wneud. Dyw e jyst ddim yn disgrifio pam, na phwy ofynnodd amdano, na pha un o’r pedwar cwsmer y tu ôl i’r bocs yna sy’n talu am y rheol.
Nid y diwrnod rwyt ti’n sylwi bod y cofnod yn anghywir yw’r methiant byth. Y diwrnod y mae ar rywun ei angen yw e.
| Y foment | Beth sy’n rhaid i ti ei gynhyrchu | Beth mae’n ei gostio pan na elli di |
|---|---|---|
| Sgwrs adnewyddu | Cyfrif eitemedig o beth mae’r tâl misol yn ei brynu | Mae dyfynbris y cystadleuydd wedi’i eitemeiddio, achos aethon nhw ati i gyfrif |
| Peiriannydd yn rhoi ei rybudd | Popeth roedd yn ei wybod, wedi’i ysgrifennu | Chwe mis o ddarganfod, un tocyn ar y tro |
| Cwsmer yn gadael | Disgrifiad o’i ystad ei hun | Tair wythnos i’w gasglu, a geirda y bydd yn ei roi’n onest |
| Archwilydd yn gofyn cwestiwn cwmpas | Pa systemau sy’n dal data personol, a ble maen nhw’n ffisegol | Rheoleiddiwr wedi cael gwybod rhywbeth sy’n troi allan yn ddiweddarach i fod yn anwir |
| Mudo sydd angen ei brisio | Cyfrif o beth sydd yno go iawn | Rwyt ti’n cynnig ar amcangyfrif ac yn llyncu’r gwahaniaeth |
Does dim un o’r rheini’n anghyffredin. Dydd Mawrth ydyn nhw.
Nid dogfennaeth yw’r hyn rwyt ti’n ei gael allan ohono. Mae dogfennaeth yn rhywbeth rwyt ti’n ei ysgrifennu ac yna’n rhoi’r gorau i’w gynnal. Yr hyn rwyt ti’n ei gael yw cronfa ddata sy’n gwrthod dal gwrthddywediad, ac sy’n ateb cwestiynau na feddyliodd neb eu gofyn iddi ymlaen llaw. Mae cabinet ymhellach i lawr y cofnod hwn sy’n troi allan i fod yn 28.6 y cant yn llawn o offer a 90.7 y cant yn llawn o bŵer. Aeth neb ati i ddarganfod hynny. Fe ddisgynnodd allan o roi watedd ar fath o ddyfais unwaith.
Mae’r cafeat gonest yn dod gydag e, ac mae’r adran olaf am hynny. Dim ond gwerth yr hyn y mae’n ei gostio i ti ei gadw’n gywir yw cofnod. Ond y dewis arall yw busnes na all ddisgrifio ei hun, a’r person cyntaf i ddarganfod hynny fel arfer yw cwsmer.
Yr Un Arall: Nautobot
Byddi di’n dod ar draws hwn o fewn tua wythnos o chwilio, felly mae’n werth gwybod beth ddigwyddodd.
Yn 2021, gwnaeth Network to Code fforc o NetBox a galw’r canlyniad yn Nautobot. Nid fforc meddal na dosbarthiad: fforc caled sydd wedi gwyro ers pum mlynedd. Mae nodiadau rhyddhau ei v1.0 ei hun yn ei ddisgrifio fel ‘a divergent fork of NetBox 2.10’, crëwyd y storfa god ar 19 Chwefror 2021 a glaniodd v1.0.0 ar 26 Ebrill 2021.3
Mae eu rhesymau datganedig ar eu blog eu hunain ac yn werth eu darllen yn eu geiriau nhw yn hytrach na fy rhai i. Tri pheth a’i gyrrodd. Roedden nhw eisiau gwerthu cymorth menter: ‘We need to offer high-touch support models with Service Level Agreements (SLAs) we can guarantee. We need flexibility to offer Long-term Support (LTS) for customers who can’t upgrade at the pace of a fast moving open source project.’ Roedden nhw eisiau i’r ffynhonnell gwirionedd eistedd yng nghanol platfform awtomeiddio yn hytrach na gwasanaethu dogfennaeth. A ‘there became a growing divergence in our vision about what a Source of Truth for networking should look like and how to get there’.4
Mae angen rhoi dyddiad wrth y rheswm cyntaf yna, achos dyw e ddim yn wir mwyach. Yn Chwefror 2021 doedd dim cwmni y tu ôl i NetBox i werthu dim i ti. Chafodd NetBox Labs ddim ei sefydlu tan 2023, wedi’i droelli allan o NS1 ar ôl i IBM ei brynu, a’i gyd-sefydlu gan brif gynhaliwr NetBox ei hun.5
A nid trydydd parti a adeiladodd fusnes ar brosiect rhywun arall yw e. NetBox Labs yw ceidwad NetBox: mae dogfennaeth y prosiect ei hun yn dweud ‘the open source project is stewarded by NetBox Labs and a team of volunteer maintainers’.1 Maen nhw’n gwerthu NetBox Enterprise ar gyfer gosodiadau hunanreoledig, yn ei letya i ti fel NetBox Cloud, ac yn cynnig cymorth 24/7.6
Felly roedd ‘alli di ddim prynu cymorth ar gyfer NetBox’ yn beth teg i’w ddweud pan wnaeth Network to Code y fforc, a dyw e ddim yn beth teg i’w ddweud nawr. Mae gan y ddau brosiect gwmni masnachol y tu ôl iddyn nhw a fydd yn llofnodi rhywbeth, ac yn achos NetBox y cwmni hwnnw yw’r un sy’n stiwardio’r prosiect.
Y llinell y mae’r rhan fwyaf o bobl yn ei cholli yw’r nesaf, a dyna’r rheswm nad stori fudr yw hon: ‘the NetBox project team suggested that we should consider forking.’
Mae hynny cyn waraiddiedig ag y mae fforc yn ei gael. Roedd dau grŵp eisiau pethau gwahanol, fe ddywedon nhw hynny dros gyfnod hir, a hollti yn hytrach nag ymladd dros un sylfaen god. Mae’r ddau hanner yn dal yn Apache 2.0. Chymerodd neb ddim nad oedd ganddyn nhw hawl i’w gymryd.
Beth oedd pwrpas y fforc go iawn
Mae nodiadau rhyddhau Nautobot 1.0 yn rhestru beth a ychwanegodd o’i gymharu â NetBox 2.10, ac mae’r rhestr yn dweud y ddadl wrthot ti’n well nag unrhyw gofnod blog:3
| Beth ychwanegodd Nautobot yn 2021 | Ble mae NetBox nawr |
|---|---|
| Cefnogaeth GraphQL | Mae gan NetBox e |
| Integreiddio Git fel ffynhonnell ddata | Mae gan NetBox e, fel ffynonellau data wedi’u cydamseru |
| Mewngofnodi sengl | Mae gan NetBox e |
| Cyfrinachau | Mae gan NetBox e drwy ategyn |
| Sgriptiau ac adroddiadau wedi’u huno yn Jobs | Mae NetBox yn symud sgriptiau allan i ategyn yn 4.7 |
| Custom fields ar bob model | Mae gan NetBox gefnogaeth eang i custom fields |
| API ategyn dilysu data | Mae gan NetBox reolau dilysu personol |
| Statysau addasadwy, fel gwrthrychau cronfa ddata | Set ddewis Python yw statysau NetBox o hyd |
| Perthnasoedd rhwng modelau wedi’u diffinio gan y defnyddiwr | Does gan NetBox ddim cyfwerth |
| Allweddi cynradd UUID | Mae NetBox yn defnyddio allweddi cyfanrif |
| Gwelliannau i’r API ategion | Mae fframwaith ategion NetBox wedi tyfu llawer ers hynny |
Mae’r rhan fwyaf o’r hanner uchaf wedi dod at ei gilydd. Cyrhaeddodd sawl peth a anfonodd Nautobot allan yn 2021 NetBox wedyn, sef yr hyn sy’n digwydd fel arfer pan fo dau brosiect yn datrys yr un problemau yn gyhoeddus.
Dyw’r tri gwaelod ddim wedi dod at ei gilydd, ac maen nhw’n bensaernïol yn hytrach nag yn gosmetig. Gwiriais i’r ddwy sylfaen god heddiw yn hytrach nag ymddiried yn nodiadau 2021.
Model cronfa ddata yw Status Nautobot, wedi’i ddisgrifio yn ei god ffynhonnell ei hun fel ‘Model for database-backend enum choice objects’, felly mae statws yn rhes y gall rhywun ei hychwanegu yn y rhyngwyneb. Mae statysau NetBox yn dod o set ddewis Python, a dyna pam mae’r adran FIELD_CHOICES yn is i lawr yn ychwanegu un drwy olygu configuration.py ac ailgychwyn. Mae gan Nautobot fodelau Relationship a RelationshipAssociation, felly galli di ddiffinio perthynas rhwng dau fath o wrthrych sy’n bodoli heb ysgrifennu cod. Ateb NetBox i’r broblem honno yw ategyn, sy’n cael rhes o adrannau iddo’i hun yn is i lawr. Ac UUIDs yw allweddi cynradd Nautobot, lle mai cyfanrifau yw rhai NetBox.
Fe wnaethon nhw hefyd y peth y gwnaethon nhw’r fforc i’w wneud. Ar hyn o bryd mae Nautobot yn cyhoeddi 3.2.x a 2.4.x ar yr un diwrnod, sy’n llinell gynnal hirdymor go iawn yn rhedeg ochr yn ochr â’r un gyfredol, a dyna oedd un o’r tri rheswm datganedig.
Pa un
Y rhifau gonest yn gyntaf. Mae gan NetBox 21,625 o sêr a 3,133 o fforciau; mae gan Nautobot 1,617 a 422.7 Cafodd y ddau eu gwthio o fewn y ddau ddiwrnod diwethaf, mae’r ddau yn Apache 2.0, ac mae gan y ddau bellach gwmni masnachol y tu ôl iddyn nhw yn gwerthu cymorth a lletya.
Nid barn ar ansawdd yw’r bwlch yna. Mae’n adlewyrchu mantais pum mlynedd a’r ffaith bod y rhan fwyaf o bobl sydd angen ffynhonnell gwirionedd yn dod o hyd i NetBox yn gyntaf. Ond mae’n penderfynu’r peth sydd fel arfer yn bwysicach na nodweddion, sef faint o ategion, integreiddiadau, modiwlau Ansible, atebion fforwm a chydweithwyr y byddi di’n dod o hyd iddyn nhw ar gyfer yr un rwyt ti’n ei ddewis.
Felly: os wyt ti eisiau rhestr eiddo a ffynhonnell gwirionedd y mae systemau eraill yn ei darllen, ac rwyt ti eisiau’r ecosystem fwyaf a’r recriwtio hawsaf, NetBox yw’r ateb, a dyna beth mae gweddill y cofnod hwn yn ei drafod. Os mai dy reswm dros eisiau ffynhonnell gwirionedd yw gyrru awtomeiddio ohoni yn benodol, neu rwyt ti eisiau statysau a pherthnasoedd wedi’u diffinio gan dy dîm yn hytrach na gan ffeil gyfluniad ac ailgychwyn, cer i edrych ar Nautobot yn iawn cyn penderfynu.
Paid â gadael i neb werthu’r naill na’r llall i ti ar sail cymorth yn unig. Mae gan y ddwy ochr hynny dan reolaeth nawr, a’r gwahaniaethau a fydd yno o hyd ymhen pum mlynedd yw’r rhai yn y tabl uchod.
Yr hyn na ddylet ti ei wneud yw dewis un achos bod rhywun wedi dweud wrthot ti bod y llall wedi marw. Dyw’r un o’r ddau ddim, ac roedd y ddau yn dal i ryddhau fersiynau’r wythnos hon.
Ei Gael i Redeg
Dau lwybr, a rhedais i’r ddau ar gyfer hyn. Cynwysyddion os wyt ti eisiau iddo weithio mewn ugain munud, pecynnau ar westeiwr os yw’n mynd i gario pwysau.
Y pentwr cynwysyddion
Mae’r gymuned yn cynnal netbox-docker, sef yr ateb cyflym:8
git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
tee docker-compose.override.yml <<'EOF'
services:
netbox:
ports:
- 8000:8080
EOF
docker compose pull
docker compose up
Mae hynny’n rhoi’r rhaglen, PostgreSQL, Redis a gweithiwr cefndir i ti, wedi’u gwifrio at ei gilydd. Adeiladais i’r un peth â llaw dan podman er mwyn gweld y rhannau, ac mae’r rhannau’n werth eu gwybod achos mae dau ohonyn nhw’n dal pobl:
| Cynhwysydd | Yn gwneud beth | Os wyt ti’n ei adael allan |
|---|---|---|
netbox | Rhaglen Django y tu ôl i gunicorn | dyw dim yn gweithio |
postgres | Y gronfa ddata, 15 neu’n hwyrach | dyw dim yn gweithio |
redis / valkey | Dwy gronfa ddata: un ar gyfer tasgau, un ar gyfer storio dros dro | dyw dim yn gweithio |
netbox-worker | rqworker, sy’n gwagio’r ciw tasgau | dyw webhooks byth yn tanio, dyw jobiau cefndir byth yn rhedeg, a does dim yn dy rybuddio |
netbox-housekeeping | Y tacluso cyfnodol | dyw cofnodion y log newidiadau byth yn dod i ben |
Y bedwaredd res yna yw’r un. Mae popeth yn edrych yn iach heb weithiwr. Mae rheolau digwyddiadau’n ciwio ac yn eistedd yno.
Brathodd dau beth fi ar y rhediad cyntaf a dyw’r naill na’r llall ddim mewn neges gwall y byddet ti’n chwilio amdani.
Mae’r mudo cyntaf yn cymryd amser hir. Nid munud. Ar y peiriant hwn roedd yn sawl un, achos mae NetBox 4.7 yn disodli django-mptt gyda ltree PostgreSQL ac yn ailadeiladu pob tabl hierarchaidd ar y ffordd drwodd. Mae’r cynhwysydd jyst yn eistedd yno yn rhoi migrations ar waith. Gad lonydd iddo.
Heb API_TOKEN_PEPPERS alli di ddim creu tocyn API v2, a’r unig arwydd yw rhybudd yn y log:
UserWarning: API_TOKEN_PEPPERS is not defined. v2 API tokens cannot be used.
Gosoda o leiaf un, o leiaf hanner cant o nodau, cyn i ti fynd i chwilio pam mae’r API yn dy wrthod.
Ar westeiwr, o’r pecynnau
Mae’r llwybr dogfenedig wedi’i brofi ar Ubuntu 24.04. Rhedais i e o’r dechrau i’r diwedd ar un glân, a glaniodd ar hyn:
| Cydran | Beth roddodd 24.04 i mi | Beth sydd ei angen ar NetBox 4.7 |
|---|---|---|
| PostgreSQL | 16.15 | 15 neu’n hwyrach |
| Redis | 7.0.15 | 6.0 neu’n hwyrach |
| Python | 3.12.3 | 3.12, 3.13 neu 3.14 |
| Django | 6.1.1 | yn dod gyda NetBox |
| NetBox | v4.7.2 |
Isafswm NetBox ei hun yw’r rheina, a chododd 4.7 lawr PostgreSQL a llawr Redis.9
Pum cam yw’r holl waith.
# 1. the services
sudo apt install -y postgresql redis-server
sudo -u postgres psql -c "CREATE DATABASE netbox;"
sudo -u postgres psql -c "CREATE USER netbox WITH PASSWORD 'something-you-generated';"
sudo -u postgres psql -c "ALTER DATABASE netbox OWNER TO netbox;"
sudo -u postgres psql -d netbox -c "GRANT CREATE ON SCHEMA public TO netbox;"
# 2. the build dependencies
sudo apt install -y python3 python3-pip python3-venv python3-dev build-essential libxml2-dev libxslt1-dev libffi-dev libpq-dev libssl-dev zlib1g-dev git
# 3. the application, at a release tag rather than at main
sudo mkdir -p /opt/netbox && cd /opt/netbox
sudo git clone https://github.com/netbox-community/netbox.git .
sudo git checkout v4.7.2
sudo adduser --system --group netbox
sudo chown -R netbox /opt/netbox/netbox/media/ /opt/netbox/netbox/scripts/ /opt/netbox/netbox/reports/
# 4. the configuration: five values, no more
cd /opt/netbox/netbox/netbox/
sudo cp configuration_example.py configuration.py
python3 /opt/netbox/netbox/generate_secret_key.py # run it twice
sudo $EDITOR configuration.py
# 5. let the upgrade script do the rest
sudo /opt/netbox/upgrade.sh
Y pum gwerth yna yw ALLOWED_HOSTS, DATABASES, REDIS, SECRET_KEY ac API_TOKEN_PEPPERS. Cynhyrcha’r ddau olaf ar wahân a phaid ag ailddefnyddio un ar gyfer y llall. Fel y cyfryw, rheda’r generadur allweddi ddwywaith a gludo’r canlyniadau ar linellau gwahanol.
Mae upgrade.sh yn adeiladu’r amgylchedd rhithwir, yn gosod pob dibyniaeth Python, yn rhedeg y migrations, yn adeiladu’r ddogfennaeth i’w defnyddio all-lein ac yn casglu’r ffeiliau statig. Pan fydd yn gorffen ar focs newydd mae’n argraffu rhybudd sy’n edrych yn frawychus ac nad yw:
WARNING: No existing virtual environment was detected. A new one has
been created. Update your systemd service files to reflect the new
Python and gunicorn executables. (If this is a new installation,
this warning can be ignored.)
Yna uwchddefnyddiwr, ac mae’n rhedeg:
source /opt/netbox/venv/bin/activate
cd /opt/netbox/netbox && python3 manage.py createsuperuser
Ar gyfer unrhyw beth go iawn, rho gunicorn o’i flaen yn hytrach na runserver. Mae’r cyfluniad a’r ffeiliau uned yn y storfa god eisoes, a dyna’r manylyn sy’n werth ei wybod achos mae pobl yn ysgrifennu eu rhai eu hunain:
sudo cp /opt/netbox/contrib/gunicorn.py /opt/netbox/gunicorn.py
sudo cp -v /opt/netbox/contrib/*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now netbox netbox-rq
Mae netbox.service yn rhedeg gunicorn ar 127.0.0.1:8001, mae netbox-rq.service yn rhedeg y gweithiwr, ac mae nginx neu Apache yn mynd o’i flaen i derfynu TLS a gweini /static. Dau wasanaeth, a’r ail yw’r un gweithiwr ag sydd ei angen ar y pentwr cynwysyddion.
Y Drefn y Mae’n Rhaid i Ti Ei Lenwi
Cronfa ddata wag gyda barn yw NetBox newydd, ac mae’r awr gyntaf gydag un fel arfer yn cael ei threulio’n darganfod beth yw’r farn honno. Rwyt ti’n mynd i ychwanegu dyfais, a wnaiff e ddim gadael i ti.

Y sêr coch yna yw’r wers gyfan. Wnaiff NetBox ddim cofnodi peth cyn i’r pethau y mae’n hongian oddi arnyn nhw fodoli, a dyw e ddim yn bod yn lletchwith: mae dyfais heb fath yn rhes na all ateb yr un o’r cwestiynau y mae dyfais yno ar eu cyfer.
Felly yn hytrach na dyfalu, gofynnais i’r model pa allweddi tramor sy’n orfodol go iawn, ac yna ceisio torri pob rheol drwy’r API i weld beth sy’n dod yn ôl.
POST /api/dcim/device-types/ no manufacturer
{"manufacturer": ["This field is required."]}
POST /api/dcim/devices/ no device type
{"device_type": ["This field is required."]}
POST /api/dcim/interfaces/ no device
{"device": ["This field is required."]}
POST /api/ipam/aggregates/ no RIR
{"rir": ["This field is required."]}
POST /api/circuits/circuits/ no provider, no type
{"provider": ["This field is required."], "type": ["This field is required."]}
POST /api/virtualization/virtual-machines/ nothing at all
{"__all__": ["A virtual machine must be assigned to a site, cluster, or device."]}
Gwrthododd pob un, a dweud yn union pa beth oedd ar goll. Dyma’r un wybodaeth fel rhestr o ragofynion:
| I greu | Yn ofynnol yn gyntaf | Dewisol, ond rwyt ti eisiau hwn yn gyntaf |
|---|---|---|
| Tenant | dim | grŵp Tenant |
| Region, Site group | dim | rhiant o’r un math, maen nhw’n nythu |
| Site | dim | Region, Site group, Tenant |
| Location | Site | Location rhiant, Tenant |
| Rack type | Manufacturer | |
| Rack | Site | Location, Rack group, Rack role, Rack type, Tenant |
| Device type | Manufacturer | |
| Device role | dim | Device role rhiant, maen nhw’n nythu |
| Device | Device role, Device type, Site | Rack a safle, Platform, Tenant |
| Interface, a phob cydran arall | Device | |
| Cable | dau beth i’w derfynu arnyn nhw | Tenant |
| Aggregate | RIR | Tenant |
| VLAN | dim | VLAN group, Role, Tenant |
| Prefix | dim | Site, VLAN, Role, VRF, Tenant |
| IP address | dim | Interface i’w neilltuo iddo, Tenant |
| Circuit | Provider a Circuit type | Tenant |
| Circuit termination | Circuit | Site i lanio arno |
| Cluster | Cluster type | Cluster group, Site, Tenant |
| Virtual machine | Site, Cluster neu Device | Platform, Tenant |
| VM interface | Virtual machine |
Yr ail golofn yw’r un sy’n costio i ti. Dyw prefixes, cyfeiriadau IP, VLANs a thenantiaid ddim yn gofyn am ddim byd o gwbl, felly does dim yn dy rwystro rhag eu creu ar y diwrnod cyntaf mewn unrhyw drefn a fynni di. Mae p’un a ydyn nhw o unrhyw ddefnydd yn gwestiwn gwahanol, achos rhes mewn rhestr yw cyfeiriad heb ryngwyneb y tu ôl iddo, a dyfais heb denant yw dyfais y byddi di’n ei golygu eto’n nes ymlaen.
Y drefn i weithio ynddi go iawn
Mae hynny’n rhoi dilyniant. Gweithia i lawr drwyddo a wnaiff dim byd dy wrthod di byth.
Yn gyntaf, y pethau y mae popeth arall yn hongian oddi arnyn nhw. Does dim un o’r rhain yn gyffrous ac mae pob un yn rhad i’w gael yn anghywir.
- Grwpiau tenant, yna tenantiaid. Gwna’r rhain cyn dim byd arall. Mae dau ddeg wyth o fodelau’n cymryd tenant, gan gynnwys Site, Location a Rack, felly os nad yw’r cwsmeriaid yn bodoli eto alli di ddim eu stampio arnyn nhw wrth fynd a byddi di’n golygu mewn swmp yn nes ymlaen.
- Rhanbarthau a grwpiau safle. Y ddau’n ddewisol, y ddau’n nythu ynddyn nhw eu hunain, ac maen nhw’n annibynnol ar ei gilydd. Rhanbarthau ar gyfer daearyddiaeth, grwpiau safle ar gyfer swyddogaeth, a galli di ddefnyddio un, y ddau neu’r un ohonyn nhw.
- Safleoedd. Gwraidd bron popeth. Dyw safle ddim yn gofyn am ddim byd, a dyna pam mai dyma’r peth cyntaf y galli di ei greu go iawn.
- Lleoliadau. Mae angen safle ar y rhain, ac maen nhw’n nythu, felly mae neuadd sy’n cynnwys rhesi sy’n cynnwys podiau yn un model tair lefel o ddyfnder.
- Rolau rac a grwpiau rac. Y ddau’n ddewisol. Mae grwpiau rac yn wastad ac yn eistedd ochr yn ochr â lleoliadau fel ail echelin, sy’n handi ar gyfer rhesi a phodiau.
- Gwneuthurwyr, yna mathau o rac. Mae angen gwneuthurwr ar fath o rac. Hepgora fathau o rac os nad wyt ti’n modelu’r cabinetau eu hunain.
- Raciau. Mae angen safle ar y rhain. Os wyt ti hefyd yn rhoi lleoliad i un, rhaid i’r lleoliad hwnnw berthyn i’r safle hwnnw, ac mae NetBox yn gwirio.
Yna’r catalog caledwedd, nid y caledwedd. Cyn y galli di ychwanegu un ddyfais mae angen gwneuthurwyr, mathau o ddyfais, rolau dyfais ac, yn ymarferol, platfformau arnat ti.
- Gwneuthurwyr. Efallai fod rhai gen ti eisoes o gam 6, achos mae eu hangen ar fathau o rac hefyd. Ac ar fathau o fodiwl.
- Mathau o ddyfais, pob un angen gwneuthurwr.
- Rolau dyfais, sy’n nythu, a phlatfformau.
Dyma’r cam y mae pobl yn ei hepgor, a dyma’r cam sy’n penderfynu faint o deipio y mae gweddill y gwaith yn ei gymryd. Mae math o ddyfais yn cario ei ryngwynebau, ei byrth a’i faeau ei hun fel templedi, felly mae pob dyfais rwyt ti’n ei chreu ohono yn cyrraedd gyda’r cydrannau cywir arni eisoes. Cael y math yn iawn unwaith ac mae gosod deugain ohonyn nhw yn y rac yn ddeugain enw.
Platform yw’r un od yn y rhestr yna, achos dyw dyfais ddim yn gofyn am un yn llym. Gwna fe nawr beth bynnag. Dyna sy’n cario’r templed cyfluniad a gyrrwr NAPALM yn nes ymlaen, ac mae mynd yn ôl i’w osod ar ystad yr un noson ag y byddet ti wedi’i threulio ar denantiaid.
Yna’r offer ei hun.
- Dyfeisiau. Mae rôl, math a safle i gyd yn ofynnol. Mae rac a safle yn y rac yn ddewisol, ac os wyt ti’n eu rhoi rhaid iddyn nhw fod yn gyson â’r safle.
- Cydrannau, os na wnaeth y math o ddyfais eu darparu eisoes.
- Ceblau, rhwng y cydrannau.
Yna cyfeirio, achos mae cyfeiriad eisiau rhyngwyneb i fyw arno a dim ond ar ôl cam 12 y mae’r rhyngwyneb yn bodoli.
- RIRs, yna aggregates.
- Rolau prefix a VLAN, VRFs, grwpiau VLAN yna VLANs.
- Prefixes, yna’r cyfeiriadau IP unigol.
Yna’r haen fasnachol.
- Darparwyr, cyfrifon darparwr a mathau o gylched.
- Cylchedau, yna eu terfynu ar safleoedd.
A’r ystad rithwir, sy’n adlewyrchu’r un ffisegol.
- Mathau o glwstwr a grwpiau clwstwr, yna clystyrau.
- Peiriannau rhithwir, sydd angen safle, clwstwr neu ddyfais, yna eu rhyngwynebau.
Prynhawn yw camau 1 i 10 ac maen nhw’n teimlo fel gwaith gweinyddol. Does dim byd crand yn agos ato. Nhw hefyd yw’r prynhawn sy’n penderfynu a yw cam 11 yn cymryd bore neu bythefnos.
Y rheolau sy’n brathu’n nes ymlaen
Meysydd gofynnol yw’r hanner hawdd, achos maen nhw’n methu ar unwaith ac yn dweud pam. Y rhai sy’n dal pobl yw’r rheolau cysondeb, sydd ond yn tanio unwaith y bydd gen ti ddigon o ddata i wrth-ddweud dy hun:
device at Leeds, put in a Manchester rack
{"rack": ["Rack MCR1-A07 (A07) does not belong to site Leeds Edge."]}
device at Leeds, in a Manchester location
{"location": ["Location Hall 2 does not belong to site Leeds Edge."]}
rack at Leeds, in a Manchester location
{"__all__": ["Assigned location must belong to parent site (Leeds Edge)."]}
a second device in a unit that is already taken
{"position": ["U39.0 is already occupied or does not have sufficient
space to accommodate this device type: MX204 (1.0U)"]}
Yr un olaf yna yw’r un y byddwn i’n pwyntio ato pe bai rhywun yn gofyn pam trafferthu gydag unrhyw ran o hyn. Mae NetBox yn gwybod mai 1U yw’r ddyfais, yn gwybod beth sydd yn y cabinet, ac wnaiff e ddim gadael i ti gofnodi dau beth yn yr un gofod. Bydd dy daenlen yn gadael i ti wneud hynny drwy’r prynhawn heb ddweud gair, a byddi di’n darganfod pan fydd rhywun yn sefyll yn y neuadd gyda bocs yn ei ddwylo.
Does dim un o’r rhain yn gyflunadwy a ddylai’r un ohonyn nhw fod. Nhw yw’r gwahaniaeth rhwng cofnod a dymuniad.
Ei Ddefnyddio: Beth Mae Pob Sgrin yn ei Roi i Ti
Gyda’r ystad wedi’i llwytho, dyma beth rwyt ti’n ei gael yn ôl allan ohono go iawn. Yr un achos yw popeth isod: un cabinet, pedair ar ddeg o ddyfeisiau, wedi’u ceblo a’u cyfeirio ar draws tri chwsmer.
Dyfais yw ei chydrannau
Clicia i mewn i un o’r hypervisors yna a nid y crynodeb yw’r tab diddorol, ond y rhyngwynebau.

Darllena ar draws un rhes. Y rhyngwyneb, ei gyflymder, beth ysgrifennaist ti amdano, y cyfeiriad arno, y label ar y cebl, a’r porth ar y pen pellaf. Un ymholiad yw hynny, a dyna’r ateb i’r cwestiwn y mae pawb yn ei ofyn go iawn, sef ‘i beth mae hwn wedi’i blygio?’
Sylwa ble mae’r cyfeiriad yn eistedd. Mae ar eno1, nid ar y gweinydd. Mae hynny’n swnio fel pedantri hyd nes bod gen ti focs gyda rhyngwyneb rheoli, dau ryngwyneb data a loopback, a bod rhywun yn gofyn pa gyfeiriad sy’n ateb ar ei ran. All model sy’n hongian cyfeiriadau oddi ar ddyfeisiau ddim dweud wrthot ti. Gall hwn, a gall hefyd ddal yr achos cwbl gyffredin o bedwar cyfeiriad ar un rhyngwyneb.
Dilyna’r cebl
Mae ceblau’n terfynu ar gydrannau, nid ar ddyfeisiau. Rhyngwyneb ar un pen, rhyngwyneb ar y llall, neu borth blaen, porth cefn, allfa bŵer, terfyniad cylched. Dyna’r manylyn y mae’r nodwedd gyfan yn gorffwys arno, a dyna pam y gallai’r rhestr rhyngwynebau uchod argraffu’r pen pellaf yn ei cholofn ei hun heb i neb ddweud wrthi.
Modela gebl o ddyfais i ddyfais ac rwyt ti wedi tynnu llun. Terfyna fe ar y pyrth a gall NetBox ei gerdded.

Un naid yma, achos cebl direct attach yw e. Rho baneli patsh yn y canol ac mae’n eu cerdded, panel wrth banel, ac yn dweud wrthot ti beth sydd ar ben pellaf rhediad drwy dri chabinet. Dyna’r gwaith sydd fel arall yn golygu fflachlamp a rhywun yn dal pen arall chwiliedydd tôn.
Mae’r olrhain hefyd yn argraffu lleoliad llawn pob pen. Safle, neuadd, cabinet, wyneb, uned rac. Os wyt ti erioed wedi bod ar alwad yn ceisio dweud wrth beiriannydd remote hands pa focs i edrych arno, y llinell yna yw’r gwerth i gyd.
Cyfeiriadau, fel coeden yn hytrach na thab
IPAM yw’r hanner y mae pobl yn dod amdano.

Mae’r mewnoli wedi’i gyfrifo o’r cyfeiriadau eu hunain. Dwyt ti ddim yn dweud wrth NetBox bod 10.20.20.0/24 yn eistedd y tu mewn i 10.20.0.0/16, mae’n gweithio hynny allan, a bydd yn dal i’w weithio allan pan fydd rhywun yn ychwanegu /26 yn ei ganol y flwyddyn nesaf.
Mae pob rhes yn cario’r pethau rwyt ti’n hidlo yn ôl go iawn: y VLAN y mae’n mapio iddo, y rôl, a’r cwsmer y mae’n perthyn iddo. Mae’r defnydd wedi’i gyfrifo hefyd.
Agor un a chei di’r cyfeiriadau ynddo, a’r bylchau.

Y rhesi gwyrdd yna yw’r gofod rhydd, wedi’i ddangos yn unol â’r gofod a ddefnyddiwyd. Mae galwad API sy’n rhoi’r cyfeiriad rhydd nesaf allan o prefix i ti, sef yr un darn o awtomeiddio IPAM sy’n talu amdano’i hun ar unwaith, achos dyna’r peth y mae pobl fel arall yn ei wneud drwy gulhau eu llygaid ar daenlen a gobeithio.
Mae rhyngwyneb yn cymryd cymaint o gyfeiriadau ag y mynni di, o’r ddau deulu, ac rwyt ti’n enwebu un o bob un fel cyfeiriad cynradd y ddyfais.

Dau IPv4 a dau IPv6 ar un porth, sy’n ddydd Mawrth cyffredin ac yn rhywbeth na all model sy’n canolbwyntio ar ddyfeisiau ei fynegi o gwbl.
Rho gyfeiriadau gyda mwgwd y rhwydwaith y maen nhw arno, nid fel /32. Bydd NetBox yn derbyn 10.20.20.11/32 ac yn ei ffeilio dan y prefix cywir, achos mae cynnwysiant yn cael ei weithio allan o gyfeiriad y gwesteiwr. Yr hyn na wnaiff e yw ail-ddyfalu wedyn: mae’r mwgwd yn cael ei storio’n union fel y’i teipiwyd a’i roi’n ôl i beth bynnag sy’n ei ddarllen, felly mae /32 ar gyfeiriad LAN yn rendro /32 i gyfluniad y ddyfais. Y lle mae hynny’n brathu yw tri mis yn ddiweddarach mewn templed cyfluniad, nid heddiw yn y ffurflen.
Un gosodiad, tri chwsmer
Gellir neilltuo’r rhan fwyaf o wrthrychau yn NetBox i denant. Mae menter yn defnyddio hynny ar gyfer unedau busnes. Os wyt ti’n gwerthu gwasanaethau a reolir, rwyt ti’n creu un fesul cwsmer.

Y panel yna ar y dde yw’r ateb i ‘beth sydd gan y cwsmer hwn’, ac fe gydosododd ei hun. Dim adroddiad, dim taenlen, dim gofyn i’r peiriannydd a’i hadeiladodd.
Mae’n werth bod yn ofalus am ystyr tenantiaeth, achos mae ei chael yn anghywir ar y diwrnod cyntaf yn flwyddyn o ddatod yn nes ymlaen. Mae tenant yn golygu bod y gwrthrych wedi’i neilltuo i’r cwsmer hwnnw. Mae llwybrydd sy’n eu gwasanaethu nhw yn unig yn cael eu tenant nhw. Dyw wal dân sy’n gwasanaethu pedwar ohonyn nhw ddim yn perthyn i’r un ohonyn nhw, felly dyw hi ddim yn cael un, ac mae’r berthynas yn mynd i rywle arall. Mwy am hynny ymhellach i lawr, achos dyna’r pwynt lle mae’r rhan fwyaf o bobl yn darganfod bod angen iddyn nhw ychwanegu rhywbeth eu hunain.
Rho’r Rhifau ar y Math o Ddyfais
Dyma’r cam sy’n gwahanu rhestr eiddo oddi wrth rywbeth sy’n ateb cwestiynau, ac mae’n costio tua deg munud fesul math o ddyfais.
Gall math o ddyfais gario ei bwysau ac, drwy ei dempledi porth pŵer, ei ddefnydd pŵer. Rho’r rheina ar y math unwaith ac mae pob dyfais y byddi di byth yn ei chreu ohono yn eu hetifeddu. Gad nhw allan a bydd NetBox yn hapus i ddweud wrthot ti bod cabinet yn 28.6% llawn a dim byd arall.

Rhoddais bwysau ar bob un o’r pum math yma, rhoi dau dempled porth pŵer i bob un gyda defnydd uchaf a defnydd wedi’i ddyrannu, rhoi mewnfa a deuddeg allfa i’r math PDU, yna creu panel pŵer a dau gyflenwad i mewn i’r cabinet a cheblo’r cyfan: PSU1 pob dyfais i PDU A, pob PSU2 i PDU B, a mewnfa pob PDU i’w gyflenwad.

Yna mae tudalen y rac yn newid yn llwyr.

Defnydd gofod 28.6%. Defnydd pŵer 90.7%.
Mae’r cabinet yna yn draean llawn o offer a bron allan o bŵer, ac mae hynny’n ffaith am dy ystad na wnaiff yr un daenlen byth ei chynnig. Dyna hefyd y ffaith sy’n penderfynu a yw’r archeb nesaf yn mynd i’r rac yna neu i rywle arall, ac fe ddisgynnodd allan o ddata a roddaist ti i mewn unwaith, ar y mathau.
Dau beth a wnaiff ei adael yn darllen sero
Ges i 0.0% i ddechrau, ddwywaith, ac mae’r ddau achos yn werth eu gwybod achos dyw’r naill na’r llall ddim yn cynhyrchu gwall.
Rhaid i’r allfeydd gyfeirio at y fewnfa. Mae gan allfa bŵer ar PDU faes power_port sy’n pwyntio at y porth i fyny’r llif ar yr un ddyfais. Gad e’n wag ac mae’r gadwyn wedi torri: does gan NetBox ddim ffordd o wybod bod y deuddeg allfa yna’n cael eu bwydo gan y fewnfa yna, felly does dim yn cael ei grynhoi.
Gad feysydd defnydd y fewnfa’n wag. Dyma’r un sy’n mynd yn groes i reddf. Dim ond os yw ei ddau faes defnydd ei hun yn wag y mae NetBox yn cyfrifo defnydd porth pŵer o’r hyn sydd wedi’i blygio iddo:
if self.allocated_draw is None and self.maximum_draw is None:
...aggregate the downstream power ports...
# otherwise
return {'allocated': self.allocated_draw or 0, ...}
Roeddwn i wedi gosod maximum_draw: 7400 yn gymwynasgar ar fewnfa’r PDU, achos dyna radd y PDU. Felly fe gredodd NetBox fi, cymryd nad oedd allocated_draw wedi’i osod, ac adrodd sero. Clira’r ddau ac mae’n ei weithio allan:
mcr1-pdu-a INPUT -> allocated 5340 VA, maximum 8480 VA, across 12 outlets
mcr1-pdu-b INPUT -> allocated 5340 VA, maximum 8480 VA, across 12 outlets
feed MCR1-A07-A: available 5888 VA (230 V x 32 A x 80% max utilisation)
RACK power utilisation: 90.7 %
RACK weight: 166.6 kg of 900 kg
Felly’r rheol yw: rho rifau go iawn ar y dail, a gad y pyrth canolradd yn wag fel y gall NetBox eu hadio. Mae gwerth wedi’i ddiffinio’n weinyddol bob amser yn ennill dros yr un wedi’i gyfrifo, sy’n ymddygiad cywir ac yn union y peth anghywir i’w wneud ar PDU.
Oeri, sy’n newydd
Ychwanegodd fersiwn 4.7 oeri at DCIM, ac fe gyrhaeddodd gyda’r hanner sy’n mynd yn ddrud. Mae rac yn cario gallu oeri aer, hybrid neu hylif a chapasiti mewn cilowatau; mae math o ddyfais yn cario dull oeri. Uwchben hynny mae ffynonellau oeri ar gyfer yr oeryddion a’r unedau CRAC, cyflenwadau oeri sy’n cynrychioli dolen allan i rac, a chydrannau mewnlif ac all-lif ar y dyfeisiau eu hunain ar gyfer platiau oer a maniffoldiau.
Mae’r cabinet uchod yn darllen Hybrid, 15.00 kW, achos dywedais i hynny wrth y rac. Os wyt ti’n derbyn offer wedi’i oeri â hylif eleni, dyna fodel ar gyfer y peth rwyt ti’n ei gadw mewn taenlen ar hyn o bryd.
Un Gosodiad, Llawer o Gwsmeriaid
Tenantiaeth yw’r rheswm y gall darparwr redeg un NetBox yn hytrach nag un fesul cwsmer, ac mae’n werth deall beth mae’n ei wneud ac, yn bwysicach, beth nad yw’n ei wneud.
Mae dau ddeg wyth o fodelau NetBox yn cario maes tenant. Safleoedd, lleoliadau, raciau a chadw lle mewn raciau. Dyfeisiau, ceblau a chyd-destunau dyfais rhithwir. Prefixes, cyfeiriadau IP, ystodau, aggregates, VLANs, grwpiau VLAN, VRFs, route targets, ASNs. Cylchedau a grwpiau cylched. Clystyrau a pheiriannau rhithwir. Twneli, L2VPNs, LANs diwifr a chysylltiadau. Cyflenwadau pŵer a chyflenwadau oeri.
Dyna bob enw y galli di godi tâl amdano. Gosoda fe’n gyson ac mae ‘beth sydd gan y cwsmer hwn’ yn peidio â bod yn ymchwiliad.
Ond label yw tenant, nid clo. Mae’n dweud bod y gwrthrych wedi’i neilltuo i’r cwsmer hwnnw. Dyw e ddim yn rhwystro unrhyw un sy’n gallu mewngofnodi rhag darllen y cyfan, sy’n iawn y tu mewn i un cwmni a heb unrhyw ddefnydd o gwbl y funud y mae gan gwsmer gyfrif.
Mae dau beth yn dilyn, a’r ail yw’r un y mae pobl yn ei gael yn anghywir.
Mae tenant yn golygu wedi’i neilltuo. Mae llwybrydd sy’n gwasanaethu un cwsmer yn unig yn cael eu tenant nhw. Dyw wal dân sy’n gwasanaethu pedwar ohonyn nhw ddim yn perthyn i’r un ohonyn nhw, felly dyw hi’n cael dim byd, ac rwyt ti’n cofnodi’r berthynas ar y peth a werthaist ti go iawn yn lle hynny. Mae gorfodi tenant ar offer a rennir yn gwneud pob adroddiad sydd wedi’i adeiladu ar denantiaeth yn dawel anghywir.
Ac mae mynediad yn fecanwaith hollol ar wahân.
Yn y caniatâd y mae’r ynysu’n byw
Mae caniatâd gwrthrych NetBox yn cymryd cyfyngiad JSON, a hidlydd Django ORM yw’r cyfyngiad. Mae’n culhau’r queryset cyn i ddim gael ei adeiladu ohono, felly mae pob golwg, allforiad, galwad API a chwiliad yn cael ei gulhau gydag e.

Tri maes sy’n gwneud y gwaith. Y mathau o wrthrych y mae’n berthnasol iddyn nhw, y gweithredoedd y mae’n eu caniatáu, a’r cyfyngiad yna ar y gwaelod. Cadw cyfrifon yw popeth arall.
Dyma’r rhestr dyfeisiau fel gweinyddwr.

A dyma’r un URL, yr un gosodiad, wedi mewngofnodi fel y cwsmer.

Dwy res yn lle pedair ar ddeg, ac edrycha ar y ddewislen ar y chwith. Mae wedi crebachu i’r pedwar peth y caiff y cyfrif yna eu cyffwrdd. Wnaeth neb gyflunio hynny. Mae’r llywio wedi’i adeiladu o’r un caniatâd, felly dyw cwsmer byth yn gweld dolen at rywbeth a fyddai’n ei wrthod.
Y ddwy ffordd y mae’n dweud na
Dyma’r manylyn sy’n werth ei wybod, achos mae’r ddau wrthodiad yn golygu pethau gwahanol ac mae’r ddau’n fwriadol.
| Mae tocyn y cwsmer yn gofyn am | Mae’n cael |
|---|---|
/api/dcim/devices/ | 200, un rhes o ddwy |
/api/dcim/devices/1/, eu rhai nhw | 200 |
/api/dcim/devices/2/, rhai rhywun arall | 404 |
/api/tenancy/tenants/ | 403 |
/api/dcim/sites/, heb ei ganiatáu erioed | 403 |
| dim tocyn o gwbl | 403 |
Mae 404 yn golygu mai ti biau’r math ond nid y rhes yna. Fe dynnodd y cyfyngiad hi o’r queryset, felly o safbwynt y cais dyw hi ddim yn bodoli. Byddai 403 yno’n cadarnhau ei bod hi, ac yn gadael i gwsmer chwilfrydig gyfrif dy ystad drwy gerdded yr IDs.
Mae 403 yn golygu nad ti oedd biau’r math erioed. Chafodd tenantiaid a safleoedd byth eu caniatáu, felly maen nhw’n gwrthod yn llwyr, ac all y cwsmer ddim rhestru pwy arall sydd ar y platfform.
Yna gad iddyn nhw ysgrifennu
Darllen yn unig yw’r achos hawdd. Y cwestiwn go iawn yw a ellir ymddiried mewn cwsmer gyda hawliau golygu, felly caniatais i change dan yr un cyfyngiad a mynd i chwilio am y ffordd allan.
| Ymgais | Canlyniad |
|---|---|
| Golygu eu dyfais eu hunain | 200, wedi’i chadw |
| Golygu dyfais cwsmer arall | 404 |
| Golygu eu dyfais eu hunain, gan ei symud i denant y cwsmer arall | 403 |
| Dileu eu dyfais eu hunain | 403, chafodd dileu byth ei ganiatáu |
Y drydedd res yw’r un sy’n bwysig. Ailneilltuo dy ddyfais dy hun i denant rhywun arall yw’r ddihangfa amlwg, achos mae’r gwrthrych y tu mewn i dy gyfyngiad pan fydd y cais yn cyrraedd a’r tu allan iddo wedyn. Mae NetBox yn gwerthuso’r cyfyngiad yn erbyn y cyflwr y byddai’r gwrthrych yn cael ei adael ynddo, felly mae’n gwrthod. Darllenais i’r ddyfais yn ôl yn hytrach nag ymddiried yn y cod statws, a doedd y tenant ddim wedi symud.
Dyna’r twll y mae’r rhan fwyaf o aml-denantiaeth gartref yn ei adael ar agor, ac fel arfer cwsmer sy’n dod o hyd iddo yn hytrach na phrawf.
Newidynnau Sydd Angen Etifeddu
Dyma’r gwahaniaeth y mae pobl yn ei gael yn anghywir, ac mae ei gael yn iawn yn arbed llawer o olygu.
Gwerth ar un gwrthrych yw custom field. Rwyt ti’n ei osod fesul gwrthrych, ac mae’n aros yno. Da ar gyfer ffaith am y peth ei hun: tag ased, rhif contract cymorth, dyddiad comisiynu.
Gwerth wedi’i gysylltu â nodwedd yw config context, y mae popeth sy’n cyfateb i’r nodwedd honno yn ei etifeddu. Da ar gyfer newidyn a ddylai raeadru: dy weinyddion NTP, dy dargedau syslog, dy gymuned SNMP, dy barth DNS, dy VLAN rheoli, dy ffenestr wrth gefn.
Os wyt ti’n gweld dy hun yn gosod yr un custom field i’r un gwerth ar ddeugain o ddyfeisiau, config context oedd ei angen arnat ti.

JSON mympwyol yw context, a gellir ei gysylltu â rhanbarth, grŵp safle, safle, lleoliad, math o ddyfais, rôl, platfform, clwstwr, math o glwstwr, grŵp clwstwr, grŵp tenant, tenant neu dag. Mae tenant yn y rhestr yna, sydd i ddarparwr yn golygu bod ffaith sy’n wir am un cwsmer ym mhobman yn eu dilyn nhw ar bob dyfais y byddi di byth yn ei hychwanegu ar eu cyfer.
Mae’r uno fesul allwedd, a’r pwysau sy’n penderfynu pwy sy’n ennill pob un.

Darllena’r panel ar y dde yn erbyn yr un ar y chwith. Mae’r rhanbarth yn cyflenwi pedair allwedd ar bwysau 1000. Mae’r safle’n cyflenwi un allwedd ar bwysau 2000. Mae’r context wedi’i rendro yn cadw parth, gweinyddion NTP a chymuned y rhanbarth heb eu cyffwrdd, ac yn cymryd gweinydd syslog y safle, achos dyna’r unig allwedd yr oedd dim yn dadlau drosti.
Rwyt ti’n ysgrifennu’r eithriad, nid copi newydd o bopeth gyda’r eithriad ynddo. Dyna’r gwerth i gyd, a dyna pam mae hyn yn graddio lle nad yw ffeil newidynnau fesul dyfais.
Mae’r context lleol yn curo popeth uwch ei ben
Mae gan bentwr yr etifeddu frig, a’r gwrthrych ei hun yw hwnnw. Mae data context lleol ar ddyfais yn ennill dros bob context ffynhonnell sy’n berthnasol iddi, beth bynnag eu pwysau.
Gosodais i hyn ar mcr1-core-01:
{"syslog_servers": ["10.20.10.99"], "note": "this box logs somewhere else"}
a daeth ei context wedi’i rendro yn:
{
"note": "this box logs somewhere else",
"domain": "mcr1.example.net",
"ntp_servers": ["172.16.10.22", "172.16.10.33"],
"snmp_community": "n0rthwest",
"syslog_servers": ["10.20.10.99"]
}

Curodd y gweinydd syslog lleol y diystyru safle ar bwysau 2000 a’r rhanbarth ar bwysau 1000. Etifeddodd popeth na ddywedodd ddim amdano o hyd, felly daeth y parth, y gweinyddion NTP a’r gymuned drwodd heb eu cyffwrdd, a chafodd yr allwedd newydd ei hychwanegu’n syml.
Dyna’r drws dianc ar gyfer yr un bocs sy’n wirioneddol wahanol, ac mae’r panel yn dweud yn blaen wrthot ti ei fod yn trosysgrifo pob context ffynhonnell. Os wyt ti’n gweld dy hun yn ei ddefnyddio ar lawer o ddyfeisiau yn hytrach nag un, rwyt ti wedi dod o hyd i nodwedd y mae’r dyfeisiau hynny’n ei rhannu ac roeddet ti eisiau context wedi’i gwmpasu iddi.
Tri thrap
Mae context heb gwmpas yn fyd-eang. Crea un ac anghofio’i neilltuo i ddim byd, ac mae’n berthnasol i bob dyfais a pheiriant rhithwir sydd gen ti. Ymddygiad dogfenedig yw hynny ac weithiau’r hyn rwyt ti ei eisiau. Mae hefyd yn dawel.
Alli di ddim cael cysylltnodau mewn allweddi os wyt ti eisiau eu cyrraedd yn syml. JSON yw data context felly mae ntp-servers yn berffaith gyfreithlon, ond dyw enwau newidynnau Jinja ddim yn allweddi JSON. Mae {{ ntp-servers }} yn cael ei ddosrannu fel tynnu ac yn codi UndefinedError: 'ntp' is undefined. Ysgrifenna {{ ntp_servers }} yn erbyn data â chysylltnodau a chei di linyn gwag, HTTP 200, a dim rhybudd yn unman. Defnyddia danlinellau yn yr allweddi ac mae’r templed amlwg yn gweithio.
Gall proffil atal y teipos. Mae config context profile yn grwpio contexts cysylltiedig ac yn gorfodi sgema JSON ar eu data wrth gadw. Rhoddais sgema i un yn mynnu syslog_servers fel arae o linynnau IPv4, yna gwneud y ddau gamgymeriad y mae pobl yn eu gwneud go iawn:
{"syslog-server": ["10.1.1.1"]} singular, by accident
400 Data does not conform to profile schema:
'syslog-servers' is a required property
{"syslog_servers": [...], "syslog_port": 99999}
400 Data does not conform to profile schema:
99999 is greater than the maximum of 65535
Wedi’u gwrthod lle gwnaeth rhywun nhw, yn hytrach na phedwar cant o ddyfeisiau’n ddiweddarach.
Rendro’r Cyfluniad
Mae data context ynghyd â thempled Jinja yn rhoi ffeil gyfluniad i ti. Mae’r ddyfais mewn cwmpas fel device, mae ei context wedi’i uno mewn cwmpas fel newidynnau cyffredin, a galli di gerdded ei chydrannau.

Daeth popeth ar y dudalen yna o rywle gwahanol, a dyna’r pwynt:
| Llinell | O ble y daeth |
|---|---|
host-name mcr1-core-01 | y ddyfais |
domain-name mcr1.example.net | y config context rhanbarthol |
location "Manchester DC1 / MCR1-A07 / U39" | y safle, y rac a’r safle ynddo |
server 172.16.10.22 | y context rhanbarthol, pwysau 1000 |
host 10.20.10.99 any notice | context lleol y ddyfais ei hun, yn curo’r safle a’r rhanbarth |
family inet address 10.20.10.11/24 | y cyfeiriad ar y rhyngwyneb hwnnw, gyda’i fwgwd fel y’i teipiwyd |
Mae’r templed yn cael ei ddatrys o’r ddyfais, yna’r rôl, yna’r platfform, ac mae’r cais yn methu os nad oes gan yr un o’r tri un. Felly rwyt ti’n neilltuo templed i blatfform unwaith, ac mae pob dyfais sy’n rhedeg y feddalwedd honno’n rendro ohono oni bai bod ei rôl neu’r ddyfais ei hun yn dweud fel arall. Dyna bwrpas platfform: y system weithredu neu deulu meddalwedd y gwerthwr, nid y caledwedd.
Mae NetBox yn rendro. Dyw e ddim yn gwthio. Gwaith dy awtomeiddio yw cael yr allbwn ar y bocs, a’r diwrnod y byddai nam mewn templed fel arall wedi ailgyflunio pedwar cant o ddyfeisiau, byddi di’n falch mai dwy system wahanol yw’r rheina.
Ategion
Rhaglen Django wedi’i gosod ochr yn ochr â NetBox yw ategyn (plugin). Gall ychwanegu modelau, ychwanegu tudalennau, ymestyn y ddau API, chwistrellu cynnwys i dempledi sy’n bodoli, ychwanegu llywio, ychwanegu ciwiau jobiau cefndir a llwytho rhaglenni Django pellach. Ychydig iawn sydd na all ei wneud, achos oddi tano dim ond Django yw e.
Pedwar gorchymyn ac ailgychwyn yw gosod un:
source /opt/netbox/venv/bin/activate
pip install netbox-topology-views netbox-qrcode
# add the package names to PLUGINS in configuration.py, then
python3 manage.py migrate
python3 manage.py collectstatic --no-input
sudo systemctl restart netbox netbox-rq
Ar y pentwr cynwysyddion mae’r un pecynnau’n mynd yn plugin_requirements.txt ac rwyt ti’n ailadeiladu’r ddelwedd. Y naill ffordd neu’r llall, pinia’r fersiynau a gwirio’r matrics cydnawsedd yn gyntaf, achos bydd ategyn nad yw wedi dal i fyny â rhyddhad NetBox yn gwrthod cychwyn y rhaglen gyfan yn hytrach na’i analluogi ei hun.

Mae’r catalog cyhoeddedig yn rhestru 31. Dyma’r rhai sy’n werth gwybod amdanyn nhw, gyda’r drwydded y mae pob un yn cael ei anfon dani go iawn:
| Ategyn | Beth mae’n ei wneud | Trwydded |
|---|---|---|
| DNS | Parthau, cofnodion a gweinyddion enwau fel ffynhonnell gwirionedd | MIT |
| BGP | Sesiynau, cymunedau a pholisïau llwybro | Apache 2.0 |
| Topology Views | Mapiau topoleg graffigol wedi’u hadeiladu o dy geblau | Apache 2.0 |
| Floorplan | Mapiau safle a lleoliad graffigol | LGPL 3.0 |
| QR Code | Codau ar raciau, dyfeisiau a cheblau, ar gyfer labeli asedau | Apache 2.0 |
| ACLs | Rhestrau mynediad a rheolau | Apache 2.0 |
| Prometheus SD | Yn rhoi ei restr gwesteiwyr i Prometheus yn syth o NetBox | MIT |
| Documents | Dogfennau wedi’u cysylltu â chylchedau a dyfeisiau | Apache 2.0 |
| Lifecycle | Diwedd oes caledwedd, trwyddedau a chontractau | Apache 2.0 |
| Contract | Contractau ac anfonebau | MIT |
| Reorder Rack | Llusgo a gollwng unedau rac | Apache 2.0 |
| Branching | Canghennau ynysig, unadwy o dy ddata | NetBox Limited Use |
| Custom Objects | Mathau newydd o wrthrych, wedi’u diffinio yn y rhyngwyneb | NetBox Limited Use |
Prometheus SD yw siâp gonest y syniad cyfan. Mae NetBox yn gwybod beth sy’n bodoli, felly gad i NetBox ddweud wrth y system fonitro, a rho’r gorau i gynnal ail restr o westeiwyr sy’n drifftio.
Un peth i’w wybod cyn i ti adeiladu ar y ddwy res olaf. Mae NetBox ei hun yn Apache 2.0 ac wedi bod ers i DigitalOcean ei ryddhau yn 2016, a NetBox Labs sy’n stiwardio’r prosiect heddiw ochr yn ochr â thîm o gynhalwyr gwirfoddol.21 Dyw NetBox Branching a NetBox Custom Objects ddim: maen nhw’n cael eu hanfon dan y NetBox Limited Use License 1.0, sy’n caniatáu defnydd ‘only as part of a NetBox installation obtained from NetBox Labs or a NetBox distributor authorized by NetBox Labs, and only for your own internal use’, a dyw hi ddim yn caniatáu’r hawl i ddefnyddio’r feddalwedd ‘to provide a managed service or software products that includes, integrates with, or extends NetBox in a way that competes with any product or service of NetBox Labs’. Os gosodaist ti NetBox Community o GitHub a’i redeg ar ran cwsmeriaid, darllena’r telerau dy hun cyn i ti roi sgema y tu ôl iddyn nhw.10 Mae canllaw gosod NetBox ei hun yn argymell y ddau ategyn heb sôn am hynny.11
Custom Fields
Mae custom field yn ychwanegu priodoledd at fodel sy’n bodoli. Mae gwerthoedd yn cael eu storio fel JSON ochr yn ochr â phob gwrthrych, felly does dim mudo a dim ailgychwyn, ac mae tri ar ddeg o fathau gan gynnwys cyfeiriadau gwrthrych ac aml-wrthrych at gofnodion NetBox eraill.

Dau faes yno, wedi’u grwpio dan bennawd ‘Asset’ a ddewisais i. Sylwa ar y panel Dimensions i’r dde ohonyn nhw: 9.5 kg, na theipiodd neb ar y ddyfais hon. Daeth o’r math o ddyfais.
Mae custom fields yn cael eu dilysu, ac mae’n werth gwybod hynny, achos mae’n wahaniaeth go iawn o’r llwybr isod. Rhoddais fynegiad rheolaidd i’r maes contract a gorfododd yr API e:
PATCH {"custom_fields": {"support_contract": "nonsense"}}
{"__all__": ["Invalid value for custom field 'support_contract':
Value must match regex '^[A-Z]{2,4}-[0-9]{6}$'"]}
Newidiodd dau beth yn 4.7 sy’n bwysig ar raddfa. Mae creu maes gyda gwerth diofyn, neu ddileu maes, yn gorfod ailysgrifennu data wedi’i storio pob gwrthrych y mae’n berthnasol iddo, felly ar dabl mawr mae’r gwaith hwnnw’n cael ei roi i job cefndir ac mae’r maes yn adrodd ‘provisioning’ neu ‘deleting’ tra mae’n rhedeg. Dim ond tra mae’n weithredol y mae maes yn fyw: yn ystod y naill weithrediad neu’r llall dyw e ddim yn ymddangos ar wrthrychau, mewn ffurflenni, mewn hidlyddion nac yn y naill API na’r llall. Mae angen gweithiwr yn rhedeg ar gyfer hynny, neu mae’n eistedd yn y cyflwr hwnnw am byth.
Defnyddia custom field pan wyt ti’n ychwanegu ffaith am y peth ei hun. Defnyddia config context pan ddylai’r gwerth raeadru. Defnyddia’r adran nesaf pan nad yw’r peth sydd ei angen arnat ti yn bodoli.
Dewislenni Dethol Personol, a Diystyru’r Hyn Sy’n Dod gydag e
Mae dau fecanwaith gwahanol yn byw dan y pennawd hwn ac maen nhw’n datrys problemau gwahanol. Mae un ar gyfer dy feysydd dy hun. Mae’r llall yn ailysgrifennu rhai NetBox.
Choice set, ar gyfer dy faes dethol dy hun
Mae custom field o fath ‘selection’ yn cymryd ei opsiynau o choice set, sef gwrthrych rwyt ti’n ei reoli yn y rhyngwyneb fel unrhyw beth arall. Felly mae ‘haen gymorth’ yn troi’n gwymplen go iawn yn hytrach na thestun rhydd y bydd rhywun yn ei sillafu mewn tair ffordd.

Mae’n cael ei orfodi, gan gynnwys drwy’r API:
PATCH {"custom_fields": {"support_tier": "platinum"}}
{"__all__": ["Invalid value for custom field 'support_tier':
Invalid choice (platinum) for choice set Support tier."]}
Mae choice sets yn cael eu rhannu, felly gall un set gefnogi’r un maes ar sawl model, ac mae newid y rhestr mewn un lle yn ei newid ym mhobman.
FIELD_CHOICES, ar gyfer meysydd NetBox ei hun
Dyma’r un nad yw pobl yn gwybod ei fod yn bodoli. Gellir ymestyn neu ddisodli sawl un o feysydd dewis adeiledig NetBox o configuration.py, gan gynnwys statws dyfais, statws safle, statws rac, statws cylched a digon mwy.12
Ychwanega arwydd plws i ychwanegu at yr hyn sy’n dod gydag e. Gad e allan i ddisodli’r rhestr yn llwyr.
FIELD_CHOICES = {
# add to what NetBox ships with
'dcim.Device.status+': (
('burn-in', 'Burn-in', 'cyan'),
{'value': 'awaiting-rma', 'label': 'Awaiting RMA', 'color': 'orange',
'description': 'Faulty, with the vendor'},
),
# replace the stock list outright
'dcim.Site.status': (
('surveyed', 'Surveyed', 'purple'),
('building', 'Building out', 'orange'),
('active', 'Active', 'green'),
('closing', 'Closing', 'red'),
),
}
Rhoddais i union hynny ar yr achos hwn. Daeth statws dyfais yn ôl gyda’r saith gwerth safonol a fy nau i:
offline, active, planned, staged, failed, inventory, decommissioning,
burn-in, awaiting-rma
a daeth statws safle yn ôl gyda fy rhai i yn unig, y rhestr safonol wedi mynd:
surveyed, building, active, closing
Gall dewis fod yn dwpl plaen o werth, label a lliw, neu’n eiriadur sydd hefyd yn cymryd disgrifiad a ddangosir fel is-deitl yn y ffurflen. Ac maen nhw’n ymddwyn fel gwerthoedd brodorol ym mhobman, achos o safbwynt gweddill NetBox gwerthoedd brodorol ydyn nhw:

Fy statws i yw’r bathodyn yna, yn fy lliw i, yn trefnu ac yn hidlo fel unrhyw un arall.
Tri pheth sy’n werth eu gwybod cyn i ti ei ddefnyddio.
Mae disodli’n dileu’r gwerthoedd safonol o’r ddewislen, nid o’r gronfa ddata. Mae unrhyw wrthrych sydd eisoes yn dal un ohonyn nhw yn ei gadw, ond dyw’r gwerth ddim yn cael ei gynnig mwyach ac ni fydd yn ddewis dilys y tro nesaf y bydd rhywun yn golygu’r gwrthrych hwnnw. Os wyt ti’n disodli rhestr, gwiria nad oes dim yn eistedd ar werth rwyt ti newydd ei dynnu.
Mae’n byw yn y ffeil gyfluniad, felly mae angen ailgychwyn a dyw e ddim yn rhywbeth y gall defnyddiwr y rhyngwyneb ei newid. I ddarparwr dyna’r ffordd iawn rownd: penderfyniad llywodraethu yw’r set o statysau y mae dy fusnes yn eu cydnabod, nid un ar brynhawn dydd Mawrth.
Ymestyn cyn disodli. Y gwerthoedd safonol yw’r hyn y mae pob ategyn, sgript ac integreiddiad yn disgwyl eu gweld. Dyw ychwanegu ddim yn costio dim. Mae disodli yn benderfyniad rwyt ti’n berchen arno am byth.
Custom Objects
Dyma fwlch go iawn. Mae NetBox yn modelu clystyrau, peiriannau rhithwir a disgiau rhithwir. Dyw e ddim yn modelu’r storfa ddata (datastore) y mae’r disgiau hynny’n byw arni go iawn, ac i unrhyw un sy’n rhedeg Proxmox neu VMware dyna’r gwrthrych sy’n cysylltu’r storfa a brynaist ti â’r llwyth gwaith sy’n ei defnyddio.
Mae’r ategyn Custom Objects yn gadael i ti ddiffinio math newydd o wrthrych o’r rhyngwyneb neu’r API, heb ysgrifennu unrhyw god. Felly:

Saith maes, a dau ohonyn nhw yw’r pwynt i gyd. Mae cluster yn gyfeiriad gwrthrych sengl at glwstwr NetBox go iawn, wedi’i osod i protect fel na all neb ddileu clwstwr o dan ei storfa. Mae provisioned_by yn gyfeiriad aml-wrthrych at y dyfeisiau sy’n ei gwasanaethu go iawn.
Mae hynny’n rhoi gwrthrych o’r radd flaenaf i ti gyda’i gofnod llywio ei hun, golwg rhestr, hidlyddion, mewnforio ac allforio:

Ac achos bod y cyfeiriadau’n rhai go iawn, mae’r berthynas yn ymddangos o’r pen arall hefyd. Agor y clwstwr ac mae’r storfeydd data wedi’u rhestru yn ei erbyn.

Mae math custom object yn etifeddu’r rhan fwyaf o’r hyn sy’n gwneud gwrthrych NetBox yn wrthrych NetBox: golygon rhestr a manylion, cofnod llywio, endpoints REST, chwilio testun llawn, logio newidiadau, cyfnodolyn, tagiau, nodau tudalen, mewnforio ac allforio, rheolau digwyddiadau a hysbysiadau. Doedd dim rhaid ysgrifennu dim o hynny.
A dyw e ddim yn flob JSON yn esgus bod yn dabl chwaith. Mae’r ategyn yn cyhoeddi DDL go iawn, ac mae’r hyn sy’n ymddangos yn PostgreSQL yn dabl go iawn gyda chyfyngiadau go iawn:
Table "public.custom_objects_2"
Column | Type | Nullable | Default
-----------------+----------+----------+------------------
id | bigint | not null | identity
name | varchar | |
cluster_id | bigint | |
backing | varchar | |
capacity_gb | bigint | |
thin_provisioned| boolean | |
Indexes:
"custom_objects_2_name_key" UNIQUE CONSTRAINT, btree (name)
Foreign-key constraints:
... FOREIGN KEY (cluster_id) REFERENCES virtualization_cluster(id) ON DELETE RESTRICT
Daeth y protect y gofynnais amdano yn ON DELETE RESTRICT, ac mae’n gweithio: mae dileu’r clwstwr yna’n dod yn ôl gyda 409 yn enwi beth sy’n dibynnu arno.
Dau beth i’w gwybod cyn i ti ddibynnu arno
Ar y ffurflen y mae’r dilysu, nid ar yr API. Dyma’r un a fyddai’n dal awtomeiddio. Datganais required, mynegiad rheolaidd a ffiniau rhifol ar feysydd math custom object, ac yna ysgrifennu atyn nhw drwy’r REST API:
| Beth ddatganais i | Beth anfonais i | Canlyniad |
|---|---|---|
validation_regex | gwerth nad yw’n cyfateb i ddim | 201 Created |
required: true | y maes wedi’i adael allan yn llwyr | 201 Created |
validation_minimum: 1 | rhif negatif | 201 Created |
unique: true | dyblygiad | 400, wedi’i wrthod |
on_delete_behavior: protect | dileu’r gwrthrych y cyfeirir ato | 409, wedi’i wrthod |
Y ddau a ddaliodd yw’r ddau a drodd yn gyfyngiadau cronfa ddata. Dim ond ar y ffurflen we y mae’r gweddill yn bodoli, felly mae person sy’n teipio wedi’i gyfyngu a dyw cydamseru nosweithiol ddim. Cymhara hynny â’r custom field craidd ymhellach i fyny, lle cafodd yr un mynegiad rheolaidd ei orfodi drwy’r API. Nes bod hynny’n newid, rho unrhyw beth y mae anfoneb yn dibynnu arno y tu ôl i gyfyngiad go iawn.
Mae dileu math yn gollwng tabl. Mae dileu maes yn gollwng colofn. DDL o ffurflen we yw hynny, wedi’i weithredu gan bwy bynnag sydd â’r caniatâd, ac mae’r ddogfennaeth yn dweud cymaint â hynny.13 Cyfynga pwy all ddileu’r rhain.
Pryd i ysgrifennu ategyn go iawn yn lle hynny
Os yw’r gwrthrych yn bwysig, os yw awtomeiddio’n ysgrifennu ato, ac os byddet ti’n ypset o ddod o hyd i sbwriel ynddo, ysgrifenna’r model dy hun. Mae ategyn NetBox lleiaf yn PluginConfig, model, serializer, viewset, tabl, ffurflen, ychydig o olygon a map URL, ac mae’n dod i lai na dau gant o linellau o ddatganiadau gan fwyaf. Mae is-ddosbarthu PrimaryModel yn rhoi tagiau, custom fields, logio newidiadau, cyfnodolyn, templedi allforio a pherchnogaeth i ti am ddim, ac mae pob cyfyngiad rwyt ti’n ei roi ar y model yn cael ei orfodi ym mhobman, achos peirianwaith serializer NetBox ei hun sy’n ei redeg.
Mae templed cookiecutter a thiwtorial ategion llawn yn cael eu cynnal gan y gymuned. Dechreua o’r rheini yn hytrach nag o gyfeiriadur gwag.
A dyna ba bynnag drwydded a ddewisi di, na all neb ei newid yn nes ymlaen.
Dilysu Personol, a Dosbarthiadau Dilysu
Mae popeth uchod yn ymwneud â chofnodi’r hyn sydd yno. Mae hyn yn ymwneud â gwrthod cofnodi’r hyn na ddylai fod.
Mae NetBox yn dilysu pob gwrthrych cyn ei ysgrifennu, a galli di ychwanegu dy reolau dy hun ar ben hynny. Mae tri mecanwaith, maen nhw i gyd yn byw yn configuration.py, a rhyngddyn nhw maen nhw’n cwmpasu bron unrhyw beth sydd ei angen ar safon tŷ.
Un: rheolau plaen, dim cod
Gall dilysydd fod yn fapiad plaen o enwau meysydd i amodau. Dim Python, ac mae’n gludadwy rhwng gosodiadau achos dim ond data yw e.
CUSTOM_VALIDATORS = {
'dcim.site': (
{'description': {'required': True}},
),
'dcim.device': (
{'name': {'regex': r'^[a-z0-9]+-[a-z]+-([0-9]{2}|[a-z])$'}},
),
}
Yr amodau sydd ar gael yw min, max, min_length, max_length, regex, required, prohibited, eq a neq. Galli di estyn i mewn i wrthrych cysylltiedig gyda llwybr dotiog, felly mae region.name ar safle yn deg, a galli di gyfateb ar request.user.username er bod y ddogfennaeth yn hollol gywir yn dweud wrthot ti am ddefnyddio caniatâd ar gyfer hynny yn lle.
Mae’r ddwy reol yna’n tanio ar unwaith:
POST a site with no description
{"__all__": ["Custom validation failed for description:
['This field must not be empty.']"]}
POST a device named "Server1"
{"__all__": ["Custom validation failed for name: ['Enter a valid value.']"]}
Safon enwi yw’r ail un yna, wedi’i gorfodi. Nid wedi’i hysgrifennu ar dudalen wici, nid ym mhen rhywun, nid rhywbeth y mae’r person newydd yn cael pryd o dafod amdano mewn adolygiad dair wythnos yn ddiweddarach. Wnaiff y gronfa ddata ddim ei gymryd.
Dau: dosbarth dilysu, pan fo’r rheol yn frawddeg
Mae rheolau plaen yn gwirio un maes yn erbyn cysonyn. Mae rheolau tŷ go iawn fel arfer yn amodol: mae hwn yn bwysig dim ond pan fo hwnna. Ar gyfer y rheini rwyt ti’n is-ddosbarthu CustomValidator, yn diystyru validate(), ac yn galw fail().
Rhoddais dri mewn modiwl yn /opt/netbox/netbox/house_rules.py:
from extras.validators import CustomValidator
class BillableKitNamesItsCustomer(CustomValidator):
"""Anything in a role we sell has to say whose it is."""
BILLABLE_ROLES = {'hypervisor'}
def validate(self, instance, request):
role = getattr(instance, 'role', None)
if role and role.slug in self.BILLABLE_ROLES and not instance.tenant:
self.fail(
f"A {role} is billable kit, so it must name the customer it belongs to.",
field='tenant',
)
class RackedDeviceNeedsAPosition(CustomValidator):
"""A device in a rack with no rack unit is a device nobody can find."""
def validate(self, instance, request):
if instance.rack and instance.position is None:
if instance.device_type and instance.device_type.u_height:
self.fail(
"A device in a rack needs a rack unit. Somebody has to find it.",
field='position',
)
class CustomerPrefixNeedsATenant(CustomValidator):
"""A customer prefix that names no customer cannot be billed."""
def validate(self, instance, request):
role = getattr(instance, 'role', None)
if role and role.slug == 'customer' and not instance.tenant:
self.fail(
"A customer prefix must be assigned to a tenant.",
field='tenant',
)
a’u gwifrio yn ôl llwybr dotiog:
CUSTOM_VALIDATORS = {
'dcim.device': (
{'name': {'regex': r'^[a-z0-9]+-[a-z]+-([0-9]{2}|[a-z])$'}},
'house_rules.BillableKitNamesItsCustomer',
'house_rules.RackedDeviceNeedsAPosition',
),
'ipam.prefix': (
'house_rules.CustomerPrefixNeedsATenant',
),
}
Sylwa fod model yn cymryd twpl o ddilyswyr, rheolau plaen a dosbarthiadau wedi’u cymysgu’n rhydd, ac maen nhw i gyd yn rhedeg. Rhaid pasio hyd yn oed un dilysydd fel iteradwy, sy’n bum munud hawdd i’w colli.
Yna mae’r rheolau’n gwneud yr hyn maen nhw’n ei ddweud:
POST a hypervisor with no tenant
{"tenant": ["A Hypervisor is billable kit, so it must name
the customer it belongs to."]}
POST a device into a rack with no position
{"position": ["A device in a rack needs a rack unit.
Somebody has to find it."]}
POST a prefix with role "customer" and no tenant
{"tenant": ["A customer prefix must be assigned to a tenant."]}
POST a leaf switch with no tenant
accepted, because a leaf switch is not in BILLABLE_ROLES
Achos bod fail() yn cymryd field, mae’r neges yn glanio ar y blwch cywir yn y ffurflen yn hytrach nag ar frig y dudalen, a dyna’r gwahaniaeth rhwng rheol y mae pobl yn ei dysgu a rheol y mae pobl yn ei chasáu.
Dyna hefyd yr ateb i’r bwlch yn yr adran custom objects. Dim ond ar y ffurflen we yr oedd y dilysu yno’n bodoli. Mae CustomValidator yn rhedeg yn haen y model, felly mae’n berthnasol i’r rhyngwyneb, y REST API, mutations GraphQL, mewnforion swmp ac unrhyw beth y mae sgript yn ei wneud. Mae un lle i ysgrifennu’r rheol a dim ffordd o’i chwmpas.
Tri: rheolau amddiffyn, ar gyfer dileu
Mae CUSTOM_VALIDATORS yn gwarchod ysgrifennu. Mae PROTECTION_RULES yn gwarchod dileu, ac mae’n cymryd yr un ddwy ffurf yn union.
PROTECTION_RULES = {
'dcim.device': (
{'status': {'eq': 'offline'}},
),
}
Mae hynny’n dweud mai dim ond pan fydd hi all-lein y gellir dileu dyfais. Sy’n cynhyrchu:
DELETE an active device
{"detail": "Deletion is prevented by a protection rule:
[\"Custom validation failed for status:
['Ensure this value is equal to offline.']\"]"}
set it to offline, then DELETE
204 No Content
Dau drawiad bysell o ffrithiant rhwng rhywun a dyfais fyw, a dyna’r yswiriant rhataf yn y rhaglen gyfan. Gwna’r broses ddatgomisiynu yn beth sy’n datgloi’r botwm dileu.
Yr un a fydd yn dy ddal di
Dyw data sy’n bodoli ddim yn cael ei wirio nes i ti ei gyffwrdd nesaf. Dyw ychwanegu rheol ddim yn mynd yn ôl i ddilysu’r hyn sydd yno eisoes. Mae’n eistedd yn dawel nes bod rhywun yn cadw gwrthrych sy’n ei thorri, ac yna maen nhw’n cael gwall am benderfyniad nad oedd ganddyn nhw ddim i’w wneud ag e.
Gwyliais i e’n digwydd. Cafodd mcr1-hv-06 ei greu cyn i mi ysgrifennu dim o hyn, fel hypervisor heb denant. Eisteddodd yno’n berffaith hapus. Yna golygais ei ddisgrifiad:
PATCH {"description": "touching it to trigger revalidation"}
{"tenant": ["A Hypervisor is billable kit, so it must name
the customer it belongs to."]}
Doedd gan y golygiad ddim i’w wneud â’r tenant. Taniodd y rheol beth bynnag, achos mae dilysu’n rhedeg ar y gwrthrych cyfan.
Dyna ymddygiad cywir a dyna hefyd sut mae rheol newydd yn troi’n docyn cymorth. Cyn i ti droi un ymlaen, rheda ymholiad am y gwrthrychau a fyddai’n ei methu a’u trwsio nhw’n gyntaf. Mae’r API yn gwneud hynny’n hawdd: hidlydd yw’r rheol, felly gofynna am y dyfeisiau gyda’r rôl yna a dim tenant, ac mae dy restr gen ti.
Troa’r rheol ymlaen wedyn. Yna dim ond camgymeriadau newydd y mae hi byth yn eu dal, a dyna’i phwrpas.
Ei Yrru o Ansible
Bydd ffynhonnell gwirionedd nad oes dim yn ei darllen yn pydru. Casgliad netbox.netbox yw sut mae’r rhan fwyaf o bobl yn atal hynny rhag digwydd, ac mae’n gweithio i’r ddau gyfeiriad: mae NetBox yn dweud wrth Ansible beth sy’n bodoli, ac mae Ansible yn dweud wrth NetBox beth a adeiladodd.
Mae ar fersiwn 3.23.0, dan drwydded GPL-3.0, ac mae wedi’i dynnu o Galaxy dros 13.4 miliwn o weithiau. Mae’n cario 91 o fodiwlau ac un ategyn rhestr eiddo.14 Cafodd popeth isod ei redeg yn erbyn yr un achos, o gynhwysydd heb ddim ynddo ond ansible-core 2.21.4, pynetbox 7.8.0 a’r casgliad.
Ymholiad yw’r rhestr eiddo, nid ffeil
Dyma’r hanner sy’n talu amdano’i hun ar y prynhawn cyntaf. Mae nb_inventory yn adeiladu dy restr eiddo Ansible yn syth allan o NetBox:
plugin: netbox.netbox.nb_inventory
api_endpoint: http://netbox:8080
token: "{{ lookup('env', 'NETBOX_TOKEN') }}"
config_context: false
group_by:
- sites
- device_roles
- tenants
- racks
device_query_filters:
- has_primary_ip: true
Mae hynny’n cynhyrchu hyn, heb i neb gynnal rhestr gwesteiwyr:
@sites_manchester-dc1: @device_roles_hypervisor:
|--mcr1-core-01 |--mcr1-hv-01
|--mcr1-core-02 |--mcr1-hv-02
|--mcr1-hv-01 |--mcr1-hv-03
|--mcr1-hv-02 |--mcr1-hv-04
... |--mcr1-hv-05
@racks_MCR1-A07: @tenants_ravenscroft-legal:
|--mcr1-core-01 |--mcr1-hv-01
|--mcr1-core-02 |--mcr1-hv-02
... @tenants_padgate-foods:
@device_roles_core-router: |--mcr1-hv-03
|--mcr1-core-01 |--mcr1-hv-04
|--mcr1-core-02 @tenants_hartley-components:
|--mcr1-hv-05
Edrycha ar y golofn dde. Achos bod tenantiaeth wedi’i gosod ar y dyfeisiau, rwyt ti’n cael grŵp fesul cwsmer am ddim, felly mae --limit tenants_ravenscroft-legal yn rhedeg play yn erbyn offer un cwsmer yn union. Ychwanega ddyfais yn NetBox ac mae yn y grŵp ar y rhediad nesaf. Datgomisiyna un ac mae wedi mynd. Does neb yn golygu dim byd.
Mae pob gwesteiwr yn cyrraedd yn cario’r hyn y mae NetBox yn ei wybod amdano:
ansible_host "2001:db8:20:20::11"
primary_ip4 "10.20.20.11"
primary_ip6 "2001:db8:20:20::11"
device_roles ["hypervisor"]
sites ["manchester-dc1"]
racks ["MCR1-A07"]
tenants ["ravenscroft-legal"]
device_types ["sys-1029u-tn10rt"]
manufacturers ["supermicro"]
status {"label": "Active", "value": "active"}
Dau ddeg dau o allweddi i gyd, ac mae un ohonyn nhw’n werth sylwi arni cyn iddi dy synnu. Y cyfeiriad IPv6 yw ansible_host, achos mae gan y ddyfais yna v6 cynradd wedi’i osod. Gwiriais i e yn erbyn dwy arall sydd â v4 yn unig a daethon nhw’n ôl yn v4, felly’r rheol yw bod yr ategyn yn ffafrio v6 lle mae v6 cynradd yn bodoli. Sy’n gywir, a hefyd y math o beth y byddai’n well gen ti ei ddarganfod nawr nag wrth bendroni pam mae play yn cysylltu dros lwybr nad oeddet ti wedi meddwl amdano.
Ysgrifennu’n ôl
Y modiwlau yw’r cyfeiriad arall, a’r un sy’n werth ei gael yw dyrannu IP, achos mae NetBox yn gwybod beth sy’n rhydd a dyw dy playbook ddim.
- name: Rack the device
netbox.netbox.netbox_device:
netbox_url: "{{ nb_url }}"
netbox_token: "{{ nb_token }}"
data:
name: mcr1-hv-07
device_type: SYS-1029U-TN10RT
device_role: Hypervisor
site: Manchester DC1
rack: MCR1-A07
position: 14
face: Front
tenant: Hartley Components
state: present
- name: Let NetBox pick the next free address out of the customer prefix
netbox.netbox.netbox_ip_address:
netbox_url: "{{ nb_url }}"
netbox_token: "{{ nb_token }}"
data:
prefix: 10.20.22.0/24
tenant: Hartley Components
assigned_object:
device: mcr1-hv-07
name: eno1
state: new
Sylwa beth sydd ddim yno. Dim cyfeiriad IP. Rwyt ti’n enwi’r prefix ac mae NetBox yn rhoi’r un rhydd nesaf yn ôl:
TASK [Let NetBox pick the next free address out of the customer prefix] ****
changed: [localhost]
"device : mcr1-hv-07 (created)"
"interface: eno1 (created)"
"address : 10.20.22.1/24 (allocated)"
Ac mae yno yn y rhyngwyneb eiliad yn ddiweddarach, heb ei geblo i ddim eto ond yn y rac, wedi’i denantio ac wedi’i gyfeirio:

Y trap yn y playbook yna
Rheda fe am yr eildro heb newid llinell ac mae hyn yn digwydd:
"device : mcr1-hv-07 (already correct)"
"interface: eno1 (already correct)"
"address : 10.20.22.2/24 (allocated)"
Mae’r ddyfais a’r rhyngwyneb yn idempotent. Dyw’r cyfeiriad ddim, a dyw e ddim yn nam. Mae state: present yn golygu ‘gwna iddo edrych fel hyn’. Mae state: new yn golygu ‘rho un newydd i mi’, bob un tro, a dyna’n union beth wnaeth e: dau gyfeiriad ar un rhyngwyneb ar ôl dau rediad.
Mae hynny’n iawn pan wyt ti’n darparu rhywbeth newydd go iawn, a bydd yn bwyta prefix yn dawel os wyt ti’n ei roi mewn job sy’n rhedeg bob nos. Dyrana unwaith a chofnodi’r canlyniad, neu defnyddia state: present gyda’r cyfeiriad sydd gen ti eisoes. Mae’r modiwl yn gwneud yr hyn y gofynnaist ti amdano. Y cwestiwn yw a ofynnaist ti am yr hyn roeddet ti’n ei olygu.
Nid Ansible yn unig yw e
Mae’r casgliad yn cael y sylw achos Ansible yw lle mae’r rhan fwyaf o dimau rhwydwaith eisoes, ond yr API yw’r cynnyrch ac mae digon o bethau’n ei siarad.
| Peth | Beth yw e | Trwydded |
|---|---|---|
pynetbox | Y cleient Python y mae’r casgliad ei hun yn ei ddefnyddio | Apache 2.0 |
terraform-provider-netbox | Rheoli gwrthrychau NetBox fel adnoddau Terraform, wedi’i gynnal yn weithredol gan e-breuninger | MPL 2.0 |
nornir_netbox | NetBox fel rhestr eiddo Nornir, i bobl sy’n gwneud Python yn hytrach na YAML | Apache 2.0 |
| Prometheus SD | Yn rhoi ei dargedau scrape i Prometheus o NetBox | MIT |
go-netbox | Cleient Go, er nad oes neb wedi’i gyffwrdd ers Mai 2025 | gweler y storfa god |
| Diode | Piblinell amlyncu NetBox Labs ei hun ar gyfer gwthio data a ddarganfuwyd i mewn | NetBox Limited Use |
Yr un Terraform yw’r cofnod diddorol i unrhyw un sydd eisoes yn rheoli seilwaith felly, achos mae’n gadael i un cynllun greu’r adnodd cwmwl a’r cofnod NetBox sy’n ei ddogfennu, yn hytrach na gadael yr ail hanner i gof rhywun.15
Mae Diode yn cario’r un drwydded â Branching a Custom Objects, felly mae’r un darlleniad yn berthnasol cyn i ti adeiladu arno.
Beth Mae’r Prynhawn yn ei Brynu Go Iawn
Cymerodd popeth uchod ddiwrnod i mi ar un peiriant, ac roedd y rhan fwyaf o’r diwrnod hwnnw’n hau data fel bod gan y sgriniau rywbeth ynddyn nhw. Ugain munud yw’r gosod y naill ffordd neu’r llall. Y penderfyniadau yw’r rhan sy’n bwysig ac maen nhw i gyd yn cael eu gwneud yn yr awr gyntaf: tenantiaid cyn dim byd, mathau o ddyfais cyn dyfeisiau, y rhifau ar y mathau yn hytrach nag ar yr offer.
Nid dogfennaeth yw’r hyn rwyt ti’n ei gael am hynny. Dyw neb yn gwneud y gwahaniaeth yna nes eu bod wedi cael y ddau: mae dogfennaeth yn rhywbeth rwyt ti’n ei ysgrifennu ac yna’n rhoi’r gorau i’w gynnal. Yr hyn rwyt ti’n ei gael yw cronfa ddata sy’n gwrthod dal gwrthddywediad: wnaiff hi ddim gadael i ti roi dau beth mewn un uned rac, na rac mewn lleoliad sy’n perthyn i safle arall, na dyfais ar fath nad yw’n bodoli. Mae pob un o’r gwrthodiadau hynny’n ddadl na fyddi di’n ei chael ymhen chwe mis.
A bydd hi’n dweud pethau wrthot ti na ofynnodd neb iddi. Mae’r cabinet yna’n 28.6% llawn o offer a 90.7% llawn o bŵer. Aeth neb ati i ddarganfod hynny. Fe ddisgynnodd allan o roi watedd ar fath o ddyfais unwaith, a dyna’r gwahaniaeth rhwng gosod yr archeb nesaf yno a darganfod y ffordd galed.
Yr un cafeat gonest sydd gan bob ffynhonnell gwirionedd. Dim ond gwerth yr hyn y mae’n ei gostio i ti ei chadw’n gywir yw hi, a’r unig fersiwn o hyn sy’n goroesi chwarter prysur yw’r un lle mae rhywbeth yn torri’n amlwg pan fo’r data’n anghywir. Gwifra dy fonitro, dy ddarparu neu dy reolau wal dân i ddarllen ohoni, ac mae cofnod anghywir yn peidio â bod yn broblem ddogfennaeth y bydd rhywun yn mynd ati rywbryd. Mae’n troi’n doriad am hanner awr wedi naw ar fore dydd Mawrth, gydag enw arno. Mae hynny’n swnio fel cost. Dyna’r mecanwaith i gyd.
Fydd neb yn diolch i ti amdano chwaith. Mae cofnod cywir yn ymddangos fel y mudo a gymerodd bythefnos yn lle chwarter, yr archwiliad a gymerodd brynhawn, y cwsmer a gafodd ateb syth ar y ffôn. Does dim o hynny’n ymddangos ar adroddiad wrth ymyl dy enw.
Gwna fe beth bynnag. Y dewis arall yw busnes na all ddisgrifio ei hun, a dyw busnes na all ddisgrifio ei hun ddim yn cael ei redeg. Mae’n cael ei gofio, gan lai o bobl bob blwyddyn.
NetBox, Introduction — ‘Today, the open source project is stewarded by NetBox Labs and a team of volunteer maintainers’, a’r tarddiad yn DigitalOcean yn 2015, yn ffynhonnell agored ym Mehefin 2016. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎
NetBox, LICENSE.txt — Apache License 2.0, hawlfraint DigitalOcean, LLC. Tarddiad a stiwardiaeth o’r cyflwyniad. ↩︎ ↩︎
Nodiadau rhyddhau Nautobot v1.0.0 — ‘a divergent fork of NetBox 2.10’, wedi’u cyhoeddi 26 Ebrill 2021, a’r rhestr o’r hyn a ychwanegodd o’i gymharu â NetBox 2.10. ↩︎ ↩︎
Network to Code, “Why Did Network to Code Fork NetBox?”, 25 Chwefror 2021 — y rhesymu am SLA a chymorth hirdymor, y gwyro yn y weledigaeth, a ‘the NetBox project team suggested that we should consider forking’. ↩︎
Sefydlwyd NetBox Labs yn 2023 fel cwmni wedi’i droelli allan o NS1 yn dilyn ei brynu gan IBM, wedi’i gyd-sefydlu gan brif gynhaliwr NetBox Jeremy Stretch, a chyhoeddodd Series A gwerth $20m yn Ebrill 2023: NetBox Labs, “Let’s Go: Announcing NetBox Labs” a chyhoeddiad y Series A. ↩︎
NetBox Labs, NetBox Enterprise — yr argraffiad masnachol hunanreoledig, gyda ‘24/7 expert assistance from the NetBox Labs team’; NetBox Cloud yw’r cynnig wedi’i letya. Dyw telerau SLA penodol ddim wedi’u cyhoeddi ar y dudalen honno. ↩︎
Cyfrifon sêr a fforciau, dyddiadau rhyddhau a thrwyddedau’r ddau brosiect wedi’u darllen o API GitHub ar 30 Medi 2026: netbox-community/netbox a nautobot/nautobot. Mae rhyddhadau cyfochrog 3.2.x a 2.4.x Nautobot ill dau wedi’u dyddio 28 Medi 2026. ↩︎
netbox-community/netbox-docker — pentwr cynwysyddion y gymuned, Apache 2.0. ↩︎
NetBox, Installation — tabl y fersiynau a gefnogir, a nodiadau rhyddhau v4.7 ar gyfer isafswm codedig PostgreSQL a Redis. Fersiwn ac argraffiad wedi’u darllen o
netbox/release.yaml. ↩︎NetBox Limited Use License 1.0 — wedi’i chario gan netbox-custom-objects ac, yn union yr un fath, gan netbox-branching. Mae’r ddau gymal a ddyfynnir air am air. ↩︎
NetBox, HTTP Server installation, “What’s Next?” — ‘Some of the most popular plugins include’ NetBox Branching, NetBox Custom Objects, NetBox DNS a NetBox BGP, heb sôn am delerau trwydded. ↩︎
NetBox, Data Validation configuration —
FIELD_CHOICES, a’r ôl-ddodiad arwydd plws sy’n ymestyn yn hytrach na disodli: ‘To replace the available choices, specify the app, model, and field name separated by dots … To extend the available choices, append a plus sign’. ↩︎Dogfennaeth netboxlabs/netbox-custom-objects — ‘Deleting a Custom Object Type drops an entire database table and should be done with caution.’ ↩︎
netbox.netbox ar Ansible Galaxy a netbox-community/ansible_modules — fersiwn 3.23.0, GPL-3.0, 91 o fodiwlau ynghyd â’r ategyn rhestr eiddo
nb_inventory. Cyfrif lawrlwythiadau wedi’i ddarllen o Galaxy ar 30 Medi 2026. Cafodd popeth a ddangosir ei redeg gydag ansible-core 2.21.4 a pynetbox 7.8.0. ↩︎Trwyddedau, gweithgarwch a chyfrifon sêr wedi’u darllen o bob prosiect ar 30 Medi 2026: pynetbox (Apache 2.0), terraform-provider-netbox (MPL 2.0, v6.0.0-rc.1 ar gofrestrfa Terraform), nornir_netbox (Apache 2.0), netbox-plugin-prometheus-sd (MIT), go-netbox (gwthiwyd ddiwethaf 9 Mai 2025) a Diode, sy’n cario’r un NetBox Limited Use License 1.0 â Branching a Custom Objects. ↩︎