Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

bug: Kubernetes v1beta1 stop-start can hang waiting for supervisor readiness

Open
#3,566 0 comments 0 reactions 0 assignees View on GitHub

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

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

topic:testing

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

  1. Run the Kubernetes E2E workflow with Agent Sandbox v0.5.0 and the sandbox-lifecycle conformance scenario.
  2. Create a sandbox and wait for it to become ready.
  3. Stop the sandbox.
  4. Start the sandbox again.
  5. Intermittently, observe openshell sandbox start time 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from NVIDIA/OpenShell

All issues in NVIDIA/OpenShell

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.