Skip to content

chore(k8s): use upstream agent-sandbox manifests, install extensions#1657

Open
rmalani-nv wants to merge 1 commit into
NVIDIA:mainfrom
rmalani-nv:rmalani-nv/bump-chart-v0.4.6-extensions
Open

chore(k8s): use upstream agent-sandbox manifests, install extensions#1657
rmalani-nv wants to merge 1 commit into
NVIDIA:mainfrom
rmalani-nv:rmalani-nv/bump-chart-v0.4.6-extensions

Conversation

@rmalani-nv
Copy link
Copy Markdown
Contributor

@rmalani-nv rmalani-nv commented Jun 1, 2026

Summary

Use upstream agent-sandbox manifests directly in CI/e2e instead of vendoring them, and install the extension CRDs (SandboxClaim, SandboxTemplate, SandboxWarmPool) so future work like warm-pooling drops in without additional cluster onboarding.

Related Issue

Context: #1649 (no support matrix yet — kept docs/README on /releases/latest/download/ for that reason).

Changes

  • Drop the vendored deploy/kube/manifests/agent-sandbox.yaml.
  • e2e/with-kube-gateway.sh and tasks/scripts/helm-k3s-local.sh now apply manifest.yaml + extensions.yaml from github.com/kubernetes-sigs/agent-sandbox releases, pinned via AGENT_SANDBOX_VERSION env (default v0.4.6, overridable).
  • Update public docs (docs/kubernetes/setup.mdx, helm chart README, README.md.gotmpl) with kubectl apply for both manifests using /releases/latest/download/.
  • Add an air-gap note in docs/kubernetes/setup.mdx enumerating manifests + images operators need to mirror.

Testing

Checklist

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

@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented Jun 1, 2026

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

Copy link
Copy Markdown
Collaborator

@TaylorMutch TaylorMutch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would actually like to get away from vendoring the upstream manifests in our repo, since they change quickly and trying to keep up with vendoring is just going to create noise in the repo. Instead we should just use the upstream manifests in our CI / e2e.

Additionally I don't yet see a need for us to pin to a specific version in our public facing docs or in the readme. As we don't yet have a matrix for support (as far as I am aware we aren't seeing any incompatibilities yet, but we can be on the lookout for it; see #1649 for context as well), I'd prefer we not pin in the docs.

@TaylorMutch TaylorMutch self-assigned this Jun 1, 2026
…xtensions

Drop the vendored deploy/kube/manifests/agent-sandbox.yaml. CI and e2e
scripts now apply manifest.yaml + extensions.yaml directly from
github.com/kubernetes-sigs/agent-sandbox releases, pinned via
AGENT_SANDBOX_VERSION env (default v0.4.6, overridable) so internal
runs stay reproducible.

Public docs and the helm chart README continue to reference
/releases/latest/download/ — no OpenShell/agent-sandbox support matrix
exists yet (see NVIDIA#1649).

Adds an air-gap note in docs/kubernetes/setup.mdx enumerating the
manifests and images operators need to mirror to an internal registry.

Signed-off-by: Roshni Malani <rmalani@nvidia.com>
@rmalani-nv rmalani-nv force-pushed the rmalani-nv/bump-chart-v0.4.6-extensions branch from 9499bc6 to 7f246ec Compare June 1, 2026 20:45
local base="https://github.com/kubernetes-sigs/agent-sandbox/releases/download/${AGENT_SANDBOX_VERSION}"
echo "Applying agent-sandbox manifests (${AGENT_SANDBOX_VERSION})..."
kubectl --kubeconfig="${KUBECONFIG_TARGET}" apply -f "${base}/manifest.yaml"
kubectl --kubeconfig="${KUBECONFIG_TARGET}" apply -f "${base}/extensions.yaml"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why are extensions needed? We aren't currently using them in OpenShell.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently not used, but I'd like to use them in upcoming changes.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If they're not currently used or needed then we should add them with the related feature that utilizes them. Otherwise it just bloats the codebase and adds complexity when not required.

@rmalani-nv
Copy link
Copy Markdown
Contributor Author

Pivoted as requested:

  • Dropped the vendored deploy/kube/manifests/agent-sandbox.yaml (4120 lines gone).
  • CI/e2e apply upstream URLs directly. e2e/with-kube-gateway.sh and tasks/scripts/helm-k3s-local.sh now kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/download/${AGENT_SANDBOX_VERSION}/{manifest,extensions}.yaml. Default is v0.4.6, overridable via env so a contributor testing a candidate release doesn't need to edit files.
  • Reverted docs/README pin. docs/kubernetes/setup.mdx and the helm chart README/README.md.gotmpl go back to /releases/latest/download/... — agreed it's premature to pin publicly without the support matrix from docs: pin and document the supported agent-sandbox-controller version #1649.
  • Kept the extensions.yaml install step in CI/e2e and the public docs/README. Upstream ships SandboxClaim, SandboxTemplate, and SandboxWarmPool CRDs there — installing them now means warm-pool support drops in cleanly when we want it, no extra cluster onboarding step for operators.
  • Air-gap note added to docs/kubernetes/setup.mdx enumerating the manifests + images operators need to mirror.

@rmalani-nv rmalani-nv changed the title chore(k8s): vendor agent-sandbox v0.4.6 extensions chore(k8s): use upstream agent-sandbox manifests, install extensions Jun 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants