用途:为通过 Sidero Omni 与 Proxmox 基础设施提供方运行的 Talos Linux Kubernetes 集群提供运维工具,覆盖机器类(MachineClass)、集群模板、CEL 存储选择器及故障排查。
主要能力与用法:使用 ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py 管理提供方,如 --status 查状态、--logs 50 查看日志、--logs 50 --raw 输出原始 JSON 日志、--restart 重启。脚本经 Tailscale SSH 连接 Foxtrot,并通过 pct exec 执行命令;可用 OMNI_PROVIDER_HOST、OMNI_PROVIDER_CT、OMNI_PROVIDER_SERVICE、OMNI_PROVIDER_CONTAINER 覆盖默认值。常用 omnictl 命令包括 omnictl cluster status、omnictl get machines -l omni.sidero.dev/cluster=、omnictl get machineclasses、omnictl apply -f、omnictl cluster template sync -f;注意不存在 --cluster 参数,需用 -l 标签选择器。MachineClass 可指定 providerid、providerdata,含 cores、memory、disk_size、storage_selector、node 等字段。
适用场景:部署与运维基于 Omni + Proxmox 的 Talos 集群,包括 CEPH 存储、本地 LVM、GPU 透传、存储节点及多网络工作节点。
限制:提供方须与 Talos VM 处于同一 L2(Foxtrot LXC);存储选择器仅用 name,CEL 类型名保留;主机名问题需用 :local-fix 标签而非 :latest;每个模板仅允许一个 ControlPlane 段;不支持 VM 迁移,应销毁重建;DNS 采用分域解析。参考文件与示例见资料所列 references/ 与 examples/ 路径。缺失事实暂未提供。