-
Notifications
You must be signed in to change notification settings - Fork 5
Open
Milestone
Description
Due to the Bitnami Changes concerning the provisioning of docker images, the following changes need to be conducted and a release needs to be done:
Manual: Migrating Helm Images From Bitnami to BitnamiLegacy
Context
The official Bitnami Helm images have been deprecated or is no longer maintained in its previous location. Bitnami has migrated legacy container images to a new repository called bitnamilegacy
. Helm charts using Bitnami container images must be updated to reference this new source to ensure continued functionality. With bitnamilegacy
we wont receive security updates. After 25.09 we have to think about this fact.
This guide will help you:
- Override configuration where Bitnami container images are used.
- Create a chart patch version to reflect these changes.
- Override Bitnami Container Image SourcesWherever Bitnami charts are and container images are used in your helm charts and deployments, you need to override the registry and tag. For a helm chart this can be done in the section of the product. Having the chart as a dependency allows you to override the available options present in the dependent chart.
Example for postgresql:
Old:
postgresql:
# other values
enabled: false
# ...
New (if needed):
postgresql:
image:
repository: bitnamilegacy/postgresql
tag: 15.4.0-debian-11-r45
# other values
enabled: false
# ...
Notes:
- Depending on your chart, the image repository may not need to change, but you should check for any deprecations or updated instructions in the BitnamiLegacy documentation.
- You can use the same tag as used in the bitnami chart used.
- For other products, just replace the product name and tag version in the yaml structure and the fields
image.repository
andimage.tag
.
- Increase the Patch Version
Since this is a non-breaking, maintenance-related change, increase the patch version of your Helm chart.
For example, in yourChart.yaml
:
Old:
version: 1.2.3
New:
version: 1.2.4
- Test Your Chart
- Run
helm dependency update
to refresh dependencies. - Install or upgrade your chart in a test environment to ensure there are no breaking changes.
- Document the Change in Your Migration Guide or Changelog
Add a release note or migration guide entry like:
2025-08-27: Migrated Bitnami chart dependencies to the BitnamiLegacy repository. Please ensure you update your dependencies and override container image repositories if required.
Summary Checklist
- Override container image repository if needed
- Bump chart patch version
- Test the chart
- Update your migration guide or changelog
Example pull request, which already did the changes PR 956
Metadata
Metadata
Assignees
Labels
No labels
Type
Projects
Status
IN REVIEW