siderolabs / siderolabs/docs

talosctl - recommended version to update a cluster

Open Beginner friendly
#739 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
MDX
Stars
11
Forks
76
Avg merge
3d 5h
Merged PRs (30d)
26

Description

Path: /talos/v1.14/configure-your-talos-cluster/lifecycle-management/upgrading-talos

"The --image flag defaults to the installer image of the talosctl version in use, so it can be omitted when upgrading a machine without system extensions to the version matching talosctl."

and then:

"Q. Which version of talosctl should I use to update a cluster?
A. We recommend using the version that matches the current running version of the cluster."

Upgrading with the newer version (and less flags) looks like the easiest way to do it. Less flags, newer version ( fixed bugs? :) ) etc... But it's not recommended. It would be nice to have a small clarification in docs why is that...
Thank you.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read the page at /talos/v1.14/configure-your-talos-cluster/lifecycle-management/upgrading-talos, focusing on the --image guidance and the question about which talosctl version to use. Clarify why the version matching the cluster is recommended over a newer talosctl, and confirm the updated explanation addresses the apparent contradiction.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.