Source: mtusi2026lab4-safronov, solution/bvt2301-safronov, 2546deb. Contracts, public tests and evidence of lab 4 are not carried over. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
80 lines
3.3 KiB
Bash
Executable File
80 lines
3.3 KiB
Bash
Executable File
#!/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
|