#!/bin/sh set -eu # Failover hook для make test-failover (tests/README.md) по образцу # scripts/stop-one.example.sh; правила — .claude/rules/balancer.md, # решения — design change replicas-lb, решение 7. # TARGET_INSTANCE_ID — X-Instance-Id реплики, то есть начало ID её # контейнера (hostname в compose). Скрипт останавливает ровно одну # работающую реплику сервиса api этого проекта и оставляет её # остановленной: restart: unless-stopped не поднимает контейнер ни после # docker stop, ни после docker kill. Postgres, Valkey, LB, чужие контейнеры # и volumes не трогает. Восстановление — make replicas. # STOP_MODE=stop (по умолчанию) — docker stop: SIGTERM и graceful; # STOP_MODE=kill — docker kill: SIGKILL, отказ процесса без graceful; # STOP_ONE_LOG=<файл> — дописать строку «время, TARGET_INSTANCE_ID, # полный ID контейнера, режим» (доказательство: тест скрывает вывод hook). # Секретов и окружения не печатает. Неверный ввод — код 2 до вызова # docker, нет такой реплики — код 3. # пустое значение — тот же код 2 в любой оболочке (${VAR:?} даёт 1 в bash # и 2 в dash) if [ -z "${TARGET_INSTANCE_ID:-}" ]; then echo "stop-one: TARGET_INSTANCE_ID is empty; test provides target API instance alias" >&2 exit 2 fi mode="${STOP_MODE:-stop}" case "$mode" in stop | kill) ;; *) echo "stop-one: STOP_MODE must be stop or kill" >&2 exit 2 ;; esac # hostname контейнера — его ID в hex, от 12 символов case "$TARGET_INSTANCE_ID" in *[!0-9a-f]*) echo "stop-one: TARGET_INSTANCE_ID is not a container id" >&2 exit 2 ;; esac if [ "${#TARGET_INSTANCE_ID}" -lt 12 ] || [ "${#TARGET_INSTANCE_ID}" -gt 64 ]; then echo "stop-one: TARGET_INSTANCE_ID is not a container id" >&2 exit 2 fi cd "$(dirname "$0")/.." # только работающие реплики сервиса api этого проекта, полные ID match="" for id in $(docker compose ps -q --no-trunc api); do case "$id" in "$TARGET_INSTANCE_ID"*) if [ -n "$match" ]; then echo "stop-one: TARGET_INSTANCE_ID matches several replicas" >&2 exit 3 fi match="$id" ;; esac done if [ -z "$match" ]; then echo "stop-one: no running api replica of this project matches TARGET_INSTANCE_ID" >&2 exit 3 fi if [ "$mode" = stop ]; then # uvicorn завершается сам не позже 8 с (graceful_shutdown_seconds); # 9 с гарантируют возврат hook раньше 10 с и для зависшего процесса docker stop --timeout 9 "$match" >/dev/null else docker kill "$match" >/dev/null fi if [ -n "${STOP_ONE_LOG:-}" ]; then printf '%s TARGET_INSTANCE_ID=%s container=%s mode=%s\n' \ "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$TARGET_INSTANCE_ID" "$match" "$mode" \ >>"$STOP_ONE_LOG" fi echo "stop-one: stopped api container $(printf '%.12s' "$match") (mode $mode)" >&2