Skip to content

Task: Update Bitnami Images #305

@CDiezRodriguez

Description

@CDiezRodriguez

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 Charts From Bitnami to BitnamiLegacy

Context

The official Bitnami Helm chart repository has 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 Sources

Wherever Bitnami charts are and container images are used in you 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. Please note that you can check your association integration test deployments via the app-dashboard.
  • For other products, just replace the product name and tag version in the yaml structure and the fields image.repository and image.tag.

2. 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

3. Rebuild and 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.

4. 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 -> puris#956

Please dont forget to switch all your container images such as keycloak, postgresql and more.

Metadata

Metadata

Labels

bugSomething isn't working

Type

Projects

Status

Done

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions