chore(docker): add Update-Codeman.sh for scripted major-update rebuilds

mirror of https://github.com/Ark0N/Codeman.git synced 2026-09-30 12:39:42 +02:00

docker/README.md and docs/docker-self-update.md both already point operators
at "stop the stack, rebuild, restart" for anything the in-app updater refuses
to apply (a changed server.Dockerfile, a changed docker-compose.yaml, or a
new required .env key) — but that was a manual, hand-typed procedure with no
script of its own, unlike every other start/update path this deployment has.

docker/Update-Codeman.sh scripts it: `docker compose down`, then an
unconditional `docker compose build --no-cache` (a major update should be
certain of what actually ships, not reuse whatever layers happened to be
cached), then hands off to the existing Start-Codeman.sh for the same
careful PUID/PGID, override-file and fingerprint handling every other start
already goes through — rather than reimplementing any of that by hand and
risking it drifting out of step.

An optional --volumes/-v flag also removes the codeman-node-modules/
codeman-dist named volumes, the scripted form of the "Resetting the build
artefacts" procedure docs/docker-self-update.md already documents by hand.
Safe: those two are the only named volumes this stack declares; application
data and case workspaces are host bind mounts, never touched by
`docker compose down` either way.

Docs updated: a "Major updates" section in docker/README.md, and a pointer
from docs/docker-self-update.md's existing "Resetting the build artefacts"
troubleshooting entry.

Tests: extended test/docker-entrypoint.test.ts (the existing home for
Start-Codeman.sh's own static checks) with a bash -n parse check, the
down-before-build-before-handoff ordering, the --volumes flag's effect,
unrecognised-argument handling, and byte-for-byte agreement with
Start-Codeman.sh's own override-file resolution logic (so `down` here and
`up` there can never target different Compose files).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N6eadpRyqpA9PD3i139cSD

This commit is contained in:

Devvyn

2026-09-21 13:57:54 +08:00

co-authored by

Claude Sonnet 5

parent 9466acfc1a

commit 9ba90a674a

4 changed files with 186 additions and 2 deletions

									
										docs/docker-self-update.md
									
		+3
		-1
	
												View File
												
				@@ -224,7 +224,9 @@ the host and the in-app path works from then on.

				**Resetting the build artefacts** — `docker compose down -v`, then

				`Start-Codeman.sh`. This discards the named volumes and re-seeds them from a fresh

				image.

				image. `docker/Update-Codeman.sh --volumes` scripts exactly this (plus an

				unconditional `--no-cache` rebuild, which a plain `Start-Codeman.sh` run does not

				force on its own) — see "Major updates" in `docker/README.md`.

				## Disabling it