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:

RhaglenModelauRhaglenModelau
dcim56virtualization7
extras23tenancy6
ipam18wireless3
circuits11users7
vpn10core8

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.

Tudalen manylion rac NetBox ar gyfer MCR1-A07, yn dangos rhanbarth North West, safle Manchester DC1, lleoliad Hall 2, statws Active a 28.6% o ddefnydd gofod ar y chwith, gydag elevations blaen a chefn ar y dde yn rhestru paneli patsh yn U41 ac U42, dau lwybrydd yn U38 ac U39, dau switsh yn U35 ac U36, a chwe hypervisor rhwng U15 ac U20, pob un wedi’i liwio yn ôl ei rôl

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 ynDyw NetBox ddim yn
Cofnodi beth ddylai fod ynoHoli beth sydd yno
Dal y VLAN bwriadedig ar gyfer porthDweud wrthot ti fod y porth i lawr
Dweud i ba gwsmer y mae prefix yn perthynCodi tâl arnyn nhw amdano
Rendro cyfluniad dyfais o dempledEi wthio i’r ddyfais
Cofnodi’r gylched, y darparwr a’r ymrwymiadMonitro’r gylched
Dweud ym mha rac y mae dyfais, ac ym mha UAgor 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 fomentBeth sy’n rhaid i ti ei gynhyrchuBeth mae’n ei gostio pan na elli di
Sgwrs adnewydduCyfrif eitemedig o beth mae’r tâl misol yn ei brynuMae dyfynbris y cystadleuydd wedi’i eitemeiddio, achos aethon nhw ati i gyfrif
Peiriannydd yn rhoi ei rybuddPopeth roedd yn ei wybod, wedi’i ysgrifennuChwe mis o ddarganfod, un tocyn ar y tro
Cwsmer yn gadaelDisgrifiad o’i ystad ei hunTair wythnos i’w gasglu, a geirda y bydd yn ei roi’n onest
Archwilydd yn gofyn cwestiwn cwmpasPa systemau sy’n dal data personol, a ble maen nhw’n ffisegolRheoleiddiwr wedi cael gwybod rhywbeth sy’n troi allan yn ddiweddarach i fod yn anwir
Mudo sydd angen ei brisioCyfrif o beth sydd yno go iawnRwyt 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 2021Ble mae NetBox nawr
Cefnogaeth GraphQLMae gan NetBox e
Integreiddio Git fel ffynhonnell ddataMae gan NetBox e, fel ffynonellau data wedi’u cydamseru
Mewngofnodi senglMae gan NetBox e
CyfrinachauMae gan NetBox e drwy ategyn
Sgriptiau ac adroddiadau wedi’u huno yn JobsMae NetBox yn symud sgriptiau allan i ategyn yn 4.7
Custom fields ar bob modelMae gan NetBox gefnogaeth eang i custom fields
API ategyn dilysu dataMae gan NetBox reolau dilysu personol
Statysau addasadwy, fel gwrthrychau cronfa ddataSet ddewis Python yw statysau NetBox o hyd
Perthnasoedd rhwng modelau wedi’u diffinio gan y defnyddiwrDoes gan NetBox ddim cyfwerth
Allweddi cynradd UUIDMae NetBox yn defnyddio allweddi cyfanrif
Gwelliannau i’r API ategionMae 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:

CynhwysyddYn gwneud bethOs wyt ti’n ei adael allan
netboxRhaglen Django y tu ôl i gunicorndyw dim yn gweithio
postgresY gronfa ddata, 15 neu’n hwyrachdyw dim yn gweithio
redis / valkeyDwy gronfa ddata: un ar gyfer tasgau, un ar gyfer storio dros drodyw dim yn gweithio
netbox-workerrqworker, sy’n gwagio’r ciw tasgaudyw webhooks byth yn tanio, dyw jobiau cefndir byth yn rhedeg, a does dim yn dy rybuddio
netbox-housekeepingY tacluso cyfnodoldyw 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:

CydranBeth roddodd 24.04 i miBeth sydd ei angen ar NetBox 4.7
PostgreSQL16.1515 neu’n hwyrach
Redis7.0.156.0 neu’n hwyrach
Python3.12.33.12, 3.13 neu 3.14
Django6.1.1yn dod gyda NetBox
NetBoxv4.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.

Ffurflen Add a new device NetBox, yn dangos Name, Device role wedi’i farcio â seren goch, Description a Tags dan bennawd Device, yna Device type hefyd wedi’i farcio â seren goch dan Hardware, ac wedyn Serial number, Asset tag, Cooling method ac Airflow

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 greuYn ofynnol yn gyntafDewisol, ond rwyt ti eisiau hwn yn gyntaf
Tenantdimgrŵp Tenant
Region, Site groupdimrhiant o’r un math, maen nhw’n nythu
SitedimRegion, Site group, Tenant
LocationSiteLocation rhiant, Tenant
Rack typeManufacturer
RackSiteLocation, Rack group, Rack role, Rack type, Tenant
Device typeManufacturer
Device roledimDevice role rhiant, maen nhw’n nythu
DeviceDevice role, Device type, SiteRack a safle, Platform, Tenant
Interface, a phob cydran arallDevice
Cabledau beth i’w derfynu arnyn nhwTenant
AggregateRIRTenant
VLANdimVLAN group, Role, Tenant
PrefixdimSite, VLAN, Role, VRF, Tenant
IP addressdimInterface i’w neilltuo iddo, Tenant
CircuitProvider a Circuit typeTenant
Circuit terminationCircuitSite i lanio arno
ClusterCluster typeCluster group, Site, Tenant
Virtual machineSite, Cluster neu DevicePlatform, Tenant
VM interfaceVirtual 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.

  1. Gwneuthurwyr. Efallai fod rhai gen ti eisoes o gam 6, achos mae eu hangen ar fathau o rac hefyd. Ac ar fathau o fodiwl.
  2. Mathau o ddyfais, pob un angen gwneuthurwr.
  3. 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.

  1. 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.
  2. Cydrannau, os na wnaeth y math o ddyfais eu darparu eisoes.
  3. 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.

  1. RIRs, yna aggregates.
  2. Rolau prefix a VLAN, VRFs, grwpiau VLAN yna VLANs.
  3. Prefixes, yna’r cyfeiriadau IP unigol.

Yna’r haen fasnachol.

  1. Darparwyr, cyfrifon darparwr a mathau o gylched.
  2. Cylchedau, yna eu terfynu ar safleoedd.

A’r ystad rithwir, sy’n adlewyrchu’r un ffisegol.

  1. Mathau o glwstwr a grwpiau clwstwr, yna clystyrau.
  2. 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.

Tab interfaces NetBox ar gyfer dyfais mcr1-hv-01 yn dangos tri rhyngwyneb: eno1, SFP28 25GE, wedi’i ddisgrifio i leaf-01, gyda chyfeiriad IP 10.20.20.11/24, cebl MCR1-DAC-0001A yn cysylltu â mcr1-leaf-01 Ethernet1; eno2 SFP28 25GE i leaf-02 gyda chebl MCR1-DAC-0001B i mcr1-leaf-02 Ethernet1; ac ipmi 1000BASE-T wedi’i ddisgrifio BMC gyda 10.20.10.101/24

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.

Olrhain cebl NetBox ar gyfer rhyngwyneb eno1, wedi’i lunio fel diagram fertigol: mcr1-hv-01, Supermicro SYS-1029U-TN10RT yn Manchester DC1 / Hall 2 / MCR1-A07 (A07) / Front / U20.0, ei ryngwyneb eno1, cebl MCR1-DAC-0001A wedi’i farcio Connected, yna Ethernet1 ar mcr1-leaf-01, Arista DCS-7050SX3-48YC8 yn Front / U36.0. Trace Completed, cyfanswm segmentau 1

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.

Rhestr prefixes NetBox yn dangos 10.20.0.0/16 fel Container gyda 5 plentyn ar 1.6% o ddefnydd wedi’i ddisgrifio Manchester DC1, ac oddi tano bum prefix plentyn gweithredol wedi’u mewnoli un lefel: 10.20.10.0/24 ar VLAN mgmt (100) gyda rôl Management, 10.20.20.0/24 wedi’i denantio i Ravenscroft Legal ar VLAN ravenscroft-prod (200), 10.20.21.0/24 i Padgate Foods, 10.20.22.0/24 i Hartley Components, a 10.20.30.0/29 ar VLAN transit (110) ar 16.7% o ddefnydd

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.

Tab IP Addresses NetBox ar gyfer prefix 10.20.20.0/24, yn dangos rhes werdd ‘10 IPs available’, yna 10.20.20.11/24 a 10.20.20.12/24 ill dau’n weithredol ac wedi’u tenantio i Ravenscroft Legal, yna rhes werdd ‘242 IPs available’

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.

Rhestr cyfeiriadau IP NetBox wedi’i hidlo i ryngwyneb eno1 ar mcr1-hv-01, yn dangos pedwar cyfeiriad: 10.20.20.11/24 wedi’i farcio’n gynradd, 10.20.20.201/24 cyfeiriad gwasanaeth, 2001:db8:20:20::11/64 v6 cynradd, a 2001:db8:20:20::201/64 cyfeiriad gwasanaeth, i gyd wedi’u tenantio i Ravenscroft Legal

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.

Tudalen tenant NetBox ar gyfer Ravenscroft Legal yn y grŵp Customers, gyda phanel Related Objects yn rhestru Circuits 2, Devices 2, IP Addresses 2, Prefixes 1 a VLANs 1, a thabiau ar draws y brig ar gyfer Custom Objects, Contacts, Journal a Changelog

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.

Tudalen math o ddyfais NetBox ar gyfer y Supermicro SYS-1029U-TN10RT, yn dangos uchder 1U, dyfnder llawn wedi’i dicio, pwysau 19.10 kg a dull oeri Air, gyda thab Power Ports yn cario cyfrif o 2 a phanel Related Objects yn dangos 6 dyfais

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.

Power feed NetBox MCR1-A07-A, math Primary, statws Active, wedi’i gysylltu â mcr1-pdu-a INPUT, yn dangos defnydd wedi’i ddyrannu 5340VA o 5888VA fel bar coch 90.7 y cant, gyda nodweddion trydanol cyflenwad AC, 230 folt, 32 amp, un cyfnod ac 80 y cant o ddefnydd uchaf

Yna mae tudalen y rac yn newid yn llwyr.

Tudalen rac NetBox ar gyfer MCR1-A07 bellach yn dangos gallu oeri Hybrid, capasiti oeri 15.00 kW, defnydd gofod 28.6 y cant mewn gwyrdd a defnydd pŵer 90.7 y cant mewn coch, ochr yn ochr â’r elevations blaen a chefn

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.

Tudalen manylion caniatâd NetBox ar gyfer Ravenscroft read-only, yn dangos Enabled wedi’i dicio, Actions gyda View wedi’i dicio ac Add, Change, Delete, Render configuration a Synchronize data i gyd wedi’u croesi, Object Types yn rhestru Circuits circuit, DCIM device ac IPAM prefix, un defnyddiwr wedi’i neilltuo ravenscroft-ro, a phanel Constraints yn cynnwys y JSON tenant__slug wedi’i osod i ravenscroft-legal

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.

Rhestr dyfeisiau NetBox fel y defnyddiwr admin, Results 14, yn dangos mcr1-core-01 a 02, mcr1-hv-01 hyd at 06, mcr1-leaf-01 a 02, mcr1-pdu-a a b, ac mcr1-pp-01 a 02, gyda cholofnau ar gyfer statws, tenant, safle, lleoliad, rac, rôl, gwneuthurwr, math a chyfeiriad IP

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

Yr un rhestr dyfeisiau NetBox wedi mewngofnodi fel ravenscroft-ro, Results 2, yn dangos dim ond mcr1-hv-01 ac mcr1-hv-02, ill dau wedi’u tenantio i Ravenscroft Legal, gyda’r llywio ar y chwith wedi’i leihau i Devices, IPAM, Circuits, Plugins ac Admin

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 amMae’n cael
/api/dcim/devices/200, un rhes o ddwy
/api/dcim/devices/1/, eu rhai nhw200
/api/dcim/devices/2/, rhai rhywun arall404
/api/tenancy/tenants/403
/api/dcim/sites/, heb ei ganiatáu erioed403
dim tocyn o gwbl403

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.

YmgaisCanlyniad
Golygu eu dyfais eu hunain200, wedi’i chadw
Golygu dyfais cwsmer arall404
Golygu eu dyfais eu hunain, gan ei symud i denant y cwsmer arall403
Dileu eu dyfais eu hunain403, 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.

Rhestr config contexts NetBox yn dangos North West base ar bwysau 1000 wedi’i neilltuo i ranbarth North West, a Manchester DC1 syslog ar bwysau 2000 wedi’i neilltuo i safle Manchester DC1, y ddau’n weithredol

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.

Tab Config Context NetBox ar gyfer mcr1-core-01 yn dangos Rendered Context ar y chwith yn cynnwys domain, ntp_servers, snmp_community a syslog_servers, a Source Contexts ar y dde yn rhestru North West base ar bwysau 1000 gyda’r pedair allwedd i gyd a Manchester DC1 syslog ar bwysau 2000 yn cynnwys syslog_servers yn unig

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"]
}

Tab Config Context NetBox ar gyfer mcr1-core-01 gyda Local Context bellach wedi’i lenwi â syslog_servers 10.20.10.99 a nodyn, y panel yn datgan bod y config context lleol yn trosysgrifo pob context ffynhonnell, a’r Rendered Context yn dangos y gweinydd syslog lleol ochr yn ochr â’r parth, gweinyddion NTP a chymuned a etifeddwyd

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.

Tab Render Config NetBox ar gyfer mcr1-core-01, yn dangos y templed cyfluniad Junos base a’r cyfluniad Junos wedi’i rendro: host-name mcr1-core-01, domain-name mcr1.example.net, llinell leoliad yn darllen Manchester DC1 / MCR1-A07 / U39, dau weinydd NTP, yr un gwesteiwr syslog 10.20.10.99, y gymuned SNMP n0rthwest, a phob rhyngwyneb gyda’i ddisgrifiad a’i deulu cyfeiriadau

Daeth popeth ar y dudalen yna o rywle gwahanol, a dyna’r pwynt:

LlinellO ble y daeth
host-name mcr1-core-01y ddyfais
domain-name mcr1.example.nety config context rhanbarthol
location "Manchester DC1 / MCR1-A07 / U39"y safle, y rac a’r safle ynddo
server 172.16.10.22y context rhanbarthol, pwysau 1000
host 10.20.10.99 any noticecontext lleol y ddyfais ei hun, yn curo’r safle a’r rhanbarth
family inet address 10.20.10.11/24y 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.

Tudalen ategion wedi’u gosod NetBox yn rhestru Custom Objects fersiwn 0.7.0 gan NetBox Labs, Topology views fersiwn 4.7.0 gan Mattijs Vanhaverbeke, a qrcode fersiwn 1.0.0 gan Nikolay Yuzefovich

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:

AtegynBeth mae’n ei wneudTrwydded
DNSParthau, cofnodion a gweinyddion enwau fel ffynhonnell gwirioneddMIT
BGPSesiynau, cymunedau a pholisïau llwybroApache 2.0
Topology ViewsMapiau topoleg graffigol wedi’u hadeiladu o dy geblauApache 2.0
FloorplanMapiau safle a lleoliad graffigolLGPL 3.0
QR CodeCodau ar raciau, dyfeisiau a cheblau, ar gyfer labeli asedauApache 2.0
ACLsRhestrau mynediad a rheolauApache 2.0
Prometheus SDYn rhoi ei restr gwesteiwyr i Prometheus yn syth o NetBoxMIT
DocumentsDogfennau wedi’u cysylltu â chylchedau a dyfeisiauApache 2.0
LifecycleDiwedd oes caledwedd, trwyddedau a chontractauApache 2.0
ContractContractau ac anfonebauMIT
Reorder RackLlusgo a gollwng unedau racApache 2.0
BranchingCanghennau ynysig, unadwy o dy ddataNetBox Limited Use
Custom ObjectsMathau newydd o wrthrych, wedi’u diffinio yn y rhyngwynebNetBox 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.

Tudalen dyfais NetBox ar gyfer mcr1-core-01 yn dangos panel Custom Fields gyda grŵp Asset yn cynnwys Warranty expires 2029-06-30 a Support contract JNPR-448120, ochr yn ochr â’r panel Device Type yn dangos Juniper MX204 a phanel Dimensions yn dangos cyfanswm pwysau 9.5 cilogram

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.

Choice set custom field NetBox o’r enw Support tier, wedi’i ddisgrifio fel yr hyn y mae’r cwsmer yn talu amdano, yn rhestru tri dewis: bronze ar gyfer y diwrnod busnes nesaf, silver ar gyfer 8 awr, a gold ar gyfer 4 awr 24x7

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:

Rhestr dyfeisiau NetBox yn dangos mcr1-hv-06 yn cario bathodyn statws Burn-in gwyrddlas ochr yn ochr â’r dyfeisiau eraill ar y statws safonol Active, gyda’r un steil ag unrhyw statws adeiledig

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:

Tudalen Custom Object Type NetBox ar gyfer Datastore, fersiwn 1.0.0, wedi’i ddisgrifio fel storfa a rennir y mae clwstwr yn rhoi disgiau VM arni, gyda thab Fields yn dangos 7 a phanel Fields yn rhestru Name fel Text, Cluster fel Object yn pwyntio at Virtualization > Cluster, Provisioned by fel Multiple objects yn pwyntio at DCIM > Device, Backing fel Text, Capacity (GB) fel Integer, Thin provisioned fel Boolean, a Customer fel Object yn pwyntio at Tenancy > Tenant

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:

Rhestr Datastores NetBox yn dangos pedair rhes: ds-nvme-01 ar glwstwr MCR1-PVE wedi’i darparu gan mcr1-hv-01, 02 a 03, ar gefn pwll Ceph RBD NVMe ar 40960 GB ac wedi’i darparu’n denau; ds-nvme-02; ds-archive-01 ar bwll HDD gyda NVMe WAL ar 196608 GB a heb ei darparu’n denau; a ds-ravenscroft-01 ar 8192 GB wedi’i denantio i Ravenscroft Legal

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.

Tudalen clwstwr NetBox ar gyfer MCR1-PVE, clwstwr Proxmox VE wedi’i gwmpasu i Manchester DC1, gyda thab Custom Objects yn dangos y storfeydd data sy’n cyfeirio ato

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 iBeth anfonais iCanlyniad
validation_regexgwerth nad yw’n cyfateb i ddim201 Created
required: truey maes wedi’i adael allan yn llwyr201 Created
validation_minimum: 1rhif negatif201 Created
unique: truedyblygiad400, wedi’i wrthod
on_delete_behavior: protectdileu’r gwrthrych y cyfeirir ato409, 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:

Tab interfaces NetBox ar gyfer mcr1-hv-07, dyfais a grëwyd gan y playbook, yn dangos un rhyngwyneb eno1 o fath SFP28 25GE wedi’i ddisgrifio i leaf-01 ac yn cario 10.20.22.1/24

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.

PethBeth yw eTrwydded
pynetboxY cleient Python y mae’r casgliad ei hun yn ei ddefnyddioApache 2.0
terraform-provider-netboxRheoli gwrthrychau NetBox fel adnoddau Terraform, wedi’i gynnal yn weithredol gan e-breuningerMPL 2.0
nornir_netboxNetBox fel rhestr eiddo Nornir, i bobl sy’n gwneud Python yn hytrach na YAMLApache 2.0
Prometheus SDYn rhoi ei dargedau scrape i Prometheus o NetBoxMIT
go-netboxCleient Go, er nad oes neb wedi’i gyffwrdd ers Mai 2025gweler y storfa god
DiodePiblinell amlyncu NetBox Labs ei hun ar gyfer gwthio data a ddarganfuwyd i mewnNetBox 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.


  1. 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. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  2. NetBox, LICENSE.txt — Apache License 2.0, hawlfraint DigitalOcean, LLC. Tarddiad a stiwardiaeth o’r cyflwyniad. ↩︎ ↩︎

  3. 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. ↩︎ ↩︎

  4. 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’. ↩︎

  5. 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. ↩︎

  6. 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. ↩︎

  7. 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. ↩︎

  8. netbox-community/netbox-docker — pentwr cynwysyddion y gymuned, Apache 2.0. ↩︎

  9. 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. ↩︎

  10. 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. ↩︎

  11. 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. ↩︎

  12. 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’. ↩︎

  13. Dogfennaeth netboxlabs/netbox-custom-objects — ‘Deleting a Custom Object Type drops an entire database table and should be done with caution.’ ↩︎

  14. 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. ↩︎

  15. 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. ↩︎