Skip to content

Add known issue for Fleet pending-upgrade during v1.5.x to v1.6.x upgrade#977

Open
yoursweetginger wants to merge 1 commit intoharvester:mainfrom
yoursweetginger:main
Open

Add known issue for Fleet pending-upgrade during v1.5.x to v1.6.x upgrade#977
yoursweetginger wants to merge 1 commit intoharvester:mainfrom
yoursweetginger:main

Conversation

@yoursweetginger
Copy link

Problem:

The Harvester upgrade documentation for v1.5.x to v1.6.x is missing a known issue that affects users upgrading to v1.6.1. During the upgrade, the process can become stuck indefinitely at the "UpgradingSystemServices" phase while waiting for the Fleet helm chart to be deployed. The Fleet release remains in pending-upgrade status, preventing the upgrade from completing. This issue has affected production deployments and requires manual intervention to resolve, but the workaround is not currently documented.

Solution:

Added Known Issue #10 to the upgrade documentation that describes the Fleet pending-upgrade problem, including:

  • Clear description of the symptoms and how to identify the issue
  • Verification steps using helm history command
  • Complete workaround procedure (rollback Fleet chart and restart Rancher)

Related Issue(s):

Issue harvester/harvester#9738

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds documentation for a critical known issue (#10) affecting Harvester upgrades from v1.5.x to v1.6.x, where the upgrade can become stuck at the "UpgradingSystemServices" phase due to Fleet helm chart remaining in pending-upgrade status. The PR also includes formatting improvements to existing documentation, correcting indentation and spacing issues.

Changes:

  • Added Known Issue #10 documenting the Fleet pending-upgrade problem with verification steps and complete workaround procedure
  • Fixed indentation of code blocks and explanatory text to be consistent with numbered list formatting throughout the document
  • Corrected minor spacing issues (double space removal, blank line additions)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…et chart

Signed-off-by: Ilya Shchekin <komradaxon@gmail.com>
@github-actions
Copy link

Name Link
🔨 Latest commit 3f28634
😎 Deploy Preview https://69945207d0c892f9278a8130--harvester-preview.netlify.app

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