Skip to content

docs: fix first-network-policy sandbox lifecycle flow - #3140

Merged
johntmyers merged 1 commit into
NVIDIA:mainfrom
russellb:docs/fix-tutorial-provider-policy
Sep 2, 2026
Merged

docs: fix first-network-policy sandbox lifecycle flow#3140
johntmyers merged 1 commit into
NVIDIA:mainfrom
russellb:docs/fix-tutorial-provider-policy

Conversation

@russellb

@russellb russellb commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixes the first-network-policy tutorial, whose exit/reconnect flow fails against current behavior.

Related Issue

Related to #2998 (first acceptance criterion) and #2798.

Changes

  • docs/get-started/tutorials/first-network-policy.mdx — The tutorial told users to exit the sandbox and reconnect later, but exiting the interactive shell stops the sandbox's main process, and it is not reconnectable under the default restart policy. Switched to the two-terminal flow already used by the github-sandbox tutorial so the sandbox stays running — matching what examples/sandbox-policy-quickstart/demo.sh actually does.

Notes

Scope was trimmed to just the lifecycle fix. The credential-gate parts of #2998 (the policy set/update failure on provider-backed sandboxes) are the proper root-cause fix in #3129, so this PR no longer touches the github-sandbox tutorial or the default-policy reference. The underlying restart behavior is tracked in #2798.

Testing

  • mise run pre-commit — passes.

Checklist

  • Docs updated (docs/)
  • Scoped to the issue at hand
  • Conventional commit with DCO sign-off

@copy-pr-bot

copy-pr-bot Bot commented Sep 2, 2026

Copy link
Copy Markdown

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.

@russellb russellb mentioned this pull request Sep 2, 2026
2 tasks
The tutorial told users to exit the sandbox and reconnect later, but
exiting the interactive shell stops the sandbox's main process and it is
not reconnectable under the default restart policy. Switch to the
two-terminal flow already used by the github-sandbox tutorial so the
sandbox stays running, matching what examples/sandbox-policy-quickstart/
demo.sh actually does.

Related: NVIDIA#2998, NVIDIA#2798
Signed-off-by: Russell Bryant <rbryant@redhat.com>
@russellb
russellb force-pushed the docs/fix-tutorial-provider-policy branch from ddf4b70 to 370908f Compare September 2, 2026 20:36
@russellb russellb changed the title docs: fix tutorials for provider credential and sandbox lifecycle behavior docs: fix first-network-policy sandbox lifecycle flow Sep 2, 2026
@johntmyers
johntmyers enabled auto-merge September 2, 2026 20:44
@johntmyers

Copy link
Copy Markdown
Collaborator

/ok to test 370908f

@johntmyers
johntmyers added this pull request to the merge queue Sep 2, 2026
Merged via the queue into NVIDIA:main with commit 172b65e Sep 2, 2026
57 checks passed
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