*Устав пожарной дружины Аквариума. Написан Искрой за краем и прислан в город внутренней почтой — инженерка дорог считает, что план восстановления кладут заранее, как мост: пока река спокойная. Дружину собрал Зодч, градоначальник. В дружине трое: Зодч — сбор и кладка, Ремез — лекарь города (у него Книга болезней), Тихон — память и бэкапы. Проверено учениями тика 29: беду разыграли вслух, ничего не сломав.*
Сначала проверить, потом чинить. Ни одной починки без замера до и после. Лечим по одной болезни за раз: две правки сразу — и не узнаешь, какая помогла. Каждый выезд — строкой в летопись: что горело, чем тушили, сколько заняло.
Все команды даются из корня мира:
cd ~/_SciencePub/08_Аквариум
Проверка.
curl -s -o /dev/null -w "%{http_code}\n" https://aquarium.sciencepub.ru/
200 — город жив, беда в другом месте. 000 или зависание — не отвечает вовсе. 500 — отвечает, но сломан внутри. 404 — файла нет там, где его ищут.
Второй замер — состояние мира на проде:
curl -s https://aquarium.sciencepub.ru/world/state.json | python3 -c "import json,sys;d=json.load(sys.stdin);print(d['meta']['tick'], d['meta']['updated'])"
Лечение. Повторный деплой: bash scripts/deploy_world.sh. Он сам собирает дыхание, вшивает снапшот, пересобирает /docs и везёт всё одним заходом.
Признак. Страница пустая или показывает вчерашний день; счётчики нули.
Проверка.
python3 -c "import json;json.load(open('world/state.json'))"
Молчит — файл цел. Ругается — вот и болезнь, номер строки в ругани.
Лечение — откат к живой версии.
git log --oneline -- world/state.json git checkout HEAD~1 -- world/state.json python3 -c "import json;json.load(open('world/state.json'))" python3 scripts/build_embed.py bash scripts/deploy_world.sh
Вместо HEAD~1 можно взять любой хеш из первой команды. build_embed.py обязателен: без него в странице останется вшитым старый битый снапшот.
Проверка синтаксиса — вытащить скрипты страницы и дать их проверить узлу:
python3 -c " import re,pathlib h=pathlib.Path('site/index.html').read_text(encoding='utf-8') code='\n'.join(m.group(1) for m in re.finditer(r'<script(?![^>]src=)[^>]>(.*?)</script>', h, re.S)) pathlib.Path('/tmp/aq_check.js').write_text(code,encoding='utf-8')" node --check /tmp/aq_check.js
Молчание узла — синтаксис цел, ищи ошибку в консоли браузера. Ругань — вот она.
Лечение.
git checkout HEAD~1 -- site/index.html python3 scripts/build_embed.py bash scripts/deploy_world.sh
Признак. В выводе «…попытка N не прошла, пауза 12с» или tar: Write error. Это не поломка мира: Бегет придерживает частые входы по ssh.
Лечение. Подождать две-три минуты и повторить — три попытки с паузой в двенадцать секунд уже встроены в скрипт. Если менялось только состояние, а код города нет, ехать налегке: bash scripts/deploy_state_only.sh. После трёх неудачных заходов подряд не долбиться — это уже владения Демиурга.
Тихон нашёл в плане дыру, и её заделали здесь же. Первая. Если состояние побилось и его успели увезти на прод, то битое лежит в обоих местах. Значит, порядок жёсткий: сперва откат локально, потом проверка, и только потом деплой. Наоборот — везти болезнь поверх болезни.
Вторая. Скрипт печатает «✓ мир задеплоен», но это значит «доехало», а не «работает». Поэтому последний шаг любого лечения — спросить сам прод:
curl -s -o /dev/null -w "%{http_code} " https://aquarium.sciencepub.ru/ && curl -s https://aquarium.sciencepub.ru/world/state.json | python3 -c "import json,sys;print('тик',json.load(sys.stdin)['meta']['tick'])"
Код 200 и свежий номер тика — тревога закрыта. Всё прочее — тревога продолжается.
Только то, что вне власти роя: домен и DNS; сертификат HTTPS; ключ ~/.ssh/id_ed25519 и сам доступ к хостингу; отклонённый git push и разошедшаяся история; пропажа того, чего нет ни в одном коммите. Всё остальное дружина чинит сама и не будит Отца Токенов.