mayatnikovandClaude Opus 5
f9ac83bef8
Ветка отведена от 522ba89, где последним был ADR-063, и заняла
064–072. Тем временем в main через #3 и #4 пришли свои 064
(строка ввода — div вместо form), 065 (стороны сообщений)
и 066 (серверного перца нет).
Переезжают три ADR этой ветки, 067–072 остаются на месте:
их номера свободны, а внутренние ссылки менять незачем.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QR8uS3zGkybzWRW4GEY1oz
4.4 KiB
ADR-074: Версия — короткая ревизия, «время сборки» — время коммита
Уточняет ADR-022 (подлинность бинаря проверяется сверкой хеша со сборкой из тега) и ADR-057 (+dirty у сборки из изменённого дерева).
Доведён до интерфейса ADR-067: версия и время коммита стоят в подвале сайдбара.
Контекст
Интерфейс должен называть версию, которая сейчас работает: иначе разговор о поломке начинается с угадывания, обновилось ли то, что человек видит.
Ревизия у сервера уже есть — revision() в cmd/bare читает vcs.revision и vcs.modified (ADR-057), — но живёт в main и снаружи недоступна. internal/api до неё не дотягивается.
Второй вопрос — «время сборки». Естественный ответ, штамп момента компиляции через -ldflags -X, ломает ADR-022: артефакт деплоя — один файл, и его подлинность проверяется тем, что сборка из тега даёт тот же хеш. Со временем компиляции внутри каждая пересборка одного и того же коммита даёт другой файл, и сверка перестаёт что-либо значить. Рядом с ревизией лежит vcs.time — время коммита, приходящее из git вместе с ней. Оно воспроизводимо и отвечает на настоящий вопрос: какой код работает, а не когда его компилировали.
Решение
- Чтение build info переезжает в
internal/build: полная ревизия, признак изменённого дерева, время коммита.cmd/bareиinternal/apiберут версию оттуда — двух форматов у одной величины не заводится. - Версия — семь символов ревизии. У сборки из изменённого дерева к ним дописывается
+dirty(ADR-057), без ревизии вовсе —unknown. - «Время сборки» — это
vcs.time, время коммита. Штампа момента компиляции в бинаре нет и не появится. GET /api/configотдаётversion(строка) иcommitAt(миллисекунды Unix,0если времени нет). Отдельного/api/versionнет: конфигурацию клиент читает до входа и так, а второй эндпоинт ради двух полей — лишний маршрут. В других ответах версии тоже нет.bare versionпечатает то же самое: короткую ревизию и время коммита в UTC одной строкой.
Следствия
- Сверка «хеш файла на сервере против сборки из тега» остаётся проверяемой: в бинаре не осталось ничего, что менялось бы от пересборки.
bare versionбольше не печатает полный хеш. Семи символов хватает и человеку, иgit show;docs/deploy.mdговорит то же.- Время в интерфейсе отстаёт от момента деплоя ровно настолько, насколько деплой отстал от коммита. Это и спрашивают.
- Сборка не из git —
go run,go build -buildvcs=false, тестовый бинарь — показываетunknownи0. Тесты видят именно её:vcs.*тестовому бинарю не проставляются, и это состояние проверяется ими прямо. - Клиенту остаётся показать два поля; где именно и какими словами —
docs/ui.md.