Skip to content

Add additional info and steps to local node upgrade process#7496

Open
Binarytales wants to merge 1 commit into
k0sproject:mainfrom
Binarytales:docs-upgrade-process
Open

Add additional info and steps to local node upgrade process#7496
Binarytales wants to merge 1 commit into
k0sproject:mainfrom
Binarytales:docs-upgrade-process

Conversation

@Binarytales

Copy link
Copy Markdown

Description

  • Link to backup and restore page
  • Note to upgrade controllers before workers
  • Recommendation to rerun sysinfo
  • Section about passing a specific version to download script
  • Note that skipping minor versions is not supported

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update

How Has This Been Tested?

  • Manual test
  • Auto test added

Verified manually by building and running docs locally using make docs-serve-dev

Checklist

  • My code follows the style guidelines of this project
  • My commit messages are signed-off
  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published in downstream modules
  • I have checked my code and corrected any misspellings

- Link to backup and restore page
- Note to upgrade controllers before workers
- Recommendation to rerun sysinfo
- Section about passing a specific version to download script
- Note that skipping minor versions is not supported

Signed-off-by: Jon Linklater-Johnson <jon@binarytales.com>
@Binarytales Binarytales requested review from a team as code owners April 17, 2026 16:24

@juanluisvaladas juanluisvaladas left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are a few changes required but overall this looks like an improvement to me, thank you

Comment thread docs/upgrade.md
If you need to upgrade to a specific version you can set a `K0S_VERSION` for the download script.

```shell
curl --proto '=https' --tlsv1.2 -sSf https://get.k0s.sh | sudo K0S_VERSION=v1.32.11+k0s.0 sh

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
curl --proto '=https' --tlsv1.2 -sSf https://get.k0s.sh | sudo K0S_VERSION=v1.32.11+k0s.0 sh
curl --proto '=https' --tlsv1.2 -sSf https://get.k0s.sh | sudo K0S_VERSION={{{ k0s_version }}} sh

Comment thread docs/upgrade.md
- [Upgrade a k0s node locally](#upgrade-a-k0s-node-locally)
- [Upgrade a k0s cluster using k0sctl](#upgrade-a-k0s-cluster-using-k0sctl)

A [backup](docs/backup.md) of k0s managed parts of your cluster can be made before upgrading.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A [backup](docs/backup.md) of k0s managed parts of your cluster can be made before upgrading.
A [backup](backup.md) of k0s managed parts of your cluster can be made before upgrading.

Comment thread docs/upgrade.md
curl --proto '=https' --tlsv1.2 -sSf https://get.k0s.sh | sudo sh
```

It is recommended to rerun pre-flight checks, especially when upgrading between minor versions (eg from v1.34.x to v1.35.x). This will flag possible breaking changes. Refer to [external runtime dependencies](docs/external-runtime-deps.md) if there are any failures.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
It is recommended to rerun pre-flight checks, especially when upgrading between minor versions (eg from v1.34.x to v1.35.x). This will flag possible breaking changes. Refer to [external runtime dependencies](docs/external-runtime-deps.md) if there are any failures.
It is recommended to rerun pre-flight checks, especially when upgrading between minor versions (eg from v1.34.x to v1.35.x). This will flag possible breaking changes. Refer to [external runtime dependencies](external-runtime-deps.md) if there are any failures.

@github-actions

Copy link
Copy Markdown
Contributor

The PR is marked as stale since no activity has been recorded in 30 days

@github-actions github-actions Bot added Stale and removed Stale labels May 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants