Skip to content

Commit 994b0c5

Browse files
committed
chore: bump gateway + CLI to upstream 0.0.91
Upstream NVIDIA/OpenShell#2224 merged 2026-07-22 (first released in v0.0.90), adding TUI provider config-key form support — the fix for our issue NVIDIA/OpenShell#1798. Moving the pinned gateway and all documented CLI versions to 0.0.91 to pick it up. - values.yaml: gateway image digest 523609f8 (0.0.73) → 92e73aca (0.0.91, commit 21da343c). Comment now also warns to keep the pin in lockstep with the operator's CLI version. - inference-provider-hook.yaml: CLI_VERSION v0.0.50 → v0.0.91. This was the staler pin — the hook was still fetching a CLI from May. - install-cli.md, grpc-without-cli.md, walkthrough-claude-files.md: v0.0.50 → v0.0.91. - production-deployment.md: example gateway digest → 0.0.91. - tutorial-anthropic-direct.md: diagram label, install VERSION, and "Verified against" → 0.0.91. Also corrects a claim in the tutorial's CLI section. It previously said the gRPC contract is "compatible across recent patch releases" — that is not reliably true. A 0.0.91 CLI against the 0.0.73 gateway fails on `inference get` (response shape changed) while sandbox/provider/exec commands keep working. The section now tells operators to bump both together and cites that concrete failure. Note for macOS operators: NVIDIA's Homebrew tap (nvidia/openshell) is stale at 0.0.57 and `brew upgrade` is a no-op, so `uv tool install -U openshell` is currently the working upgrade path. Signed-off-by: st-gr <[email protected]>
1 parent b4dcedb commit 994b0c5

7 files changed

Lines changed: 29 additions & 20 deletions

File tree

‎deploy/helm/openshell-driver-kyma/templates/inference-provider-hook.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ spec:
134134
- name: MODEL_ID
135135
value: {{ .Values.inferenceProvider.modelId | quote }}
136136
- name: CLI_VERSION
137-
value: "v0.0.50"
137+
value: "v0.0.91"
138138
- name: ANTHROPIC_API_KEY
139139
valueFrom:
140140
secretKeyRef:

‎deploy/helm/openshell-driver-kyma/values.yaml‎

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -156,12 +156,17 @@ podLabels: {}
156156
gateway:
157157
enabled: false
158158
image:
159-
# Pinned to upstream `0.0.73` (commit 474d2d4a). Includes the
160-
# external-compute-driver work (NVIDIA/OpenShell#1703) and the
161-
# AWS Bedrock provider plumbing (NVIDIA/OpenShell#1704). Bump via
159+
# Pinned to upstream `0.0.91` (commit 21da343c). Includes the
160+
# external-compute-driver work (NVIDIA/OpenShell#1703), the AWS
161+
# Bedrock provider plumbing (NVIDIA/OpenShell#1704), and the TUI
162+
# provider config-key form (NVIDIA/OpenShell#2224 / #1798).
163+
# Keep this in lockstep with the `openshell` CLI version operators
164+
# install — a newer CLI against an older gateway can fail on
165+
# commands whose response shape changed (e.g. `inference get`).
166+
# Bump via
162167
# https://github.com/NVIDIA/OpenShell/pkgs/container/openshell%2Fgateway
163168
repository: ghcr.io/nvidia/openshell/gateway
164-
tag: "sha256:523609f8a2799304cda7e485138c125c9765426c04981033812717a659d0c46f"
169+
tag: "sha256:92e73acabfa3d99cc66cc4e2610de5c78617e690db1aac6d3e965c168ac7f6e7"
165170
pullPolicy: IfNotPresent
166171
grpcPort: 8080
167172
metricsPort: 9091

‎docs/grpc-without-cli.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ These pin the message types you'll send and the response shapes you'll
4747
get back. The CLI version pin you should match is the one your gateway
4848
image was built against — usually equal to the openshell-cli
4949
`OPENSHELL_CLI_VERSION` constant in the inference-provider-hook
50-
template (currently `v0.0.50`). Replace `main` with `v0.0.50` above
50+
template (currently `v0.0.91`). Replace `main` with `v0.0.91` above
5151
for an exact match.
5252

5353
## Reach the gateway

‎docs/install-cli.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ upstream releases page, and as a PyPI wheel for users who prefer `uv`.
99

1010
The CLI's gRPC contract evolves with the gateway. Pin the CLI to the
1111
same version as the gateway image you deployed (`gateway.image.tag`
12-
in the chart). At time of writing the latest is `v0.0.50`.
12+
in the chart). At time of writing the latest is `v0.0.91`.
1313

1414
If you're tracking `latest` on the gateway image, install the latest
1515
CLI release; if you bumped the gateway to a specific tag, install
@@ -20,7 +20,7 @@ that exact tag.
2020
No glibc requirement; no Python. Single binary.
2121

2222
```bash
23-
VERSION=v0.0.50
23+
VERSION=v0.0.91
2424
curl -fsSL "https://github.com/NVIDIA/OpenShell/releases/download/${VERSION}/openshell-x86_64-unknown-linux-musl.tar.gz" \
2525
| tar -xz -C /usr/local/bin
2626
openshell --version

‎docs/production-deployment.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ gateway:
6363
# driver image above). Bump via
6464
# https://github.com/NVIDIA/OpenShell/pkgs/container/openshell%2Fgateway
6565
repository: ghcr.io/nvidia/openshell/gateway
66-
tag: "sha256:523609f8a2799304cda7e485138c125c9765426c04981033812717a659d0c46f" # 0.0.73
66+
tag: "sha256:92e73acabfa3d99cc66cc4e2610de5c78617e690db1aac6d3e965c168ac7f6e7" # 0.0.91
6767
pullPolicy: IfNotPresent
6868

6969
# OIDC required for the public-APIRule path. The chart's

‎docs/tutorial-anthropic-direct.md‎

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ flowchart TB
2323
end
2424
2525
subgraph S3["3 — helm install chart 0.1.2"]
26-
POD["driver + gateway pod 2/2<br/>gateway 0.0.73, Unix socket,<br/>--drivers kyma"]
26+
POD["driver + gateway pod 2/2<br/>gateway 0.0.91, Unix socket,<br/>--drivers kyma"]
2727
HOOK["hook Job: provider create +<br/>inference set (auto-deletes)"]
2828
end
2929
@@ -284,19 +284,22 @@ See [`install-cli.md`](install-cli.md) for the full matrix. For a
284284
quick smoke test on Linux (or WSL2):
285285

286286
```bash
287-
VERSION=v0.0.75
287+
VERSION=v0.0.91
288288
curl -fsSL "https://github.com/NVIDIA/OpenShell/releases/download/${VERSION}/openshell-x86_64-unknown-linux-musl.tar.gz" \
289289
| tar -xz -C /usr/local/bin
290290
openshell --version
291291
```
292292

293293
On macOS: `brew install astral-sh/uv/uv && uv tool install -U openshell`.
294294

295-
**Pin the CLI version to the gateway image**. This tutorial pins the
296-
gateway to the digest of `0.0.73` via the chart default (see
297-
`values.yaml`), so `v0.0.75` CLI is fine — the gRPC contract is
298-
compatible across recent patch releases, but the CLI's error messages
299-
match the gateway's shape when they align.
295+
**Keep the CLI and the gateway on the same version.** This tutorial
296+
pins the gateway to the `0.0.91` digest via the chart default (see
297+
`values.yaml`), so install the matching `v0.0.91` CLI. The gRPC
298+
contract does drift between releases: a newer CLI against an older
299+
gateway can fail on individual commands whose response shape changed
300+
(we hit exactly this with `inference get` on a `0.0.91` CLI talking to
301+
a `0.0.73` gateway — sandbox and provider commands kept working, but
302+
that one broke). If you bump one, bump the other.
300303

301304
## 5. Reach the gateway + verify
302305

@@ -483,10 +486,11 @@ Run end-to-end on 2026-07-02:
483486
- Kyma / Gardener (SAP BTP), 4x `cpu-worker` amd64 nodes, Kubernetes
484487
v1.34.
485488
- Chart `openshell-driver-kyma` `0.1.2`.
486-
- Gateway image `ghcr.io/nvidia/openshell/gateway@sha256:523609f8…`
487-
(upstream NVIDIA `0.0.73`, containing NVIDIA/OpenShell#1703 and #1704),
489+
- Gateway image `ghcr.io/nvidia/openshell/gateway@sha256:92e73aca…`
490+
(upstream NVIDIA `0.0.91`, containing NVIDIA/OpenShell#1703, #1704, and
491+
the TUI config-key form #2224),
488492
pulled via the chart's default digest pin.
489-
- `openshell` CLI `v0.0.75`.
493+
- `openshell` CLI `v0.0.91`.
490494

491495
Verified end-to-end: install, gateway↔driver named-endpoint handshake
492496
(`configured_driver=kyma advertised_driver=kyma in_tree=false`),

‎docs/walkthrough-claude-files.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -501,7 +501,7 @@ kubectl -n "$NS" run cli --restart=Never --image=alpine:3.20 --command -- sleep
501501
# Inside the pod (one-time setup):
502502
kubectl -n "$NS" exec cli -- sh -c '
503503
apk add --no-cache curl rsync openssh-client &&
504-
curl -fsSL https://github.com/NVIDIA/OpenShell/releases/download/v0.0.50/openshell-x86_64-unknown-linux-musl.tar.gz \
504+
curl -fsSL https://github.com/NVIDIA/OpenShell/releases/download/v0.0.91/openshell-x86_64-unknown-linux-musl.tar.gz \
505505
| tar -xz -C /usr/local/bin &&
506506
/usr/local/bin/openshell gateway add --local http://ods-openshell-driver-kyma:8080
507507
'

0 commit comments

Comments
 (0)