docs: add Cloudflare Sandbox SDK deployment guide

- Add docs/deploy/cloudflare.mdx with full deployment guide
- Add examples/cloudflare/ with working Worker code
- Update docs navigation to include Cloudflare option
- Update deploy index page with Cloudflare card

The example shows how to run sandbox-agent inside a Cloudflare Sandbox
with exposed ports for API access.

Co-authored-by: Shelley <shelley@exe.dev>
This commit is contained in:
Shelley 2026-02-02 20:31:48 +00:00
parent cc37ed0458
commit 33ace91cfd
10 changed files with 1021 additions and 34 deletions

View file

@ -0,0 +1,46 @@
# Cloudflare Sandbox Agent Example
Deploy sandbox-agent inside a Cloudflare Sandbox.
## Prerequisites
- Cloudflare account with Workers Paid plan
- Docker running locally for `wrangler dev`
- `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` for the coding agents
## Setup
1. Install dependencies:
```bash
pnpm install
```
2. Create `.dev.vars` with your API keys:
```bash
echo "ANTHROPIC_API_KEY=your-api-key" > .dev.vars
```
## Development
Start the development server:
```bash
pnpm run dev
```
Test the endpoint:
```bash
curl http://localhost:8787
```
## Deploy
```bash
pnpm run deploy
```
Note: Production preview URLs require a custom domain with wildcard DNS routing.
See [Cloudflare Production Deployment](https://developers.cloudflare.com/sandbox/guides/production-deployment/) for details.