Files
mtusi2026lab5/scripts/stop-one.sh
T

84 lines
3.6 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/bin/sh
set -eu
# Hook отказа для make test-failover (описан в tests/README.md; образец —
# scripts/stop-one.example.sh, правила — infra/AGENTS.md).
# На входе TARGET_INSTANCE_ID — X-Instance-Id, который вернула реплика; в
# compose это hostname, то есть первые символы ID контейнера. Скрипт гасит
# одну живую реплику api из своего проекта и обратно её не поднимает:
# политика unless-stopped после docker stop и docker kill контейнер не
# перезапускает. Хранилища, LB, контейнеры других проектов и volumes не
# затрагиваются; вернуть реплику — make replicas.
# STOP_MODE=stop (умолчание) — docker stop, процесс успевает завершиться;
# STOP_MODE=kill — docker kill, мгновенная смерть без graceful;
# STOP_ONE_LOG=<файл> — журнал остановок: в конец файла добавляются
# время, TARGET_INSTANCE_ID, полный ID и режим. Вывод hook тест прячет,
# а для evidence нужно знать, кого именно остановили.
# Ни секретов, ни окружения не выводит. Коды: 2 — плохие аргументы (docker
# ещё не вызывался), 3 — подходящей реплики нет.
# Проект compose определяется так же, как у docker compose
# (COMPOSE_PROJECT_NAME, COMPOSE_FILE и т. п.), по умолчанию — compose.yaml
# и .env из корня.
# проверяем руками, а не через ${VAR:?}: так код 2 одинаков в bash (там
# было бы 1) и в 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
# ожидаем шестнадцатеричный префикс ID длиной 12–64
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")/.."
# ищем префикс среди полных ID запущенных api этого проекта
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 сам выходит за SHUTDOWN_TIMEOUT (5 с, предел 9); --timeout 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