thalos-web/docs/runbooks/containerization.md
2026-03-31 16:06:15 -06:00

34 lines
923 B
Markdown

# Containerization Runbook
## Image Build
```bash
docker build -t agilewebs/thalos-web:dev .
```
## Local Run
```bash
docker run --rm -p 8080:8080 \
-e API_BASE_URL=http://host.docker.internal:8080 \
-e THALOS_AUTH_BASE_URL=http://host.docker.internal:22080 \
-e THALOS_DEFAULT_RETURN_URL=http://localhost:22080/callback \
-e THALOS_DEFAULT_TENANT_ID=demo-tenant \
-e THALOS_ENABLE_MANUAL_LOGIN=false \
--name thalos-web agilewebs/thalos-web:dev
```
## Runtime Configuration Strategy
- Build-time fallback: `VITE_API_BASE_URL`
- Runtime override: container env `API_BASE_URL`
- Runtime file generated at startup: `/runtime-config.js`
- OIDC callback defaults are injected through runtime env vars, not hardcoded per build.
- Manual fallback login should remain disabled for deployed auth hosts unless an explicit dev/test override is required.
## Health Check
```bash
curl -f http://localhost:8080/
```