Skip to content

docs: cloud sandboxes CLI - #26158

Draft
dvdksn wants to merge 10 commits into
docker:mainfrom
dvdksn:codex/restore-cloud-sandboxes-v045
Draft

dvdksn wants to merge 10 commits into
docker:mainfrom
dvdksn:codex/restore-cloud-sandboxes-v045

Conversation

@dvdksn

@dvdksn dvdksn commented Sep 22, 2026

Copy link
Copy Markdown
Contributor

Description

Add cloud Sandboxes documentation for sbx v0.45.0, covering credentials, network policy, lifecycle, environment files, and transfers between local and cloud sandboxes. Document named sandbox reuse and resume, resource sizes and platform selection, custom secrets, move behavior, and local UDP guidance.

Link to the canonical Docker Agentic Platform signup, billing, and Console MCP instructions. Keep CLI sign-in, access checks, and cloud credential setup in the Sandboxes guides.

Depends on #26142 for the shared Agentic Platform documentation; its branch is included here and must merge first. Rebased onto main after #26157 merged the release notes and initial v0.45 CLI reference. This PR also vendors the CLI reference including sbx move, and aligns timeout and move guidance with it. Kits v3 and API/SDK documentation are handled separately.

Validation: scoped Markdown and Vale checks and a full Hugo build passed. After integrating the dependencies, 372 internal links and anchors across 18 cloud and Agentic Platform pages passed verification, including the canonical signup page's discovery. The earlier CLI import verified all 119 vendored files against upstream byte-for-byte and checked 1,083 rendered CLI-reference links and anchors. Behavior was checked against source; live cloud workflows and checkout were not exercised.

@netlify /ai/sandboxes/cloud/

Generated by Codex

@netlify

netlify Bot commented Sep 22, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 8a2f807
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6ab3bb5a80c307000868eb3e
😎 Deploy Preview https://deploy-preview-26158--docsdocker.netlify.app/ai/sandboxes/cloud/
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/get-started Relates to get started and onboarding docs area/ai labels Sep 22, 2026
@dvdksn
dvdksn force-pushed the codex/restore-cloud-sandboxes-v045 branch 2 times, most recently from 4604017 to cca4ba0 Compare September 22, 2026 15:13
@dvdksn
dvdksn force-pushed the codex/restore-cloud-sandboxes-v045 branch from cca4ba0 to 930253a Compare September 23, 2026 07:21
dvdksn added a commit to dvdksn/docs that referenced this pull request Sep 23, 2026
API and SDK access requires a cloud sandbox subscription, but the draft only mentioned account access. Add activation instructions within the API overview and link them from the quickstart, SDK, and authentication pages.

Match the subscription and checkout wording in sibling PR docker#26158 without linking to the hidden Docker Agentic Platform documentation. Scoped Markdown and Vale checks pass.
Make the Agentic Platform section and its billing plan discoverable while retaining experimental labeling. Add canonical subscription activation and billing guidance for Console, cloud CLI, and API/SDK users so companion documentation can link to one setup flow.

Refresh kits, credentials, sandbox lifecycle and platform controls, MCP, policies, and release notes against the Console implementation. Document custom kit size limits and distinguish Console restrictions from private-kit CLI support.
dvdksn added a commit to dvdksn/docs that referenced this pull request Sep 23, 2026
API and SDK access requires a cloud sandbox subscription, but the draft only mentioned account access. Add activation instructions within the API overview and link them from the quickstart, SDK, and authentication pages.

Match the subscription and checkout wording in sibling PR docker#26158 without linking to the hidden Docker Agentic Platform documentation. Scoped Markdown and Vale checks pass.
@github-actions github-actions Bot added area/subscription Relates to Docker pricing and subscription area/billing labels Sep 23, 2026
Restore the cloud documentation from docker#26030 that was reverted in docker#26055 before launch, preserving subsequent documentation updates on main.

Document cloud setup, credentials, policy, lifecycle, environment files, and local/cloud moves against v0.45 behavior. Include local UDP corrections and document Anthropic API keys rather than CLI-initiated OAuth. Kits v3 and generated release notes and CLI reference remain separate.
Add signup, CLI access checks, billing, and subscription management instructions under Cloud Sandboxes so readers can complete setup from these guides.

Explain the plan labels users encounter in checkout and account management, point pricing links to the signup guide, and include console MCP setup steps.
Vendor the checked-in docs/yml files from docker/sandboxes main at a5271b4567897161ab591773d4691d56b6d5d0a0 on top of the v0.45 reference update in docker#26157. Copy the files verbatim, including the move command, and remove obsolete command files absent upstream.

Align the cloud guides with the referenced timeout defaults, restart action, move stop spelling, and destination naming.
Cloud guides duplicated subscription, billing, and Console MCP instructions. Link to the canonical Agentic Platform pages and keep CLI sign-in and access checks in the cloud getting-started guide.
The comparison omitted move warnings and destination setup steps, and stated a broader cloud governance limitation than the CLI evidence establishes. Add move behavior and recovery guidance, briefly note L7 filtering, and describe separate cloud policy configuration without claiming all organization governance is unavailable.
@dvdksn
dvdksn force-pushed the codex/restore-cloud-sandboxes-v045 branch from a8da6f5 to c601313 Compare September 23, 2026 08:58
The comparison omitted transfer time and destination resource sizing. Note image size, bandwidth, and temporary disk requirements, and clarify that move has no CPU or memory overrides and workload performance should be checked at the destination.
Nested Docker exec can use the sandbox VM filesystem instead of the target container filesystem, affecting healthchecks and Compose readiness. Explain symptoms and the limited main-command workaround in the cloud usage guide, and link from the comparison.
@dvdksn dvdksn changed the title docs: restore cloud sandboxes guides for sbx v0.45 docs: cloud sandboxes CLI Sep 23, 2026
Add an Experimental sidebar badge and overview notice to the cloud CLI guides, matching the Agentic Platform documentation.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ai area/billing area/get-started Relates to get started and onboarding docs area/subscription Relates to Docker pricing and subscription

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant