Skip to main content

Omni

@dataverket/omniv2026.09.19.4· 1d agoMODELS
01README

Talos fleet discovery for swamp, via Sidero Omni. @dataverket/omni/inventory asks Omni for its fleet state and writes a typed inventory: one node per managed machine (hardware, network, Talos version, cluster role, connection and readiness), one cluster per cluster, and a summary roll-up. talosconfig mints one cluster's admin talosconfig for the service account and stores it, with the cluster's node IPs, as one resource: everything @dataverket/talosctl/node needs to reach the machines through Omni's proxy; every verb spoken to the Talos API lives on that model, so a lab cluster on plain talosctl and an Omni fleet share one code path. Forked from @mccormick/omni (MIT). The volumes method of 2026.09.19.1 moved to @dataverket/talosctl/node. Read-only against Omni: omnictl get and omnictl talosconfig only, authenticated with an Omni service account passed through the environment; the key comes from a vault, is marked sensitive, and is redacted from logs and errors.

02Models1
@dataverket/omni/inventoryv2026.09.19.4inventory.ts

Global Arguments

ArgumentTypeDescription
endpointstringOmni API endpoint, e.g. https://omni.example.net
serviceAccountKeystringOmni service-account key (OMNI_SERVICE_ACCOUNT_KEY); supply via
insecureSkipTlsVerifybooleanSkip TLS verification for the Omni API (use only for self-signed certs)
omnictlPathstringPath to the omnictl binary; override when it is not on PATH
fn discover()
Query Omni for every managed Talos machine and cluster and write
fn talosconfig(cluster: string)
Mint one cluster's admin talosconfig for the service account and store it with the cluster's node IPs as a talosconfig resource. The config names an identity and Omni's proxy, no key; nothing is written to ~/.talos/config. Read-only against Omni.
ArgumentTypeDescription
clusterstringOmni cluster name

Resources

node(30d)— An Omni-managed Talos machine
cluster(30d)— A Talos cluster managed by Omni
summary(30d)— Roll-up of one Omni inventory run
talosconfig(30d)— How to reach one cluster: its admin talosconfig for the service account and its machines' node IPs; a talosctl model takes both by CEL. The config carries an identity, not a key
03Previous Versions3
2026.09.19.3
2026.09.19.2

Modified 1 models. updated labels

2026.09.19.1
04Stats
A
100 / 100
Downloads
1
Archive size
17.6 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
05Platforms
06Labels