External IPAM authority: NetBox driver, ownership, reconcile
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:
1 parent
c8465c235a
commit
2706fd65e7
14 files changed
+1068
-6
No files matched your search
@@ -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
|
||||
|
||||
Reference in new issue
Block a user