External IPAM authority: NetBox driver, ownership, reconcile
CI / agent (push) Successful in 2s
CI / site (push) Successful in 2s
CI / go (push) Successful in 35s

Every address Rollcall hands out is registered in the configured authority
first; addresses others hold there are skipped. Rollcall's records carry the
tag `rollcall` and the machine ID in the `rollcall_machine` custom field;
only those are changed or deleted. Releases trigger a reconcile that also
runs periodically. dns_name per address feeds the site's DNS sync. Delegated
prefixes can be listed and imported as subnets. `rollcall ipam`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Ilker ManapandClaude Opus 5.5 committed 2026-10-28 09:35:21 +01:00
1 parent c8465c235a
commit 2706fd65e7
14 files changed
+1068 -6

No files matched your search

+48
View File
@@ -480,6 +480,54 @@ Verified in the lab: Debian 13 (with a bond and VLAN), Rocky 9 and AlmaLinux 9
dual-stack on two segments, AAAA lookups through dnsmasq, the admin CLI over
`https://[fdc3:...]`.
## External IPAM (NetBox; Infoblox-style)
Rollcall works on its own, but at a site with an established network plan the
address authority is somewhere else. With `ipam` in `config.json` every
address Rollcall hands out is registered there first:
```json
"ipam": {
"provider": "netbox",
"url": "https://netbox.int.example.com",
"token_file": "/etc/rollcall/netbox.token",
"ca_file": "/etc/rollcall/netbox-ca.pem",
"dns_zone": "int.example.com",
"sync_interval": "5m"
}
```
- **Allocation asks the authority.** An address that exists in NetBox and is
not Rollcall's is skipped and the next candidate is tried, so Rollcall never
collides with a printer, a VIP or another team's reservation. If NetBox is
unreachable, allocation fails instead of guessing.
- **Ownership is explicit.** Rollcall's records carry the tag `rollcall` and the
machine ID in the custom field `rollcall_machine` (create both in NetBox;
on Infoblox these are an extensible attribute). Records without both are
never changed or deleted, only reported.
- **Releases reconcile.** Releasing, unassigning or deleting a machine frees
addresses locally and triggers a reconcile, which also runs every
`sync_interval`: missing records are created, names and owners fixed, and
Rollcall-owned records that are no longer in use deleted.
- **DNS follows the record.** `dns_name` is `<host>.<zone>` for a machine's
provisioning/mgmt address and `<host>-<iface>.<zone>` elsewhere (a subnet's
`domain` overrides the zone). A NetBox-to-DNS sync (PowerDNS here, a host
record on Infoblox) publishes it; Rollcall writes one object per address.
- **Prefixes are delegated in NetBox.** Tag a prefix `rollcall`;
`rollcall ipam prefixes` lists them and `rollcall ipam import` creates the
missing subnets (VLAN and rack are then set as usual).
```
rollcall ipam # provider, last reconcile
rollcall ipam sync -dry # what would change
rollcall ipam sync
rollcall ipam prefixes | import
```
The provider is an interface (reserve, owned records, update, delete,
delegated prefixes); the NetBox driver is the first. An Infoblox WAPI driver
maps them to `record:host`/`fixedaddress` with extensible attributes.
## Lab
`lab/` documents a Proxmox SDN test setup: an isolated vnet, a PXE server VM