44 lines
2.2 KiB
Markdown
44 lines
2.2 KiB
Markdown
# Nautobot-Tooling
|
|
|
|
## `ingest-baseline.py`
|
|
Idempotenter Basisdaten-Ingest (Locations, Rollen, Device-Types, Devices, VLANs/Prefixes,
|
|
ap1-Interfaces + IPs, WLAN-Modelle). Bildet den **Ist-Zustand** ab, nicht den Zielzustand.
|
|
|
|
```bash
|
|
export NAUTOBOT_TOKEN=... # aus docs/nas-vlan20/stacks/210-nautobot.yml (gitignored)
|
|
python3 nautobot/ingest-baseline.py # Dry-Run
|
|
python3 nautobot/ingest-baseline.py --apply # schreiben
|
|
```
|
|
|
|
### API-Fallen (teuer gelernt)
|
|
- **`tagged_vlans` liest sich per REST als `null`, obwohl korrekt gespeichert.** Verifikation
|
|
nur über GraphQL: `POST /api/graphql/` mit
|
|
`{interfaces(device:"ap1"){name mode untagged_vlan{vid} tagged_vlans{vid}}}`.
|
|
- Relationen kommen ohne `?depth=1` ohne `display` → ein voll gepflegtes Device sieht leer aus.
|
|
- `LocationType.content_types` muss `ipam.vlangroup`/`ipam.vlan`/`ipam.prefix`/`dcim.controller`
|
|
enthalten, sonst 400 beim Anlegen.
|
|
- `parent_interface` nur für virtuelle Interfaces — WLAN-VAPs können ihren Master nicht als
|
|
Parent tragen.
|
|
- `WirelessNetwork` hat **kein** VLAN-Feld; die VLAN-Bindung hängt an
|
|
`wireless/controller-managed-device-group-wireless-network-assignments` und braucht zwingend
|
|
einen `Controller` (bei uns logisch, `controller_device` leer — kein CAPsMAN).
|
|
- `RadioProfile.channel_width` will Integer (`[20,40,80]`), nicht `"20mhz"`.
|
|
- IP↔Interface läuft über `/ipam/ip-address-to-interface/`.
|
|
|
|
## `ingest-wifi-access-list-rule.py`
|
|
Legt ComplianceFeature + ComplianceRule **`wifi-access-list`** an (Plattform RouterOS,
|
|
`match_config=/interface wifi access-list`). Idempotent, Dry-Run ist Standard.
|
|
|
|
```bash
|
|
export NAUTOBOT_TOKEN=...
|
|
python3 nautobot/ingest-wifi-access-list-rule.py --apply
|
|
```
|
|
|
|
**Warum es die Rule braucht:** ohne sie erzeugen Eintraege in der access-list **keinen Drift**
|
|
und lassen sich nicht als Config-Transaktion fuehren -- `gc-transaktion.py` verlangt eine
|
|
ComplianceRule als `--scope`. `docs/tp25-pin-s22.sh` schreibt dort bei jedem Messrundgang, und
|
|
TP25 Fund E (`signal-range`-Boden) landet dauerhaft dort.
|
|
|
|
**Der Soll-Zustand ist leer** und steht als Kommentarblock `[6c]` im Template. Waehrend eines
|
|
Messlaufs ist der Drift **erwartet** und gehoert als offene Transaktion gefuehrt.
|