Skip to content

Task: Update Bitnami Images #197

@typecastcloud

Description

@typecastcloud

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.
  1. 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 and image.tag.
  1. Increase the Patch Version
    Since this is a non-breaking, maintenance-related change, increase the patch version of your Helm chart.
    For example, in your Chart.yaml:
    Old:
version: 1.2.3

New:

version: 1.2.4
  1. 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.
  1. 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
No labels

Type

Projects

Status

IN REVIEW

Relationships

None yet

Development

No branches or pull requests

Issue actions