Omni
Talos node discovery for swamp, via Sidero Omni.
Omni is the control plane for fleets of Talos Linux machines. The @mccormick/omni/inventory model asks Omni for that fleet state and turns it into a typed swamp inventory: one node resource per managed machine (hardware, network, Talos version, cluster role, connection and readiness state), one cluster resource per cluster with rolled-up machine counts, and a single summary roll-up.
The discover method fans out across Omni's COSI resources — machine statuses, cluster-machine statuses, machine identities, and clusters — and merges them by machine UUID in one execution.
Read-only: the model only issues omnictl get calls and never mutates Omni state. Transport is the omnictl CLI authenticated with an Omni service account passed through the environment; the service-account key is supplied through a vault, marked sensitive, and redacted from logs and error text.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| endpoint | string | Omni API endpoint, e.g. https://omni.example.net |
| serviceAccountKey | string | Omni service-account key (OMNI_SERVICE_ACCOUNT_KEY); supply via |
| insecureSkipTlsVerify | boolean | Skip TLS verification for the Omni API (use only for self-signed certs) |
| omnictlPath | string | Path to the omnictl binary; override when it is not on PATH |
Resources
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned