Helm Upgrade Operation
The helm upgrade command updates a release to a new version of a chart, or updates the configuration values of the existing release.
The following table outlines the steps, descriptions, and corresponding command examples for upgrading a Helm release:
| Step | Description | Command Example |
| 1. Update Repository | Ensure your local Helm repository is up-to-date to fetch the latest charts. | helm repo update |
| 2. Get Release Name | Identify the existing release name you want to upgrade. | helm list |
| 3. Perform Upgrade | Execute the upgrade command. Include the release name, the chart reference/path, and any updated values files (-f) or set arguments. It is best practice to use --version to specify the exact target chart version for a controlled upgrade. | helm upgrade link-release link/link-chart --version 5.0.0 -f updated-values.yaml |
| 4. Verify Status | Check the status of the release and the deployed resources. | helm status link-release |
| Error Example | If the upgrade fails due to an invalid manifest or a failed hook, the new revision may be marked as FAILED in the history. | Error: UPGRADE FAILED: manifest_error... |
| Rollback Option | The --atomic flag can be used to automatically roll back to the previous stable release on upgrade failure. | helm upgrade --atomic link-release link/link-chart --version 5.0.0 |