Igor2
@nblair2/igor2v2026.05.31.1
01README
Full igor2 cluster-manager control via the REST API, split into five models: reservations (the reservation lifecycle), hosts (power, inventory, administration, host policies), boot (distros, profiles, images, kickstarts), identity (users, groups, privilege elevation), and server (clusters/MOTD, sync, stats, config, auth-reset, dashboard).
02Models
boot.tsv2026.05.31.1
fn distro_create()
Create a boot distro by copying a distro, reusing an image, referencing an image ID, or uploading kernel+initrd
fn distro_list()
List all visible distros, storing each one
fn distro_show()
Fetch a single distro by name and store it
fn distro_edit()
Edit a distro (rename, groups, kernel args, default, etc.)
fn distro_delete()
Delete a distro
fn profile_create()
Create a boot profile (a distro plus extra kernel arguments)
fn profile_list()
List all visible profiles, storing each one
fn profile_show()
Fetch a single profile by name and store it
fn profile_edit()
Edit a profile (rename, description, kernel arguments)
fn profile_delete()
Delete a profile
fn image_register()
Register a distro image by uploading kernel+initrd files or referencing server-staged files
fn image_list()
List all registered distro images, storing each one
fn image_delete()
Delete a registered distro image by name/ID
fn kickstart_register()
Register (upload) a kickstart file
fn kickstart_list()
List all kickstart files, storing each one
fn kickstart_edit()
Replace a kickstart
fn kickstart_delete()
Delete a kickstart file
Resources
distro— An igor2 boot distro (kernel/initrd + kickstart + groups)
profile— An igor2 boot profile (a distro plus kernel arguments)
image— A registered igor2 distro image (kernel/initrd pair)
hosts.tsv2026.05.31.1
fn host_power()
Power on/off/cycle nodes, or query their power status
fn host_list()
List all hosts, storing each one
fn host_status()
Fetch a single host by name and store its state
fn host_edit()
Edit a host
fn host_delete()
Delete a host from igor2 (admin)
fn host_block()
Block or unblock hosts from being reserved (admin)
fn host_apply_policy()
Apply a host policy to a set of hosts (admin)
fn hostpolicy_create()
Create a host policy (admin)
fn hostpolicy_list()
List all host policies, storing each one
fn hostpolicy_show()
Fetch a single host policy by name and store it
fn hostpolicy_edit()
Edit a host policy (admin)
fn hostpolicy_delete()
Delete a host policy (admin)
Resources
host— An igor2 cluster host and its power/boot state
hostPolicy— An igor2 host policy (max reservation time, access groups)
powerResult— Result of a host power command
identity.tsv2026.05.31.1
fn user_create()
Create a user account (admin)
fn user_list()
List users, storing each one
fn user_show()
Fetch a single user by name and store it
fn user_edit()
Edit a user: email/fullName, change password, or force a reset
fn user_delete()
Delete a user account (admin)
fn group_create()
Create a group (optionally LDAP-backed)
fn group_list()
List groups (owned and member), storing each one
fn group_show()
Fetch a single group by name and store it
fn group_edit()
Edit a group: metadata, owners, or members (one facet)
fn group_delete()
Delete a group (admin)
fn elevate()
Activate admin privilege elevation for your session
fn elevate_status()
Check remaining time on your admin elevation
fn elevate_cancel()
Cancel your admin privilege elevation
Resources
user— An igor2 user account
group— An igor2 group (owners, members, shared distros/policies)
reservations.tsv2026.05.31.1
fn reservation_create()
Create a node reservation; idempotent (returns the existing one on conflict)
fn reservation_show()
Fetch a single reservation by name and store its state
fn reservation_list()
List all visible reservations, storing each one
fn reservation_edit()
Modify a reservation (extend, add/drop nodes, rename, re-distro, etc.)
fn reservation_delete()
Delete a reservation
server.tsv2026.05.31.1
fn cluster_list()
List clusters, storing each one
fn cluster_motd_set()
Set the cluster message-of-the-day (admin)
fn sync()
Run a network sync check (e.g. Arista VLAN reconciliation)
fn stats()
Read cluster usage statistics and store the snapshot
fn config_show()
Read the igor2 server configuration (or public settings)
fn auth_reset()
Reset the server JWT signing secret — DESTRUCTIVE: invalidates every issued token cluster-wide (admin)
fn show()
Read the cluster dashboard (cluster meta, hosts, reservations)
Resources
cluster— An igor2 cluster definition and its MOTD
dashboard— Cluster dashboard snapshot (cluster meta, hosts, reservations)
stats— An igor2 cluster usage-statistics snapshot
config— The igor2 server configuration snapshot
03Previous Versions
2026.05.30.1
Added 5, removed 1 models
2026.05.28.2
04Stats
A
100 / 100
Downloads
0
Archive size
61.1 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/nblair2/swamp-igor205Platforms
06Labels