菜单
EthernetConfig is a separate top-level Talos machine config document, not a nested field under machine.network.interfaces. Use when configuring NIC ring buffers, channels, or features on Talos nodes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | talos-ethernet-config |
| description | EthernetConfig is a separate top-level Talos machine config document, not a nested field under machine.network.interfaces. Use when configuring NIC ring buffers, channels, or features on Talos nodes. |
| when_to_use | Trigger phrases: "ring buffer", "NIC tuning", "ethtool", "EthernetConfig", "packet drops", "e1000e", "NIC configuration", "ethernet rings". |
EthernetConfigis a specific case of the general Talos multi-document config pattern. For the full picture (edit decision map, strategic merge patches, adding any document kind), see thetalos-config-editingskill.
ethernetConfig does not nest under machine.network.interfaces[]. This fails:
# WRONG — causes "unknown keys found during decoding"
machine:
network:
interfaces:
- interface: eth0
ethernetConfig: # ← does not exist here
rings:
rx: 4096
EthernetConfig is a standalone document appended after the main v1alpha1 doc:
---
apiVersion: v1alpha1
kind: EthernetConfig
name: eth0
rings:
rx: 4096
tx: 4096
Add a template file and append it in the generate task — same pattern as extension-nut-client.yaml:
provision/talos/templates/ethernet-rings.yaml:---
apiVersion: v1alpha1
kind: EthernetConfig
name: eth0
rings:
rx: 4096
tx: 4096
.taskfiles/talos/Taskfile.yaml for controlplane nodes:envsubst < templates/extension-nut-client.yaml >> /tmp/talos-patched.yaml
cat templates/ethernet-rings.yaml >> /tmp/talos-patched.yaml # ← add this line
mv /tmp/talos-patched.yaml clusterconfig/home-{{.ITEM}}.yaml
Before setting ring sizes, verify hardware limits:
TALOSCONFIG=provision/talos/clusterconfig/talosconfig
talosctl -n <node-ip> --talosconfig $TALOSCONFIG get ethernetstatus eth0 -o yaml \
| grep -A 6 "rings:"
Look for rx-max and tx-max. The Intel I219-LM (e1000e) on Lenovo M720q supports rx-max: 4096, tx-max: 4096 with a default of 256.
| Field | ethtool equivalent | Purpose |
|---|---|---|
rings.rx / rings.tx | ethtool -G | Ring buffer size |
channels | ethtool -L | RX/TX channel count |
features | ethtool -K | Driver feature flags |
wakeOnLAN | ethtool -s wol | Wake-on-LAN modes |
Audit CloudNativePG (CNPG) clusters for backup health, S3 storage bloat, and disk-space risk — schedule misconfiguration, WAL/archive_timeout churn, orphaned backups, compression, and PVC resize status. Use when investigating CNPG backup storage growth, a "storage near empty" alert on the backup target (e.g. QNAP), a crash-looping/"Not enough disk space" CNPG cluster, or doing a periodic CNPG health check.
Push an updated Coder workspace Terraform template and redeploy running workspaces onto it. Use when workspace-template/main.tf changes (resources, volumes, etc.) need to reach live Coder workspaces.
Diagnose and fix ONLYOFFICE Document Server showing "An error has occurred while opening the file" with no failed requests visible in the browser. Root cause is usually an orphaned task_result row in the docserver's Postgres DB, left over from a conversion interrupted by a pod crash/OOM/restart.
Task commands, bootstrap sequence, CI/CD, branch/PR workflow, linting, and devcontainer setup for the home-ops repository.
Use when auditing disk health, filesystem usage, or I/O on cluster nodes — especially when filesystem queries return incomplete results or a node's second drive is missing from metrics.
Use when removing, replacing, or decommissioning a Talos node — covers the correct talosctl reset workflow