84 lines
3.6 KiB
Bash
Executable File
84 lines
3.6 KiB
Bash
Executable File
#!/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
|