gurix
7efdf98f0c
- Add 260329-x2a-SUMMARY.md with decisions and usage docs - Update STATE.md quick tasks table with commit reference
76 lines
2.7 KiB
Markdown
76 lines
2.7 KiB
Markdown
---
|
|
phase: quick
|
|
plan: 260329-x2a
|
|
subsystem: deployment
|
|
tags: [docker, deployment, containerization]
|
|
dependency_graph:
|
|
requires: []
|
|
provides: [docker-image, containerized-deployment]
|
|
affects: []
|
|
tech_stack:
|
|
added: [node:22-alpine, Docker multi-stage build]
|
|
patterns: [multi-stage Docker build, Vite preview server in container]
|
|
key_files:
|
|
created:
|
|
- Dockerfile
|
|
- .dockerignore
|
|
modified: []
|
|
decisions:
|
|
- "All deps are devDependencies (vite, typescript etc.) so serve stage uses npm ci without --omit=dev to have vite available for vite preview"
|
|
- "config.json override via volume mount to dist/config.json (Vite preview serves dist/)"
|
|
- "vite.config.ts copied into serve stage so vite preview can read host/port config"
|
|
metrics:
|
|
duration: "<1min"
|
|
completed: "2026-03-29"
|
|
tasks: 1
|
|
files: 2
|
|
---
|
|
|
|
# Quick Task 260329-x2a: Dockerfile and .dockerignore for Zauberwald
|
|
|
|
**One-liner:** Multi-stage Docker build (node:22-alpine) with Vite preview server on port 4173 and runtime config.json override via volume mount.
|
|
|
|
## Tasks Completed
|
|
|
|
| Task | Name | Commit | Files |
|
|
|------|------|--------|-------|
|
|
| 1 | Create Dockerfile and .dockerignore | 3f5fc0f | Dockerfile, .dockerignore |
|
|
|
|
## What Was Built
|
|
|
|
**Dockerfile** — Two-stage build:
|
|
- Stage 1 (`build`): `node:22-alpine`, installs all deps with `npm ci`, copies source, runs `npm run build` (tsc + vite build) producing `dist/`
|
|
- Stage 2 (`serve`): `node:22-alpine`, installs all deps again (needed for `vite preview`), copies `dist/` and `vite.config.ts` from build stage, exposes port 4173, runs `npm run preview`
|
|
|
|
**.dockerignore** — Excludes `node_modules`, `dist`, `.git`, `.planning`, `*.md`, `.biome`, `.claude`, `.agents` from build context.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# Build the image
|
|
docker build -t zauberwald .
|
|
|
|
# Run with config.json mounted from host
|
|
docker run -v /path/to/config.json:/app/dist/config.json:ro -p 4173:4173 zauberwald
|
|
```
|
|
|
|
The app is then accessible at `http://localhost:4173`.
|
|
|
|
## Key Decisions
|
|
|
|
- All project dependencies are `devDependencies` (vite, typescript, etc.). The serve stage must run `npm ci` (without `--omit=dev`) so that `vite` is available for `npm run preview`.
|
|
- `public/config.json` is intentionally NOT excluded from `.dockerignore` — it must be baked into `dist/` during build. At runtime, users can override it by mounting their own `config.json` to `/app/dist/config.json`.
|
|
- `vite.config.ts` is copied into the serve stage because Vite reads it to apply the `host: "0.0.0.0"` and `port: 4173` preview settings.
|
|
|
|
## Deviations from Plan
|
|
|
|
None — plan executed exactly as written.
|
|
|
|
## Self-Check: PASSED
|
|
|
|
- Dockerfile exists: FOUND
|
|
- .dockerignore exists: FOUND
|
|
- Commit 3f5fc0f exists: FOUND
|
|
- EXPOSE 4173 in Dockerfile: FOUND
|
|
- node_modules in .dockerignore: FOUND
|