You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: src/content/docs/sandbox/configuration/dockerfile.mdx
+19-9Lines changed: 19 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ The Sandbox SDK provides two container image variants optimized for different wo
16
16
Optimized for shell commands and JavaScript/TypeScript execution:
17
17
18
18
```dockerfile
19
-
FROM docker.io/cloudflare/sandbox:0.3.3
19
+
FROM docker.io/cloudflare/sandbox:0.6.0
20
20
```
21
21
22
22
**What's included:**
@@ -39,7 +39,7 @@ FROM docker.io/cloudflare/sandbox:0.3.3
39
39
Includes Python 3.11 and data science packages for Python code execution:
40
40
41
41
```dockerfile
42
-
FROM docker.io/cloudflare/sandbox:0.3.3-python
42
+
FROM docker.io/cloudflare/sandbox:0.6.0-python
43
43
```
44
44
45
45
**What's included:**
@@ -55,11 +55,21 @@ FROM docker.io/cloudflare/sandbox:0.3.3-python
55
55
- Running Python scripts with data science libraries
56
56
- Executing AI-generated Python code
57
57
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
+
58
68
:::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:
60
70
61
-
-`docker.io/cloudflare/sandbox:0.3.3` (default, no Python)
**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.
65
75
@@ -73,7 +83,7 @@ Create a `Dockerfile` in your project root to extend either base image:
Copy file name to clipboardExpand all lines: src/content/docs/sandbox/guides/code-execution.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ This guide shows you how to execute Python and JavaScript code with rich outputs
14
14
To use Python with the Code Interpreter API, your Dockerfile must use the `-python` image variant:
15
15
16
16
```dockerfile
17
-
FROM docker.io/cloudflare/sandbox:0.3.3-python
17
+
FROM docker.io/cloudflare/sandbox:0.6.0-python
18
18
```
19
19
20
20
The default image (without `-python` suffix) does not include Python. See [Dockerfile reference](/sandbox/configuration/dockerfile/) for details on image variants.
0 commit comments