fix(ops): stop a compose replica from blocking the blue/green release

The deploy failed after the build, the migrations and the browser gate:
"Port 3002 is already in use". The holder was `epicnext-cms`, a compose
replica of release 6bffc537 that the daily scripts/docker-update.sh cron
had recreated at 03:30 with restart=unless-stopped. nginx serves the green
slot on 3003, so that replica was squatting the blue slot the next
candidate needed, and live traffic never noticed.

It got there because the updater's CI-ownership guard only tested
epicnext-cms-app. After a cutover to the green slot that container is
stopped, renamed and deleted, so the guard stopped firing while the host
stayed CI-managed.

- scripts/docker-update.sh: refuse a compose deployment on a CI host by
  checking both slot containers and the nginx upstream, which is the only
  thing that still marks the host as blue/green while a slot is idle.
- scripts/ci-deploy.sh: retire a compose replica of this checkout from
  the candidate port before starting the candidate, so a stray replica
  can never block a release again. Never a slot container, never the port
  nginx serves; anything else still fails loudly in assert_port_free.
- Tests cover both directions: a squatting replica is removed and the
  release lands, a replica on the live port is left alone.

src/lib/ci-deploy.test.ts

@@ -218,6 +218,11 @@ function simulateBlueGreen(scenario: string, livePort = 3002) {
 		writeFileSync(join(dir, "nginx-site.conf"), "upstream cms_app { }\n");
 		// Het live container-bestand, zodat `docker inspect` hem als draaiend ziet.
 		writeFileSync(join(dir, "epicnext-cms-app"), "old\n");
+		// Een compose-replica uit deze checkout (scenario 'port-taken-compose' of
+		// 'compose-live'); retire_compose_replicas() in het script zoekt hem op bij
+		// zijn container-id en beslist aan zijn PORT of hij live draait.
+		if (scenario === "port-taken-compose" || scenario === "compose-live")
+			writeFileSync(join(dir, "epicnext-cms"), "compose\n");
 		const result = spawnSync(bash, [resolve(root, "scripts/ci-deploy.sh")], {
 			cwd: dir,
 			encoding: "utf8",
@@ -316,6 +321,33 @@ describe("blue/green cutover", () => {
 		expect(r.upstream).not.toContain("127.0.0.1:3003");
 	});
 
+	it("removes a compose replica that squats the candidate port and then deploys", () => {
+		// Live op 3003, dus de kandidaat moet op 3002. Een compose-replica uit
+		// deze checkout zit daar al: precies de situatie die de release tegenhield
+		// totdat iemand de container met de hand verwijderde.
+		const r = simulateBlueGreen("port-taken-compose", 3003);
+		expect(r.status, r.output).toBe(0);
+		expect(r.output).toContain(
+			"Removing compose replica epicnext-cms on port 3002",
+		);
+		// Vóór het starten van de kandidaat, anders blijft 3002 bezet.
+		expect(r.calls.indexOf("docker rm -f epicnext-cms\n")).toBeGreaterThan(-1);
+		expect(r.calls.indexOf("docker rm -f epicnext-cms\n")).toBeLessThan(
+			r.calls.indexOf("docker run -d --name epicnext-cms-app"),
+		);
+		expect(r.upstream).toContain("127.0.0.1:3002");
+	});
+
+	it("leaves a compose replica alone when it is the live release", () => {
+		// De replica draait hier op 3003, de poort waar nginx naar wijst. Hoe
+		// onheilijk een compose-container ook is, hij serveert het verkeer en
+		// wordt dus niet weggenomen.
+		const r = simulateBlueGreen("compose-live", 3003);
+		expect(r.status, r.output).toBe(0);
+		expect(r.calls).not.toContain("docker rm -f epicnext-cms\n");
+		expect(r.upstream).toContain("127.0.0.1:3002");
+	});
+
 	it.each([
 		"run-failure",
 		"health-failure",

src/lib/docker-update.test.ts

@@ -56,6 +56,22 @@ function simulate(scenario: string, args: string[] = []) {
 			join(dir, "scripts/docker-prune.sh"),
 		);
 		writeFileSync(join(dir, ".env"), "HOTEL_NAME=Test\n");
+		// De CI-eigendomscontrole leest het nginx-upstream-bestand, net als
+		// scripts/ci-deploy.sh. Tests draaien op de productiehost, dus het
+		// scenario 'ci-upstream' levert zelf een bestand met een slot erin en alle
+		// andere scenario's een leeg bestand — anders zou elke test hier op een
+		// echte blue/green-host onterecht stoppen.
+		writeFileSync(
+			join(
+				dir,
+				scenario === "ci-upstream"
+					? "cms_upstream_servers.conf"
+					: "no-such-upstream.conf",
+			),
+			scenario === "ci-upstream"
+				? "server 127.0.0.1:3003 max_fails=2 fail_timeout=10s;\n"
+				: "",
+		);
 		if (scenario.startsWith("saved-"))
 			writeFileSync(
 				join(dir, ".docker-install"),
@@ -82,6 +98,12 @@ function simulate(scenario: string, args: string[] = []) {
 						: scenario.startsWith("registry")
 							? "registry.test/team/cms"
 							: "",
+					CMS_UPSTREAM_FILE: join(
+						dir,
+						scenario === "ci-upstream"
+							? "cms_upstream_servers.conf"
+							: "no-such-upstream.conf",
+					).replaceAll("\\", "/"),
 				},
 			},
 		);
@@ -169,6 +191,8 @@ describe("Docker clone updates", () => {
 	it.each([
 		"dirty",
 		"ci-active",
+		"ci-green",
+		"ci-upstream",
 		"pull-failure",
 		"build-failure",
 		"migration-failure",
@@ -177,6 +201,20 @@ describe("Docker clone updates", () => {
 		expect(r.status, r.output).not.toBe(0);
 		expect(r.calls).not.toContain("compose up");
 	});
+	// Regressie: na een cutover naar het groene slot bestaat epicnext-cms-app
+	// niet meer en zag deze controle alleen een vrijgekomen blauwe container. De
+	// dagelijkse `docker-update.sh` startte toen een compose-replica op poort
+	// 3002 en blokkeerde elke volgende release. De blauwe container alleen
+	// controleren is dus geen bewijs dat de host niet door CI beheerd wordt.
+	it.each(["ci-green", "ci-upstream"])(
+		"refuses a compose deployment while CI owns the host (%s)",
+		(scenario) => {
+			const r = simulate(scenario);
+			expect(r.status, r.output).not.toBe(0);
+			expect(r.output).toContain("This host is managed by CI");
+			expect(r.calls).not.toContain("compose up");
+		},
+	);
 	it.each(["wrong-image", "wrong-release", "wrong-public", "recreate-failure"])(
 		"never reports success for %s",
 		(scenario) => {

src/test/ci-deploy-harness.sh

@@ -37,6 +37,17 @@ curl() {
   if [ "$SCENARIO" = health-failure ] && candidate_is_new; then return 1; fi
   echo '{"database":true}'
 }
+# Een compose-replica uit precies deze checkout (`docker compose up`, of de
+# dagelijkse docker-update.sh) kan een blauwe/groene slot bezetten en de release
+# blokkeren. De scenario's hieronder leveren zo'n replica op:
+#   port-taken-compose  draait op 3002, terwijl live op 3003 draait → mag weg;
+#   compose-live        draait op 3003, de poort waar nginx naar wijst → blijft.
+compose_replica_port() {
+  case "$SCENARIO" in
+    port-taken-compose) printf '3002\n' ;;
+    compose-live) printf '3003\n' ;;
+  esac
+}
 sleep() { :; }
 # De poortconflict-check (assert_port_free in scripts/ci-deploy.sh) leest de
 # echte luisterende sockets. Zonder deze stub zou de simulatie de containers van
@@ -45,7 +56,7 @@ sleep() { :; }
 # virtueel heeft toegewezen. Standaard is geen enkele poort bezet; het scenario
 # 'port-taken' reserveert expliciet de kandidaatpoort.
 ss() {
-  local requested="" arg
+  local requested="" arg replica_port
   for arg in "$@"; do
     case "$arg" in
       sport=*) requested="${arg#sport=}" ;;
@@ -58,13 +69,35 @@ ss() {
     printf 'LISTEN 0      511          0.0.0.0:%s          0.0.0.0:*\n' "$requested"
     return 0
   fi
+  # De replica houdt zijn poort bezet zolang hij bestaat: zo ziet de simulatie
+  # dat de kandidaat op 3002 pas kan starten nadat retire_compose_replicas() hem
+  # heeft verwijderd.
+  replica_port="$(compose_replica_port)"
+  if [ -n "$replica_port" ] && [ "$requested" = "$replica_port" ] && [ -f "$TEST_DIR/epicnext-cms" ]; then
+    printf 'State  Recv-Q Send-Q Local Address:Port Peer Address:Port\n'
+    printf 'LISTEN 0      511          0.0.0.0:%s          0.0.0.0:*\n' "$replica_port"
+    return 0
+  fi
   printf 'State  Recv-Q Send-Q Local Address:Port Peer Address:Port\n'
 }
 docker() {
   echo "docker $*" >> "$TEST_DIR/calls"
   local name="${@: -1}"
   case "$1" in
+    ps)
+      [ -z "$(compose_replica_port)" ] || echo compose123 ;;
     inspect)
+      # De replica wordt in de simulatie bij zijn container-id opgezocht, net als
+      # in het echte script.
+      if [ "$name" = compose123 ]; then
+        case "${3:-}" in
+          '{{.Name}}') echo /epicnext-cms ;;
+          '{{.Image}}') echo sha256:compose ;;
+          '{{index .Config.Labels "com.docker.compose.project.config_files"}}') echo "$TEST_DIR/production/docker-compose.yml" ;;
+          '{{range .Config.Env}}{{println .}}{{end}}') printf 'PORT=%s\nHOSTNAME=0.0.0.0\n' "$(compose_replica_port)" ;;
+        esac
+        return 0
+      fi
       [ -f "$TEST_DIR/$name" ] || return 1
       if [ "${3:-}" = '{{.State.Running}}' ]; then echo true
       elif [ "${3:-}" = '{{.Image}}' ]; then echo "sha256:$(cat "$TEST_DIR/$name")"
@@ -92,7 +125,7 @@ docker() {
     *) return 0 ;;
   esac
 }
-export -f git flock pnpm curl sleep ss docker nginx candidate_is_new
+export -f git flock pnpm curl sleep ss docker nginx candidate_is_new compose_replica_port
 
 node() {
   echo "node $*" >> "$TEST_DIR/calls"

src/test/docker-update-harness.sh

@@ -16,6 +16,7 @@ docker() {
  case "$1 ${2:-}" in
   'inspect --format')
    if [ "${@: -1}" = epicnext-cms-app ]; then [ "$SCENARIO" = ci-active ] && echo true; return 0; fi
+   if [ "${@: -1}" = epicnext-cms-green ]; then [ "$SCENARIO" = ci-green ] && echo true; return 0; fi
    if [ "${@: -1}" = previous123 ] || [ -f "$TEST_DIR/restored" ]; then echo sha256:old; return 0; fi
    if [ "$SCENARIO" = wrong-image ]; then echo sha256:old; else echo sha256:new; fi ;;
   'image inspect')