Skip to content

chore(helm): rename the gateway chart to openshell - #5823

Draft
SDAChess wants to merge 1 commit into
chore/4554-quay-image-defaults/SDAChessfrom
chore/4554-helm-chart-rename/SDAChess
Draft

SDAChess wants to merge 1 commit into
chore/4554-quay-image-defaults/SDAChessfrom
chore/4554-helm-chart-rename/SDAChess

Conversation

@SDAChess

Copy link
Copy Markdown
Contributor

Summary

Helm derives the OCI artifact name from the chart name. The chart is published to oci://quay.io/ai-openshell/charts/openshell after the repository transfer, so this renames it from helm-chart to openshell and points the install instructions at the new location.

Draft until the transfer is done. It merges together with #5808, which pushes charts to Quay and reads the chart name from Chart.yaml. Without this rename, #5808 would push to charts/helm-chart, which does not exist on Quay. With this rename but without #5808, the current release action looks up helm-chart on GHCR and pushes the renamed chart to oci://ghcr.io/nvidia/openshell/openshell.

Stacked on #5822.

Related Issue

Refs #4554

Changes

  • deploy/helm/openshell/Chart.yaml: name: openshell.
  • Chart README template and generated README, and the comment in ci/values-namespace-admin.yaml: oci://quay.io/ai-openshell/charts/openshell.
  • tests/tmachine/config.nix: the locally packaged chart is now openshell-0.0.0.tgz.

Upgrade safety

values.yaml sets nameOverride: openshell, so openshell.name and openshell.fullname do not depend on .Chart.Name. A rendered diff of helm template before and after, for the defaults and ci/values-supervisor.yaml, changes only:

  • the helm.sh/chart label (helm-chart-0.0.0 to openshell-0.0.0, on 19 and 24 resources),
  • the # Source: comments,
  • the gateway config checksum annotation, because the ConfigMap's labels changed.

Resource names, selectors and app.kubernetes.io/name do not change, so helm upgrade of a release installed from helm-chart updates the same objects. The checksum change rolls the gateway pods once, which the image change in #5822 does anyway.

Release Notes

The OpenShell Helm chart is published as oci://quay.io/ai-openshell/charts/openshell. Existing releases installed from oci://ghcr.io/nvidia/openshell/helm-chart upgrade in place.

Testing

  • Checks appropriate to the affected code and behavior pass

  • Unit tests added/updated (if applicable)

  • E2E tests added/updated (if applicable)

  • helm lint with the defaults and every ci/values-*.yaml.

  • helm unittest: 499/499 and 7/7.

  • test-split-ownership.sh, test-gateway-resource-coherence.sh and test-supervisor-pool-scaling.sh.

  • The README matches helm-docs 1.14.2 output.

  • helm package deploy/helm/openshell writes openshell-0.0.0.tgz, the path tests/tmachine/config.nix now uses.

Not verified: no real helm upgrade from a helm-chart release on a cluster, and no tmachine k3s run.

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)
  • Architecture docs updated (if applicable)

The chart is published to oci://quay.io/ai-openshell/charts/openshell
after the repository transfer, and Helm derives the OCI artifact name
from the chart name. Rename the chart from helm-chart to openshell and
point the install instructions at the new location.

values.yaml sets nameOverride to openshell, so resource names and
selectors do not depend on the chart name. Only the helm.sh/chart label
changes, which rolls the gateway pods once through the config checksum.

Refs #4554

Signed-off-by: Simon Scatton <sscatton@nvidia.com>
@github-actions github-actions Bot added the state:accepted A maintainer decided OpenShell should pursue this issue label Nov 20, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

state:accepted A maintainer decided OpenShell should pursue this issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant