Skip to content

Commit 632da3b

Browse files
Update version to 0.6.0 and add breaking change warning
Update all documentation to reflect v0.6.0 release with image variants: - Update version numbers from 0.3.3 to 0.6.0 throughout docs - Add prominent breaking change callout in Dockerfile reference - Clarify that Python is only in -python variant starting v0.6.0 This completes the documentation sync for PR #259. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 1029652 commit 632da3b

File tree

7 files changed

+27
-17
lines changed

7 files changed

+27
-17
lines changed

src/content/docs/sandbox/concepts/preview-urls.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -210,7 +210,7 @@ For custom domain issues, see [Production Deployment troubleshooting](/sandbox/g
210210
When using `wrangler dev`, you must expose ports in your Dockerfile:
211211

212212
```dockerfile
213-
FROM docker.io/cloudflare/sandbox:0.3.3
213+
FROM docker.io/cloudflare/sandbox:0.6.0
214214

215215
# Required for local development
216216
EXPOSE 3000

src/content/docs/sandbox/concepts/sandboxes.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -144,10 +144,10 @@ The SDK automatically checks that your npm package version matches the Docker co
144144
- You updated the npm package (`npm install @cloudflare/sandbox@latest`) but forgot to update the `FROM` line in your Dockerfile
145145

146146
**How to fix**:
147-
Update your Dockerfile to match your npm package version. For example, if using `@cloudflare/sandbox@0.3.3`:
147+
Update your Dockerfile to match your npm package version. For example, if using `@cloudflare/sandbox@0.6.0`:
148148

149149
```dockerfile
150-
FROM docker.io/cloudflare/sandbox:0.3.3 # Match your npm version
150+
FROM docker.io/cloudflare/sandbox:0.6.0 # Match your npm version
151151
```
152152

153153
See [Dockerfile reference](/sandbox/configuration/dockerfile/) for details on extending the base image.

src/content/docs/sandbox/configuration/dockerfile.mdx

Lines changed: 19 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ The Sandbox SDK provides two container image variants optimized for different wo
1616
Optimized for shell commands and JavaScript/TypeScript execution:
1717

1818
```dockerfile
19-
FROM docker.io/cloudflare/sandbox:0.3.3
19+
FROM docker.io/cloudflare/sandbox:0.6.0
2020
```
2121

2222
**What's included:**
@@ -39,7 +39,7 @@ FROM docker.io/cloudflare/sandbox:0.3.3
3939
Includes Python 3.11 and data science packages for Python code execution:
4040

4141
```dockerfile
42-
FROM docker.io/cloudflare/sandbox:0.3.3-python
42+
FROM docker.io/cloudflare/sandbox:0.6.0-python
4343
```
4444

4545
**What's included:**
@@ -55,11 +55,21 @@ FROM docker.io/cloudflare/sandbox:0.3.3-python
5555
- Running Python scripts with data science libraries
5656
- Executing AI-generated Python code
5757

58+
:::caution[Breaking change in v0.6.0]
59+
Starting with v0.6.0, Python is only included in the `-python` image variant. If you use Python code execution (via `runCode()` or direct `exec()` calls), you must update your Dockerfile:
60+
61+
```dockerfile
62+
FROM docker.io/cloudflare/sandbox:0.6.0-python
63+
```
64+
65+
The default image no longer includes Python to reduce image size for users who do not need it.
66+
:::
67+
5868
:::caution[Version synchronization required]
59-
Always match the Docker image version to your npm package version. If you're using `@cloudflare/sandbox@0.3.3`, use one of these base images:
69+
Always match the Docker image version to your npm package version. If you're using `@cloudflare/sandbox@0.6.0`, use one of these base images:
6070

61-
- `docker.io/cloudflare/sandbox:0.3.3` (default, no Python)
62-
- `docker.io/cloudflare/sandbox:0.3.3-python` (with Python)
71+
- `docker.io/cloudflare/sandbox:0.6.0` (default, no Python)
72+
- `docker.io/cloudflare/sandbox:0.6.0-python` (with Python)
6373

6474
**Why this matters**: The SDK automatically checks version compatibility on startup. Mismatched versions can cause features to break or behave unexpectedly. If versions don't match, you'll see warnings in your logs.
6575

@@ -73,7 +83,7 @@ Create a `Dockerfile` in your project root to extend either base image:
7383
### Extending the default image
7484

7585
```dockerfile title="Dockerfile"
76-
FROM docker.io/cloudflare/sandbox:0.3.3
86+
FROM docker.io/cloudflare/sandbox:0.6.0
7787

7888
# Install Node.js packages globally
7989
RUN npm install -g typescript ts-node prettier
@@ -88,7 +98,7 @@ RUN apt-get update && apt-get install -y \
8898
### Extending the Python image
8999

90100
```dockerfile title="Dockerfile"
91-
FROM docker.io/cloudflare/sandbox:0.3.3-python
101+
FROM docker.io/cloudflare/sandbox:0.6.0-python
92102

93103
# Install additional Python packages
94104
RUN pip install --no-cache-dir \
@@ -127,10 +137,10 @@ Run services automatically when the container starts by creating a custom startu
127137

128138
```dockerfile title="Dockerfile"
129139
# Use default image for Node.js-only services
130-
FROM docker.io/cloudflare/sandbox:0.3.3
140+
FROM docker.io/cloudflare/sandbox:0.6.0
131141

132142
# Or use Python image if your startup script needs Python
133-
# FROM docker.io/cloudflare/sandbox:0.3.3-python
143+
# FROM docker.io/cloudflare/sandbox:0.6.0-python
134144

135145
COPY my-app.js /workspace/my-app.js
136146
COPY startup.sh /workspace/startup.sh

src/content/docs/sandbox/guides/code-execution.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ This guide shows you how to execute Python and JavaScript code with rich outputs
1414
To use Python with the Code Interpreter API, your Dockerfile must use the `-python` image variant:
1515

1616
```dockerfile
17-
FROM docker.io/cloudflare/sandbox:0.3.3-python
17+
FROM docker.io/cloudflare/sandbox:0.6.0-python
1818
```
1919

2020
The default image (without `-python` suffix) does not include Python. See [Dockerfile reference](/sandbox/configuration/dockerfile/) for details on image variants.

src/content/docs/sandbox/guides/expose-services.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -234,7 +234,7 @@ for (const port of [3000, 5173, 8080]) {
234234
When developing locally with `wrangler dev`, you must expose ports in your Dockerfile:
235235

236236
```dockerfile title="Dockerfile"
237-
FROM docker.io/cloudflare/sandbox:0.3.3
237+
FROM docker.io/cloudflare/sandbox:0.6.0
238238

239239
# Expose ports you plan to use
240240
EXPOSE 8000

src/content/docs/sandbox/guides/websocket-connections.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ console.log("WebSocket server listening on port 8080");
4949
**Extend the Dockerfile:**
5050

5151
```dockerfile title="Dockerfile"
52-
FROM docker.io/cloudflare/sandbox:0.3.3
52+
FROM docker.io/cloudflare/sandbox:0.6.0
5353

5454
# Copy echo server into the container
5555
COPY echo-server.ts /workspace/echo-server.ts
@@ -205,7 +205,7 @@ console.log(request.headers.get('Connection')); // 'Upgrade'
205205
Expose ports in Dockerfile for `wrangler dev`:
206206
207207
```dockerfile title="Dockerfile"
208-
FROM docker.io/cloudflare/sandbox:0.3.3
208+
FROM docker.io/cloudflare/sandbox:0.6.0
209209

210210
COPY echo-server.ts /workspace/echo-server.ts
211211
COPY startup.sh /container-server/startup.sh

src/content/docs/sandbox/tutorials/ai-code-executor.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ cd ai-code-executor
4141
Update the `Dockerfile` to use the Python image variant (required for Python code execution):
4242

4343
```dockerfile title="Dockerfile"
44-
FROM docker.io/cloudflare/sandbox:0.3.3-python
44+
FROM docker.io/cloudflare/sandbox:0.6.0-python
4545
```
4646

4747
:::note

0 commit comments

Comments
 (0)