bug: Kubernetes v1beta1 stop-start can hang waiting for supervisor readiness
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 48/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- github-actions, kubernetes
- Domain
- ci-cd, infrastructure, testing
Research direction
Start by running the Kubernetes E2E workflow with the sandbox-lifecycle stop/start scenario and inspect the replacement supervisor pod and readiness-probe logs. Trace the replacement supervisor's startup and gateway reconnect path; done means the v1beta1 scenario completes reliably, a regression or stress test covers it, and failures identify the blocked startup stage rather than only a 120-second CLI timeout.
Written by the indexing model from the issue text.
Description
User Story
As an OpenShell contributor, I want the Kubernetes sandbox stop/start lifecycle test to complete reliably, so that required CI reflects product regressions instead of intermittent supervisor startup hangs.
Problem Statement
The Kubernetes Agent Sandbox v1beta1 E2E lane intermittently times out during the sandbox-lifecycle stop/start scenario. The gateway completes StartSandbox successfully and Kubernetes starts the replacement supervisor pod, but the supervisor never creates its readiness socket or reconnects to the gateway. Its only log line is Starting sandbox supervision.
The same v1beta1 lane passed on the preceding commit with identical Kubernetes code, while the v1alpha1, workspace-managed, workspace-operator, and external-driver Kubernetes lanes passed in the failing run.
Failed job: https://github.com/NVIDIA/OpenShell/actions/runs/35776641970/job/106915241802
Manual retry: https://github.com/NVIDIA/OpenShell/actions/runs/35776641970/job/106938509231
Impact / Why This Matters
This intermittently fails the required Core E2E gate, delays otherwise valid pull requests, and consumes additional CI capacity through manual reruns. A generic 120-second CLI timeout also makes the underlying supervisor startup stage difficult to diagnose. Retrying the job is the current workaround, but it does not prevent recurrence or protect the stop/start lifecycle from real regressions.
Acceptance Criteria
- The v1beta1 stop/start scenario no longer intermittently stalls after the replacement supervisor pod starts.
- A regression test or repeatable stress test covers stop followed by start and verifies that the replacement supervisor reconnects and becomes ready.
- If supervisor startup cannot complete, CI reports the blocked startup stage or cause instead of only timing out at the CLI after 120 seconds.
- The existing v1alpha1 and other Kubernetes deployment-mode E2E lanes continue to pass.
Reproduction Steps
- Run the Kubernetes E2E workflow with Agent Sandbox v0.5.0 and the
sandbox-lifecycleconformance scenario. - Create a sandbox and wait for it to become ready.
- Stop the sandbox.
- Start the sandbox again.
- Intermittently, observe
openshell sandbox starttime out after 120 seconds while the replacement supervisor pod remains unready.
Environment
- OpenShell:
0c6c60c1eb70b1c4bc8e8a4f6e06d74ea09069bc - OS: Linux amd64 GitHub Actions runner
- Runtime, deployment, or integration: kind Kubernetes cluster, Agent Sandbox API v1beta1, Agent Sandbox controller v0.5.0
Logs
[sandbox-lifecycle/stop-start/start] timed out after 120.0s
command: openshell sandbox start ct-869gjwhrud-ss
[pod/os-supervisor-.../supervisor] Starting sandbox supervision
Readiness probe failed: connect supervisor readiness socket /run/openshell/health.sock
- Dominant language
- Rust
- Stars
- 8.7k
- Forks
- 1.3k
- Avg merge
- 2d 8h
- Merged PRs (30d)
- 271
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from NVIDIA/OpenShell
-
area:docs
Difficulty 1/5 Under an hour Newbie friendliness 88/100
-
state:triage-needed
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
area:cli state:validated
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
state:triage-needed
Difficulty 1/5 Under an hour Newbie friendliness 90/100
-
area:build spike state:review-ready state:stale
Difficulty 2/5 Half a day Newbie friendliness 68/100
All issues in NVIDIA/OpenShell
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
issue
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
agentic-workflows
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
web-infra-dev/rspack#15847 ·