Skip to content

Helm chart 0.1.3 on gh-pages contains unreleased changes from main #288

@WentingWu666666

Description

@WentingWu666666

Describe the bug

The Helm chart published to GitHub Pages (https://documentdb.github.io/documentdb-kubernetes-operator/index.yaml) advertises version 0.1.3, but its contents have drifted from the actual v0.1.3 release. The deploy_docs.yml workflow re-packages and overwrites the published 0.1.3 chart on every push to main that touches operator/documentdb-helm-chart/**, so the .tgz served to users silently includes post-release changes.

Evidence:

  • index.yaml shows created: "2026-03-05T15:52:05" rebuilt today, not at the original release time.
  • The dependencies section lists cloudnative-pg: 0.27.0, but CNPG was only upgraded to 0.27.0 after the 0.1.3 release was cut.
  • The actual 0.1.3 release should have had the older CNPG dependency version.

To Reproduce

  1. Run helm repo add documentdb https://documentdb.github.io/documentdb-kubernetes-operator
  2. Run helm repo update
  3. Run helm pull documentdb/documentdb-operator --version 0.1.3 --untar
  4. Inspect documentdb-operator/Chart.yaml note the cloudnative-pg dependency is 0.27.0
  5. Compare with the v0.1.3 Git tag the dependency version differs

Expected behavior

Running helm install documentdb/documentdb-operator --version 0.1.3 should install the exact chart that was released with v0.1.3, not a version that includes unreleased changes from main.

Root cause

The .github/workflows/deploy_docs.yml workflow (lines 4753) runs helm package and helm repo index on every push to main that modifies operator/documentdb-helm-chart/**. Because Chart.yaml still reads version: 0.1.3, each merge overwrites the published 0.1.3 .tgz with whatever is currently on main.

Suggested fix

Either:

  1. Only publish the Helm chart on release events remove the chart packaging from the docs workflow and trigger it from the release workflow instead, or
  2. Bump Chart.yaml to a dev pre-release version immediately after each release (e.g., 0.1.4-dev) so that pushes to main never overwrite a released version.

Kubernetes Environment (please complete the following information):

  • DocumentDB Operator Version: 0.1.3 (Helm chart)
  • Kubernetes Version: N/A (packaging/CI issue, not runtime)
  • Kubernetes Environment: N/A
  • Cert Bot Version: N/A
  • CNPG Version: 0.27.0 (incorrectly shipped in the 0.1.3 chart)

Additional context

  • Relevant workflow file: .github/workflows/deploy_docs.yml
  • Helm repo index URL: https://documentdb.github.io/documentdb-kubernetes-operator/index.yaml

Metadata

Metadata

Labels

bugSomething isn't working

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions