47 lines
1.2 KiB
Markdown
47 lines
1.2 KiB
Markdown
# Docker Sandbox Build
|
|
|
|
This repository contains the `build-sbx.sh` utility used to create and
|
|
configure Docker sandboxes. The script is intentionally interactive so that
|
|
the sandbox name, mounted workspaces, copied data, API key, and cleanup actions
|
|
are explicit.
|
|
|
|
## Requirements
|
|
|
|
- Bash
|
|
- `sbx`
|
|
- `jq`
|
|
- `fzf` when copying an existing sandbox
|
|
|
|
Run the utility from a shell with access to the `sbx` command:
|
|
|
|
```bash
|
|
./build-sbx.sh
|
|
```
|
|
|
|
## Commit Conventions
|
|
|
|
This project uses [Conventional Commits](https://www.conventionalcommits.org/).
|
|
The project is below version 1.0.0, so changes must not intentionally introduce
|
|
breaking behavior. Every commit uses a type and a scope.
|
|
|
|
Supported types:
|
|
|
|
- `feat`: adds or extends behavior
|
|
- `fix`: corrects behavior
|
|
- `docs`: changes documentation
|
|
- `style`: changes formatting without changing behavior
|
|
- `refactor`: changes implementation without changing behavior
|
|
|
|
Established scopes:
|
|
|
|
- `kit`: sandbox kit, image template, creation, and configuration
|
|
- `workspace`: workspace selection, naming, and cleanup workflow
|
|
- `docs`: README and project documentation
|
|
|
|
Examples:
|
|
|
|
```text
|
|
feat(kit): create configured sandbox image
|
|
docs(docs): document commit conventions
|
|
```
|