mirror of
https://github.com/NVIDIA/OpenShell.git
synced 2026-10-23 06:30:28 +08:00
Taylor Mutch
8fd574780c
* ci(helm): add OCI chart release workflow Publishes the Helm chart to ghcr.io/nvidia/openshell/helm-chart via helm push on every tag (versioned + :latest) and main push (:0.0.0-dev overwrite + :0.0.0-dev.<sha> per-commit pin). Renames Chart.yaml name to helm-chart to match the target OCI path. * ci(helm): use full sha in dev pinned chart version The container images pushed by docker-build.yml are tagged with the full $GITHUB_SHA, not a 7-char prefix. Match the chart's pinned version (0.0.0-dev.<full-sha>) so the chart tag and the image tag the chart resolves to are identical. * docs(readme): add helm chart install instructions Document the OCI chart at ghcr.io/nvidia/openshell/helm-chart with examples for tagged, floating dev, and SHA-pinned dev installs, and flag the Kubernetes deployment path as experimental. * docs(helm): split chart details into chart README Move the dev tag conventions and configuration pointers into a new README under deploy/helm/openshell/ and shorten the top-level README section to the install command (no --version, defaults to latest tagged semver) plus a link to the chart README.
OpenShell Helm Chart
Experimental — the Kubernetes deployment path is under active development. Expect rough edges and breaking changes.
This chart deploys the OpenShell gateway into a Kubernetes cluster. It is published as an OCI artifact to GHCR at oci://ghcr.io/nvidia/openshell/helm-chart.
Install
helm install openshell oci://ghcr.io/nvidia/openshell/helm-chart --version <version>
Available versions
| Tag | Source | Notes |
|---|---|---|
<semver> (e.g. 0.6.0) |
Tagged GitHub release | Tracks the matching gateway and supervisor image versions. Recommended for production. |
0.0.0-dev |
Latest commit on main |
Floating tag, overwritten on every push. appVersion is dev, so images resolve to the :dev tag. |
0.0.0-dev.<commit-sha> |
A specific commit on main |
Per-commit pin. Chart version and appVersion both use the full 40-character commit SHA, which matches the image tag pushed by CI. |
The dev tags are intended for testing changes ahead of a release. Production deployments should pin to a tagged release.
Configuration
See values.yaml for configurable values. Selected overlays:
values-gateway.yaml— gateway-only configurationvalues-cert-manager.yaml— cert-manager integrationvalues-keycloak.yaml— Keycloak OIDC integration