add-or-replace-node

Add or replace Talos nodes in the Anton Kubernetes cluster via talosctl.

3|Updated May 13, 2025
One-click install
npx skills add https://github.com/wcygan/anton --skill add-or-replace-node
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-or-replace-node
Source: https://github.com/wcygan/anton/tree/main/.claude/skills/add-or-replace-node
Command: npx skills add https://github.com/wcygan/anton --skill add-or-replace-node

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables safe expansion, replacement, or reconfiguration of nodes in the Anton Talos-based Kubernetes cluster, including scaffolding, patch generation, and applying changes via talosctl.

Core Features & Use Cases

  • Workflow A: add a brand-new node with per-node patches and config rendering.
  • Workflow B: replace a dead node with a hardware replacement while preserving etcd quorum.
  • Workflow C: rename/remove a node, performing cleanup and config adjustments.
  • Includes safety hard rules and verification guidance for post-join health checks.

Quick Start

Provision a new node, update the Talos config, render the machine configs, and push them with talosctl.

Frequently Asked Questions about add-or-replace-node

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I replace a failed Talos node without breaking etcd quorum?

To replace a failed Talos node safely, you generate per-node patches, render the updated machine configs, and apply them via talosctl. This workflow preserves etcd quorum and maintains cluster health during the hardware replacement.

How do I add a new hardware node to a Talos Kubernetes cluster?

Adding a new Talos node involves provisioning the hardware, updating the Talos configuration, generating per-node patches, rendering machine configs, and applying the changes with talosctl to ensure proper onboarding and post-join verification.

Can I rename or remove an existing Talos node from my Kubernetes cluster?

Yes, you can rename or remove a Talos node by performing cleanup and config adjustments. The process guides you through applying changes via talosctl while preserving the overall health and etcd quorum of the cluster.

What is the safest way to generate and apply machine config patches for Talos nodes?

The safest way to apply machine config patches is through an automated workflow that renders per-node configurations and pushes them using talosctl. This ensures cluster health and maintains etcd quorum during node expansion or replacement.

What post-join verification steps are needed after adding a Talos node?

After adding a Talos node, post-join verification involves checking cluster health and ensuring the new node has successfully joined without disrupting etcd quorum. The workflow includes built-in guidance for these required health checks.