Skip to content

Conversation

@agents-git-bot
Copy link
Contributor

@agents-git-bot agents-git-bot bot commented Dec 5, 2025

Summary

Documents the new standalone binary pattern introduced in cloudflare/sandbox-sdk#280 that allows users to add Sandbox SDK capabilities to any Docker image by copying the /sandbox binary.

Changes

New guide: Use arbitrary Docker images

Created a comprehensive how-to guide at /sandbox/guides/arbitrary-docker-images/ covering:

  • When to use: Custom base images, existing Dockerfiles, minimal images, proprietary tooling
  • Basic usage: Copying the binary and setting up entrypoint
  • CMD passthrough: How the binary acts as a supervisor process with signal forwarding
  • Required dependencies: System utilities needed for different SDK features
  • Accessing the binary: From Docker image, GitHub releases, and PR previews
  • Limitations: Code interpreter unavailability and architecture support
  • Migration guide: Moving from custom startup scripts to the standalone binary pattern
  • Troubleshooting: Common issues and solutions

Updated Dockerfile reference

Enhanced /sandbox/configuration/dockerfile/ with:

  • Note at the top directing users to the standalone binary guide for arbitrary base images
  • Added link to the new guide in Related resources

Related

Testing

  • Verify links work correctly
  • Check code examples render properly
  • Confirm navigation structure is correct

🤖 Generated with Claude Code

@github-actions
Copy link
Contributor

github-actions bot commented Dec 5, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/sandbox/ @whoiskatrin, @ghostwriternr, @cloudflare/pcx-technical-writing, @cloudflare/ai-agents

Documents the new standalone binary pattern that allows users to add
Sandbox SDK capabilities to any Docker image without extending the
official base image.

Changes:
- Add standalone-binary.mdx with complete usage guide
- Update dockerfile.mdx to reference standalone binary alternative
- Add standalone binary card to configuration index

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@agents-git-bot
Copy link
Contributor Author

Updated documentation with comprehensive standalone binary guide:

New content:

  • Created standalone-binary.mdx with complete usage documentation
  • Covers basic usage, dependencies, troubleshooting, and limitations
  • Includes multiple download methods (Docker, GitHub releases, PR artifacts)
  • Documents CMD passthrough and signal forwarding behavior

Updates to existing docs:

  • Added cross-references in dockerfile.mdx pointing to standalone binary alternative
  • Added standalone binary card to configuration index
  • Maintains consistency with Cloudflare docs style guide

Synced from: cloudflare/sandbox-sdk PR #280

The documentation follows the Diátaxis framework with reference material and how-to examples for the new standalone binary feature.

Documents the new /sandbox binary pattern that allows users to add
Sandbox SDK capabilities to any Docker image without extending the
official Ubuntu-based image.

Key additions:
- Standalone binary usage with COPY --from pattern
- ENTRYPOINT and CMD configuration
- Required system dependencies (bash, file, git)
- Binary access methods (Docker extraction, GitHub releases)
- Limitations (code interpreter requires full image)
- Cross-references to legacy startup script method

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants