upgrade-talos-or-k8s

Perform rolling Talos OS or Kubernetes upgrades with etcd quorum checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rolling upgrades for Anton's Talos OS or Kubernetes are performed patch-by-patch with etcd quorum checks.

Core Features & Use Cases

  • Per-node, serial upgrades: upgrade control planes first, then workers, with health gates between nodes.
  • OS and Kubernetes version bumps: bump talosVersion or kubernetesVersion pins in talos/talenv.yaml and re-render configs.
  • Safety workflows: pre-flight checks, etcd snapshots, health checks, and a clear rollback path for failed upgrades.
  • Use Case: You need to upgrade a three-node cluster from Talos v1.X to v1.Y while maintaining quorum and service health.

Quick Start

Bump the desired version pin in talos/talenv.yaml, re-render machine configs, and run the appropriate rolling upgrade workflow.

Frequently Asked Questions about upgrade-talos-or-k8s

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

FAQPage Schema
How do I safely perform a rolling upgrade on a Talos OS Kubernetes cluster?

Safe rolling upgrades require upgrading control planes before workers, node-by-node, with health gates between nodes. You must maintain etcd quorum checks throughout the process and use a clear rollback path if failures occur.

How does etcd quorum validation work during Kubernetes control plane upgrades?

Etcd quorum validation during Kubernetes control plane upgrades works by enforcing per-node health gates between sequential patch updates. This strict sequencing ensures your cluster maintains a healthy quorum before proceeding to the next control plane node.

What is the process for bumping the Talos OS version in a Kubernetes cluster?

To bump the Talos OS version, update the talosVersion pin in talos/talenv.yaml, re-render the machine configs, and execute the rolling upgrade workflow to apply the patch-by-patch updates across your nodes.

Can I upgrade both Talos OS and Kubernetes versions at the same time?

Yes, the workflow covers both OS and Kubernetes version bumps. You update the respective version pins in talos/talenv.yaml, re-render configurations, and apply the upgrades sequentially across your nodes while maintaining health gates.

What pre-flight checks are needed before a Talos cluster upgrade?

Required pre-flight checks for a Talos cluster upgrade include taking etcd snapshots, validating cluster health, and verifying version pin management in talenv.yaml. These steps ensure consistency and provide a rollback path for failed upgrades.

How do I handle a failed Kubernetes node upgrade in Talos?

To handle a failed Kubernetes node upgrade in Talos, utilize the predefined rollback path. The workflow's strict sequencing and per-node health gates isolate failures, allowing you to safely revert the failed node without losing etcd quorum.