Recommendation against the use of the --atomic flag for Rancher helm chart upgrades
This document (000021304) is provided subject to the disclaimer at the end of this document.
Environment
A Rancher v2.x instance installed via Helm chart
Situation
Rancher upgrades using the Helm CLI
Resolution
Do not use the --atomic
flag for Rancher upgrades using Helm
Cause
The helm --atomic
flag, causes helm to rollback any changes made in case of a failed helm chart upgrade.
Hypothetically, if the Rancher Deployment portion of the upgrade succeeds and new Rancher Pods start running, and making configuration state changes to the Rancher custom resources, but the helm upgrade then fails on another resource within the chart for any reason, a helm rollback would be automatically performed if the --atomic
flag is used.
Rancher Helm chart version rollbacks, without a restore of Rancher state, are not supported and this may result in a broken state, with partially upgraded Rancher state, but with the older Rancher version running.
For Rancher rollbacks in the case of a failed Rancher upgrade you should refer to the Rancher rollback documentation, using the Rancher backup operator, or a cluster-level restore, using the appropriate restore method for your local Rancher cluster (per the respective RKE, RKE2 and K3s documentation).
Disclaimer
This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.