Paul Payne
4d983819c9
feat(synapse): update ingress to use traefik ingress class and bump version feat(syncthing-discovery): introduce syncthing discovery service with deployment and ingress feat(syncthing-relay): add syncthing relay server with deployment and ingress configuration fix(taiga): update liveness and readiness probes to use tcpSocket for health checks fix(taiga): change PVC access mode to ReadWriteMany for media and static storage feat(traefik): add icon and ignore rules for traefik service docs(ushahidi): add notes for Redis configuration and Laravel startup probe adjustments feat(ushahidi): implement dedicated Redis deployment for Ushahidi fix(vllm): update deployment strategy and readiness/liveness probes for improved stability fix(writefreely): pin writefreely image version to v0.15.1 for consistency docs(zulip): add notes for TLS-terminating reverse proxy configuration and expected behavior
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# BookWyrm — Notes
|
|
|
|
## SCSS themes must be compiled before collectstatic
|
|
|
|
BookWyrm ships SCSS source files instead of pre-compiled CSS. The static root is an `emptyDir`
|
|
(ephemeral), so it is empty on every pod restart. Running `collectstatic` alone fails:
|
|
|
|
```
|
|
ValueError: Missing staticfiles manifest entry for 'css/themes/...'
|
|
```
|
|
|
|
**Fix**: compile themes before collecting static files:
|
|
|
|
```yaml
|
|
command: ["/bin/sh", "-c"]
|
|
args:
|
|
- |
|
|
python manage.py compile_themes \
|
|
&& python manage.py collectstatic --noinput \
|
|
&& python manage.py migrate \
|
|
&& exec gunicorn bookwyrm.wsgi:application ...
|
|
```
|
|
|
|
Check the image's `Dockerfile` or `docker_start.sh` to confirm the current required build steps.
|
|
|
|
## PostgreSQL extensions require superuser
|
|
|
|
BookWyrm uses extensions (`bloom`, `pg_trgm`, etc.) that require superuser to install. Migrations
|
|
fail with `permission denied to create extension "bloom"` if the app DB user is not a superuser.
|
|
|
|
**Fix**: create the extensions in the `db-init-job`, which connects as the `postgres` superuser:
|
|
|
|
```bash
|
|
psql -d "$APP_DB_NAME" -c "CREATE EXTENSION IF NOT EXISTS bloom;"
|
|
psql -d "$APP_DB_NAME" -c "CREATE EXTENSION IF NOT EXISTS pg_trgm;"
|
|
```
|
|
|
|
This must run before migrations (i.e. in `db-init-job`, not in the app startup command).
|