Skip to content

Commit ef9e2ac

Browse files
committed
Add CMD passthrough docs and release checksums
Document the supervisor lifecycle model for standalone binary users. Add SHA256 checksum generation for binary releases.
1 parent 8a35b58 commit ef9e2ac

File tree

2 files changed

+11
-1
lines changed

2 files changed

+11
-1
lines changed

.github/workflows/release.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -264,5 +264,6 @@ jobs:
264264
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
265265
run: |
266266
VERSION=${{ needs.unit-tests.outputs.version }}
267+
sha256sum sandbox-linux-x64 > sandbox-linux-x64.sha256
267268
# Tag format matches changesets: @cloudflare/sandbox@VERSION
268-
gh release upload "@cloudflare/sandbox@${VERSION}" ./sandbox-linux-x64 --clobber
269+
gh release upload "@cloudflare/sandbox@${VERSION}" ./sandbox-linux-x64 ./sandbox-linux-x64.sha256 --clobber

docs/STANDALONE_BINARY.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,15 @@ ENTRYPOINT ["/sandbox"]
1717
CMD ["/your-startup-script.sh"] # Optional: runs after server starts
1818
```
1919

20+
## How CMD Passthrough Works
21+
22+
The `/sandbox` binary acts as a supervisor:
23+
24+
1. Starts HTTP API server on port 3000
25+
2. Spawns your CMD as a child process
26+
3. Forwards SIGTERM/SIGINT to the child
27+
4. If CMD exits 0, server keeps running; non-zero exits terminate the container
28+
2029
## Required Dependencies
2130

2231
| Dependency | Required For | Install Command |

0 commit comments

Comments
 (0)