fix(14.3-01): ship http body limits in examples/hello

- add examples/hello/config/http.yaml so serve, route:list and
  TestTypedItemRoute work without a manual config step
- drop the matching setup step and known-issue notes from README.md and
  docs/setup/installation.md
This commit is contained in:
Jakub Zych
2026-10-08 11:40:20 +02:00
parent c33ebf3b95
commit cc7386d22e
3 changed files with 7 additions and 20 deletions

View File

@@ -38,15 +38,7 @@ The `migrate`, `migrate:status`, `migrate:rollback`, `serve` and admin commands
CREATE DATABASE hello;
```
2. Add the request body limits that `serve` and `route:list` require. The example does not ship them yet, and surf needs numeric values, which the string-valued environment overlay cannot supply. Create `config/http.yaml` in `examples/hello`:
```yaml
body_limits:
default_bytes: 1048576
upload_bytes: 10485760
```
3. Point the binary at the database, give it an application key and an uploads bucket, then migrate and serve:
2. Point the binary at the database, give it an application key and an uploads bucket, then migrate and serve:
```sh
./bin/hello key:generate # prints a base64 key; copy the value
@@ -63,7 +55,6 @@ The `migrate`, `migrate:status`, `migrate:rollback`, `serve` and admin commands
### Known issues
- `examples/hello` has no `http.body_limits` configuration, so `serve` and `route:list` fail with `surf: config http.body_limits.default_bytes is required` until you add it as in step 2. The same gap makes the example's `TestTypedItemRoute` fail.
- The committed `examples/hello/main.go` is older than what `summer build` generates now, so building the example (or running its tests, which build it) leaves that file modified. Restore it with `git checkout -- examples/hello/main.go` if you do not intend to commit it.
## Repository layout