omni-talos
This skill provides operational tooling and guidance for Omni Proxmox infrastructure. Use when the user asks to "check provider status", "restart provider", "view provider logs", "debug provider registration", "create a machine class", "configure Proxmox provider", "set up CEL storage selectors", "create a Talos cluster", or needs guidance on Omni + Proxmox infrastructure integration for Talos Kubernetes clusters.
From omni-scalenpx claudepluginhub basher83/lunar-claude --plugin omni-scaleThis skill uses the workspace's default tool permissions.
examples/cluster-template.yamlexamples/machineclass-ceph.yamlexamples/machineclass-local.yamlexamples/proxmox-gpu-worker.yamlexamples/proxmox-storage-node.yamlexamples/proxmox-worker-multi-net.yamlreferences/architecture.mdreferences/cel-storage-selectors.mdreferences/cluster-templates.mdreferences/debugging.mdreferences/gitops-bootstrap-issues.mdreferences/machine-classes.mdreferences/omnictl-auth.mdreferences/provider-setup.mdreferences/proxmox-permissions.mdreferences/recovery-procedures.mdscripts/provider-ctl.pyOmni + Proxmox Infrastructure Provider
Operational tooling for Talos Linux Kubernetes clusters via Sidero Omni with Proxmox infrastructure provider.
Provider Operations
Use ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py for provider management:
| Task | Command |
|---|---|
| View logs | ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py --logs 50 |
| Raw JSON logs | ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py --logs 50 --raw |
| Restart provider | ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py --restart |
The provider runs on Foxtrot LXC (CT 200) — script handles SSH automatically.
Current Deployment
| Component | Location | IP | Endpoint |
|---|---|---|---|
| Omni | Holly (VMID 101, Quantum) | 192.168.10.20 | omni.spaceships.work |
| Proxmox Provider | Foxtrot LXC (CT 200, Matrix) | 192.168.3.10 | L2 adjacent to Talos VMs |
| Target Cluster | Matrix (Foxtrot/Golf/Hotel) | 192.168.3.{5,6,7} | Proxmox API |
| Storage | CEPH RBD | — | vm_ssd pool |
Quick Reference
omnictl commands:
omnictl cluster status <cluster-name>
omnictl get machines -l omni.sidero.dev/cluster=<cluster-name>
omnictl get machineclasses
omnictl apply -f machine-classes/<name>.yaml
omnictl cluster template sync -f clusters/<name>.yaml
Note: --cluster flag does not exist. Use label selector -l instead.
MachineClass minimal example:
metadata:
namespace: default
type: MachineClasses.omni.sidero.dev
id: matrix-worker
spec:
autoprovision:
providerid: matrix-cluster
providerdata: |
cores: 4
memory: 16384
disk_size: 100
storage_selector: name == "vm_ssd"
node: foxtrot
See references/machine-classes.md for full field reference.
Key Constraints
| Constraint | Details |
|---|---|
| L2 adjacency | Provider MUST be on same L2 as Talos VMs (Foxtrot LXC) |
CEL type reserved | Use name only for storage selectors |
| Hostname bug | Use :local-fix tag, not :latest |
| No CP pinning | Omni allows only 1 ControlPlane section per template |
| No VM migration | Destroys node state — destroy/recreate instead |
| Split-horizon DNS | omni.spaceships.work → 192.168.10.20 (LAN) |
Reference Files
| File | Content |
|---|---|
references/architecture.md | Network topology, design decisions |
references/machine-classes.md | Full provider data fields (compute, storage, network, PCI) |
references/provider-setup.md | Provider config, compose setup, credentials |
references/cluster-templates.md | Cluster template structure, patches |
references/cel-storage-selectors.md | CEL syntax and patterns |
references/debugging.md | Common issues |
references/recovery-procedures.md | Recovery from stuck states |
references/proxmox-permissions.md | API token setup |
references/omnictl-auth.md | Authentication methods |
Examples
| File | Description |
|---|---|
examples/machineclass-ceph.yaml | CEPH storage |
examples/machineclass-local.yaml | Local LVM |
examples/cluster-template.yaml | Complete cluster |
examples/proxmox-gpu-worker.yaml | GPU passthrough |
examples/proxmox-storage-node.yaml | Storage node |
examples/proxmox-worker-multi-net.yaml | Multi-network |