forked from mtusi2026/mtusi2026lab2
fix: classify database outages and restore real HTTP fault checks
This commit is contained in:
@@ -42,6 +42,7 @@ jobs:
|
||||
with:
|
||||
version: v2.12.2
|
||||
- run: make coverage
|
||||
- run: make test-faults
|
||||
- uses: actions/upload-artifact@v4
|
||||
if: always()
|
||||
with:
|
||||
|
||||
@@ -33,6 +33,10 @@ Memory store и локальный limiter сохранены для незав
|
||||
|
||||
Фактические проверки и эксплуатационные ограничения, включая process-local cursor key, приведены в [REPORT](REPORT.md). Указанные Go conventions проверяются formatter/lint и AST-тестом направления импортов; они не заменяют анализ ответственности компонентов.
|
||||
|
||||
## Классификация ошибок
|
||||
|
||||
PostgreSQL нормализует сетевые ошибки, разрыв соединения, deadline и SQLSTATE недоступности в `store.ErrUnavailable`, сохраняя исходную причину для `errors.Is`. `service.ErrUnavailable` — alias этой общей категории интерфейса хранилища; controller не импортирует драйвер или store. Это сохраняет классификацию и на пути проверки сессии, и в бизнес-операциях. HTTP-слой возвращает фиксированный 503/unavailable без деталей. Неизвестные ошибки SQL остаются 500; ограничения уникальности и отсутствие записи сохраняют прежнее отображение.
|
||||
|
||||
## Развёртывание
|
||||
|
||||
[Helm chart](charts/messenger) — единственный источник ресурсов стенда. Values задают образ, API-конфигурацию, ресурсы и число шардов. Изменение конфигурации меняет checksum pod template и вызывает rollout API. Namespace изолирует лабораторную; имена StatefulSet и PVC стабильны. Credentials создаются отдельно и передаются по именам Secret, без записи паролей в Helm values.
|
||||
|
||||
@@ -76,3 +76,7 @@ ready:
|
||||
@for attempt in $$(seq 1 60); do curl --fail --silent --max-time 1 "$(BASE_URL)/health/ready" >/dev/null && exit 0; sleep 1; done; echo 'API readiness timeout' >&2; exit 1
|
||||
reshard:
|
||||
SHARDS="$(SHARDS)" scripts/scale-shards.sh
|
||||
|
||||
.PHONY: test-faults
|
||||
test-faults:
|
||||
scripts/test-faults.sh
|
||||
|
||||
@@ -54,7 +54,7 @@ Persistence перезапускает API, PostgreSQL и все Valkey, зат
|
||||
|
||||
Go-проверки: `make vet`, `make lint`, `make test-student`. Полная проверка `make coverage` требует `DATABASE_URL`, `VALKEY_SHARDS`, `TEST_DATABASE_URL`, `TEST_VALKEY_ADDRESS`, указывающих на **изолированные тестовые** зависимости. Она запускает race, интеграционные тесты, настоящий сервер, smoke и SIGTERM; shell/awk объединяют профили и проверяют ≥90% statements отдельно в каждом исполняемом Go-файле. CI создаёт зависимости автоматически. Без TEST-переменных интеграционные тесты пропускаются.
|
||||
|
||||
Проверки после перехода на Helm: [adoption и upgrade](evidence/helm-deployment.txt), [smoke](evidence/helm-smoke.txt), [persistence](evidence/helm-persistence.txt), [coverage](evidence/helm-coverage-per-file.json). Более ранние измерения и их область действия перечислены в [evidence/README](evidence/README.md). Удалённый CI не запускался; Git push и PR не выполнялись.
|
||||
Проверки после перехода на Helm: [adoption и upgrade](evidence/helm-deployment.txt), [smoke](evidence/helm-smoke.txt), [persistence](evidence/helm-persistence.txt), [coverage](evidence/helm-coverage-per-file.json). Более ранние измерения и их область действия перечислены в [evidence/README](evidence/README.md). Удалённый CI не подтверждён; актуальная публикация и PR указаны ниже.
|
||||
|
||||
## SQL-эксперимент
|
||||
|
||||
@@ -76,8 +76,24 @@ make research
|
||||
- Истёкшие сессии отвергаются запросом к БД, но фоновая очистка строк ещё не реализована.
|
||||
- PVC на `microk8s-hostpath` обеспечивает сохранность при рестарте pod; он не заменяет резервную копию.
|
||||
|
||||
Версии Go и зависимостей закреплены в `go.mod`, `go.sum` и Dockerfile. Источники решений: [ADR-0001](docs/decisions/0001-postgres-sessions-shards.md), [ADR-0002](docs/decisions/0002-helm.md). При разработке использован Codex. ФИО, группа и URL PR не указаны.
|
||||
Версии Go и зависимостей закреплены в `go.mod`, `go.sum` и Dockerfile. Источники решений: [ADR-0001](docs/decisions/0001-postgres-sessions-shards.md), [ADR-0002](docs/decisions/0002-helm.md). При разработке использован Codex. Автор: Агапов Владислав, БПИ2303; PR №52 указан ниже.
|
||||
|
||||
## Репозиторий Gitea
|
||||
|
||||
Решение перенесено 2026-10-15 в `ssh://git@gitea.privcloud.tech:2222/vlad_marlo/mtusi2026lab2.git`. Go-модуль и imports обновлены под новый адрес. [Проверки переноса](evidence/gitea-transfer-tests.txt) относятся к новой рабочей копии; прежние измерения и опубликованный образ относятся к снимку от 2026-10-07. Повторное развёртывание, новый image build и Git push при переносе не выполнялись.
|
||||
|
||||
## Исправление классификации отказов — 2026-10-16
|
||||
|
||||
В PostgreSQL-адаптере недоступность соединения и timeout выделены в отдельную категорию. HTTP возвращает `503 unavailable` с безопасным сообщением, включая отказ на этапе проверки сессии. Неожиданные ошибки SQL сохраняют `500 internal_error`.
|
||||
|
||||
```sh
|
||||
make test-faults
|
||||
```
|
||||
|
||||
Сценарий воспроизводится из отдельного clone с Docker, curl, jq, rg, OpenSSL и shasum. Он создаёт собственные PostgreSQL 17.6 и Valkey 8.1.3, собирает API из рабочего дерева, проверяет реальные `stop` и `pause` каждого backend и удаляет временные ресурсы. Ни существующие Docker-контейнеры, ни dev-кластер не используются. В начале вывода сохраняются базовая Git-ревизия и SHA-256 исходников: проверенный снимок включает ещё не закоммиченные изменения.
|
||||
|
||||
[Результат](evidence/fault-regression.txt): все четыре сценария прошли. История с действующей сессией возвращала 503 за 0.002–0.508 с; зависание ограничено timeout 500 мс и внешним HTTP deadline 3 с. Проверены отсутствие анонимного доступа и обхода через X-User-Id/повреждённый/неизвестный Bearer, безопасный error envelope, liveness/readiness. После каждого восстановления исходная сессия читает то же сообщение без повторного входа. При отказе Valkey admission отклоняет запрос до аутентификации, поэтому анонимный запрос тоже получает 503, а не данные.
|
||||
|
||||
Свежие [race/integration/coverage](evidence/fault-coverage.txt), [покрытие по файлам](evidence/fault-coverage-per-file.json), [lint](evidence/fault-lint.txt), [vet](evidence/fault-vet.txt) и [contract check](evidence/fault-contract.txt) прошли. Все 57 исполняемых Go-файлов имеют покрытие ≥90%. Fault-сценарий добавлен в application CI; удалённый runner этим локальным прогоном не проверяется. Кластерный образ в рамках этого исправления не обновлялся.
|
||||
|
||||
Работа сдаётся в [PR №52](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab2/pulls/52), ветка `main` → `master`, автор Агапов Владислав, БПИ2303.
|
||||
|
||||
+3
-2
@@ -14,8 +14,9 @@
|
||||
| L2-T10 | L2-REQ-09,11,12 | Helm chart, values, adoption без потери данных, upgrade, reshard 3→2→3; [проверка](../evidence/helm-deployment.txt) | Выполнено в dev |
|
||||
| L2-T11 | L2-REQ-08,10,12 | [Покрытие shell/awk](../evidence/helm-coverage-per-file.json), [SQL-эксперимент](../evidence/sql-research-helm.txt), сокращённый REPORT; собственные Python-скрипты удалены | Выполнено |
|
||||
|
||||
Обязательные contracts и публичные tests сохранены. Lab1 и соседние реализации не изменялись. Контейнерный образ опубликован; Git push/PR и защита не выполнены; ФИО, группа и URL PR неизвестны. Код, локальные измерения, кластерная проверка и принятие работы учитываются отдельно.
|
||||
Обязательные contracts и публичные tests сохранены. Lab1 и соседние реализации не изменялись. Контейнерный образ опубликован; решение находится в main и PR №52 (Агапов Владислав, БПИ2303). Результат защиты не зафиксирован. Код, локальные измерения, кластерная проверка и принятие работы учитываются отдельно.
|
||||
|
||||
| Задача | Требования | Результат и проверка | Статус |
|
||||
| --- | --- | --- | --- |
|
||||
| L2-T12 | L2-REQ-13 | Перенесены 182 файла; module/imports обновлены; build, vet, race, lint, chart-check и неизменность публичных материалов проверены; [результаты](../evidence/gitea-transfer-tests.txt) | Выполнено локально; без push и redeploy |
|
||||
| L2-T12 | L2-REQ-13 | Перенесены 182 файла; module/imports обновлены; build, vet, race, lint, chart-check и неизменность публичных материалов проверены; [результаты](../evidence/gitea-transfer-tests.txt) | Перенос проверен; main опубликован, PR №52 открыт; без redeploy |
|
||||
| L2-T13 | L2-REQ-03,04 | Классификация PostgreSQL, unit-регрессии, make test-faults: stop/pause обоих backend, запрет анонимного доступа, recovery; evidence/fault-regression.txt; race/coverage ≥90% по каждому файлу | Выполнено локально |
|
||||
|
||||
@@ -40,3 +40,7 @@ L2-REQ-12: единственный источник Kubernetes-ресурсов
|
||||
## Перенос в Gitea
|
||||
|
||||
L2-REQ-13: решение размещается в репозитории `ssh://git@gitea.privcloud.tech:2222/vlad_marlo/mtusi2026lab2.git`. Имя Go-модуля и внутренние imports соответствуют новому хосту. Задание, contracts и публичные tests нового репозитория сохраняются. Секреты, runtime-данные и история исходного `.git` не переносятся. Проверки: сборка, unit/race, vet, chart lint и неизменность публичных материалов. Измерения от 2026-10-07 остаются историческими и не подменяют проверки переноса.
|
||||
|
||||
## Классификация отказов зависимостей
|
||||
|
||||
Уточнение L2-REQ-04: потеря соединения, timeout и недоступность PostgreSQL возвращают HTTP 503 / `unavailable`, включая проверку действительной сессии. Ошибки SQL/неизвестные ошибки сохраняют безопасный 500. Воспроизводимый `make test-faults` создаёт изолированные Docker-зависимости, останавливает PostgreSQL и Valkey по очереди, проверяет историю с прежним токеном, отсутствие анонимного доступа, readiness/liveness и восстановление. Пользовательский кластер и данные не затрагиваются.
|
||||
|
||||
@@ -53,3 +53,5 @@ SQL-результаты содержат snapshot исходников на м
|
||||
Репозиторий: `ssh://git@gitea.privcloud.tech:2222/vlad_marlo/mtusi2026lab2.git`. При переносе обновлены имя Go-модуля, imports и local-prefixes formatter. Исходный skeleton Gitea: `65003b6`. Публичные задания, tests и contracts сохранены без изменений.
|
||||
|
||||
Свежие проверки переноса находятся в `gitea-transfer-tests.txt`: сборка, vet и race-тесты. Интеграционные тесты PostgreSQL/Valkey требуют отдельного окружения и в этом запуске пропускаются; развёртывание в Kubernetes не выполнялось. Остальные файлы evidence содержат прежние измерения от 2026-10-07 с исходными hash и именем модуля. Они не являются измерениями новой ревизии.
|
||||
|
||||
Проверки исправления от 2026-10-16: `fault-regression.txt` — изолированный реальный stop/pause PostgreSQL и Valkey через HTTP, базовая ревизия и SHA-256 проверенного рабочего дерева; `fault-coverage.txt` / `fault-coverage-per-file.json` — race/integration и покрытие каждого файла; `fault-lint.txt`, `fault-vet.txt`, `fault-contract.txt` — статические проверки. Старые измерения не переписываются.
|
||||
|
||||
@@ -0,0 +1,2 @@
|
||||
python3 scripts/check_contract.py
|
||||
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
|
||||
@@ -0,0 +1,73 @@
|
||||
{"threshold_per_file":90,"files":[
|
||||
{"file":"internal/cursor/codec.go","statements":33,"covered":31,"percent":93.93939394,"sha256":"a5bc7aac6d1764929fb11365c9f8b6a45ff65e47b3a317a7ccd9ec6dd1b2713a"},
|
||||
{"file":"internal/valkey/client.go","statements":35,"covered":34,"percent":97.14285714,"sha256":"f50de7f2ac53fae218eb7c580436d5b726de5abe3a9cc6f9696f28b52ad6ec07"},
|
||||
{"file":"internal/controller/http/fiber/handlers.go","statements":37,"covered":36,"percent":97.29729730,"sha256":"b5473469ee1bd63610bc7b1bc167ecf01633dc5f06dae64b7816e8123ee0733e"},
|
||||
{"file":"internal/service/production/members.go","statements":19,"covered":19,"percent":100.00000000,"sha256":"652833512d878ee000da0cdb278f25245a3ce79bf2c1638d62621126d881be25"},
|
||||
{"file":"internal/service/production/creation.go","statements":12,"covered":12,"percent":100.00000000,"sha256":"13f76cd64c9aec923504e077f1db74ff66a96fb72523dd5e1a2cc29efd0682d5"},
|
||||
{"file":"internal/controller/interface.go","statements":0,"covered":0,"percent":null,"sha256":"24b6b06d6fab919cd2130697b44fd0d358265184dca0ca8362e0b4fcc2ae5a68"},
|
||||
{"file":"internal/model/http/models.go","statements":0,"covered":0,"percent":null,"sha256":"8c183b065bc3ab4cad20570eab79f334ca75a3309186fdf832fb1aa598894465"},
|
||||
{"file":"internal/config/config.go","statements":17,"covered":17,"percent":100.00000000,"sha256":"8cb675a0bef8b1645071e4cb85b79a467620e99b375db5d8d3e16a54b4c5b5fa"},
|
||||
{"file":"internal/service/production/messages.go","statements":18,"covered":18,"percent":100.00000000,"sha256":"99a25471826d78b0655be2e4ccfcc1fd0b79ba15454f0fd66a5cf06dcdba9e9c"},
|
||||
{"file":"internal/service/production/service.go","statements":10,"covered":10,"percent":100.00000000,"sha256":"6592e1bd6979036609d052c85b4f73484a0148a5592a3ef415557c1779104d60"},
|
||||
{"file":"internal/service/errors.go","statements":0,"covered":0,"percent":null,"sha256":"9dd4d2998e37c48e104298ae7bc9f311f193ff5212608f9c579cd569941d5054"},
|
||||
{"file":"cmd/server/logger.go","statements":10,"covered":9,"percent":90.00000000,"sha256":"fd0801324362cb74dd1b9d78d9dcc001d9e107e4a329cb48b0390dd33fa641cb"},
|
||||
{"file":"internal/model/dto/session.go","statements":0,"covered":0,"percent":null,"sha256":"896a694b0c217240343077d4287f4a6e447338c38571abbebcb3d16a519137fb"},
|
||||
{"file":"internal/service/production/pagination.go","statements":21,"covered":21,"percent":100.00000000,"sha256":"ef3da5e89d7a1f8798d006760db07409df185b9315a16cdebec6bb22afedbccf"},
|
||||
{"file":"internal/service/production/validation.go","statements":13,"covered":13,"percent":100.00000000,"sha256":"4adb55d349befbc2a1e79b40c5547e22f558cbe10f9866b8fe9ddfbebabb6699"},
|
||||
{"file":"cmd/server/healthcheck.go","statements":19,"covered":18,"percent":94.73684211,"sha256":"29e339c55781d61de8e30fa07b9b21927d9553f7d3f6a63f43c49e86977b2503"},
|
||||
{"file":"internal/store/memory/capacity.go","statements":7,"covered":7,"percent":100.00000000,"sha256":"70d7def3fab2ab41f71b6b88dea8bd4181d4ea619f17daa795c7097ba056bd7c"},
|
||||
{"file":"internal/service/cache.go","statements":0,"covered":0,"percent":null,"sha256":"e43e37991f18f27738877538e9c8304d06e18fa5cd8c773273d3d70185c6c5eb"},
|
||||
{"file":"internal/service/production/pages.go","statements":17,"covered":16,"percent":94.11764706,"sha256":"9d8c2d2ed63382586c5e0e405cd90e02e96cbbc05e1fa4e00e80821a7fdc031f"},
|
||||
{"file":"internal/config/environment.go","statements":14,"covered":14,"percent":100.00000000,"sha256":"027761b059b76898a84318ec1a8b43158d8bafd6e0b15b52efbe902b4d8c5ea3"},
|
||||
{"file":"internal/model/dto/models.go","statements":0,"covered":0,"percent":null,"sha256":"e2ecd732848d10f4471567c9603aa7359fcb1af7b2708ead477f4949f7a2fa4a"},
|
||||
{"file":"internal/valkey/cache.go","statements":19,"covered":18,"percent":94.73684211,"sha256":"cb8805b347358fe683baa2927ff00a454a6fd928c7899170aa69493ac004199d"},
|
||||
{"file":"internal/service/interface.go","statements":0,"covered":0,"percent":null,"sha256":"30dd7d5ce30c7fa0c9b54dc38bdee15b71e7afd2c32aac1675b966585bebb203"},
|
||||
{"file":"internal/controller/http/fiber/routes.go","statements":56,"covered":56,"percent":100.00000000,"sha256":"826fe61b8d59465de7190c175b6abaa118f4a7deacdb1b9c628e25bb7f4feb3b"},
|
||||
{"file":"internal/controller/http/fiber/health.go","statements":7,"covered":7,"percent":100.00000000,"sha256":"7328c3474e6036acbe8c2c0adb91d26e3822ef003d0c2214c89f39a27f2538b2"},
|
||||
{"file":"internal/service/auth.go","statements":0,"covered":0,"percent":null,"sha256":"c39b43224191bb74e3deb2c24830de9e8e17f5778f6e03d301893973d661f068"},
|
||||
{"file":"internal/admission/limiter.go","statements":16,"covered":16,"percent":100.00000000,"sha256":"a373c9539167a4b7c35d45334d35ffd4e9d124c1740c88c12094fededd9643b4"},
|
||||
{"file":"internal/service/production/chats.go","statements":22,"covered":22,"percent":100.00000000,"sha256":"97f7d01d0b2c679910176b473c722f21996f79a164b209f0d71b3f240eaa4100"},
|
||||
{"file":"internal/config/logger.go","statements":7,"covered":7,"percent":100.00000000,"sha256":"3a69e20a00fa2ed816f344a990e9e0ef0077e1607d4207858b4b00e4ff5d1988"},
|
||||
{"file":"internal/store/postgres/sessions.go","statements":13,"covered":13,"percent":100.00000000,"sha256":"889a63b51b29012f4ae5499d1c0577fe29f2f2959b05629f8e123715cfc1f75f"},
|
||||
{"file":"internal/store/memory/chats.go","statements":31,"covered":31,"percent":100.00000000,"sha256":"8da28709d323b71c4e1a301f4f4e4401568ac50c052abe812a145e19ada8115e"},
|
||||
{"file":"internal/store/memory/messages.go","statements":19,"covered":18,"percent":94.73684211,"sha256":"7e01358be57c6608f3fce2b72a76bb870a7d9ef76b035dfd473bd5f89abe0745"},
|
||||
{"file":"internal/controller/http/fiber/dependencies.go","statements":0,"covered":0,"percent":null,"sha256":"6ee07f110bdb29d8d2191ab8889ba60474b33a5b225739875c8a57d8434be15d"},
|
||||
{"file":"cmd/server/app.go","statements":8,"covered":8,"percent":100.00000000,"sha256":"f66db68f6697b4066bbfb6c8884851d0c1f6736a664a7711ab2249583e5180cf"},
|
||||
{"file":"internal/store/postgres/chats.go","statements":26,"covered":24,"percent":92.30769231,"sha256":"6bfacaeabe25f14cc400f3ce83aca807692872c4d364797abf20969e65cdf6a4"},
|
||||
{"file":"internal/controller/http/fiber/auth.go","statements":29,"covered":29,"percent":100.00000000,"sha256":"fa9da03281a9efc946f5ef3cbd768b18d37880f29fff9755ed347f5308f8c8a9"},
|
||||
{"file":"cmd/server/commands.go","statements":6,"covered":6,"percent":100.00000000,"sha256":"7290636ea31539d87bd97bb78cb28658409da966be8983e748ce1701f6f9f8f6"},
|
||||
{"file":"internal/controller/http/fiber/error_codes.go","statements":0,"covered":0,"percent":null,"sha256":"3351a019c43d0360ee0fd68afabb5200422d065ae7bd908b1c0a5c02a0c1ad41"},
|
||||
{"file":"internal/controller/http/fiber/controller.go","statements":10,"covered":10,"percent":100.00000000,"sha256":"4a74bc4bfc6955ab1bf9a3a8e933381a807b5eafdd9049480be3486f87f1032e"},
|
||||
{"file":"internal/config/controller.go","statements":24,"covered":23,"percent":95.83333333,"sha256":"e784d7b934c4604065cd00bf4ff2b0c74741e759b1b7c81162adfc206d160153"},
|
||||
{"file":"internal/controller/http/fiber/error_registry.go","statements":2,"covered":2,"percent":100.00000000,"sha256":"9d5da8d98ece2706e324cb2deca915e0811b6ad98f7aaac5805ca0f3cc0a1f9a"},
|
||||
{"file":"internal/service/production/access.go","statements":27,"covered":27,"percent":100.00000000,"sha256":"4d39d5ad2ae82c62637d5f2a0a9d5030569ffe65a23eeecba6c1229c35feefd0"},
|
||||
{"file":"internal/password/password.go","statements":18,"covered":17,"percent":94.44444444,"sha256":"fe2df6990331573bbf0202ebc81c58263a7c16a29b713eefa0f0e852e4ee4a76"},
|
||||
{"file":"internal/controller/http/fiber/middleware.go","statements":34,"covered":33,"percent":97.05882353,"sha256":"d551a81ada306536a235fe684170e68613b72a847b6d16d3195edabd83e250aa"},
|
||||
{"file":"internal/controller/fx.go","statements":1,"covered":1,"percent":100.00000000,"sha256":"af72da25fea9811c13a50c8133e9e8b35e070c5295069c40c0ae89cdc0aff19a"},
|
||||
{"file":"internal/strictjson/decode.go","statements":37,"covered":36,"percent":97.29729730,"sha256":"ef9bfaf3bd684fded87c92a15b3e5c706a794caf04cc4ef711c4185e9c7fb12a"},
|
||||
{"file":"internal/store/memory/ordering.go","statements":6,"covered":6,"percent":100.00000000,"sha256":"b5a20aa3473c42d06ad1b26a318afcc94e7397d34c106844bcf69eebaf210747"},
|
||||
{"file":"internal/controller/http/fiber/decode.go","statements":6,"covered":6,"percent":100.00000000,"sha256":"edc7124058479046b7f2ac3db7ff84a7bfb4602265c549cf7808906d6fb48dfb"},
|
||||
{"file":"internal/store/postgres/messages.go","statements":21,"covered":20,"percent":95.23809524,"sha256":"45984d4dd4548f3ed96557bf5f8dac8b3b9fdf729e2b1296ef39f7860f0410db"},
|
||||
{"file":"internal/config/persistence.go","statements":15,"covered":15,"percent":100.00000000,"sha256":"671f92c52c827989ce194f3928b02f707292022bb97d3c483410e97cf626b4af"},
|
||||
{"file":"internal/service/production/errors.go","statements":5,"covered":5,"percent":100.00000000,"sha256":"fd37a3018f9d7ab72bc8d2b130be94967c4becd2bb09033cfb3caf26d4a5142d"},
|
||||
{"file":"internal/hashring/ring.go","statements":21,"covered":20,"percent":95.23809524,"sha256":"e205901cec2e66011ec764b70879b0eb0d28a78c4dea8913a9fb30c2d778fa8c"},
|
||||
{"file":"internal/admission/distributed.go","statements":0,"covered":0,"percent":null,"sha256":"41ef40897886c0878cbfe52f6716bdcb8433fb7eaddcfff298e1d54c55db423d"},
|
||||
{"file":"internal/store/memory/store.go","statements":3,"covered":3,"percent":100.00000000,"sha256":"473cd854d928b02b5a5f50dd7eae87c3f644259b1db0a0ad1e653f3691828c9e"},
|
||||
{"file":"internal/store/interface.go","statements":0,"covered":0,"percent":null,"sha256":"7e48fc1130123b259ce4c7d8b699262728d73ba0756c4607e0ad8ec4100c0e4b"},
|
||||
{"file":"cmd/server/main.go","statements":3,"covered":3,"percent":100.00000000,"sha256":"c22d8cdf4ce31fde29945e967d3f025e280a7dc4d2022329d51be972d2a0f495"},
|
||||
{"file":"internal/store/postgres/store.go","statements":46,"covered":43,"percent":93.47826087,"sha256":"697b8e9bd462b88b6a3d0e5027b1a6157cbb5567f42042b561ffff8274d4faae"},
|
||||
{"file":"internal/controller/http/fiber/mapping.go","statements":19,"covered":19,"percent":100.00000000,"sha256":"dfb7cb698cd2fa6b592d04f0986416a0ec58004be23deb3d44a5f55a9ea698e1"},
|
||||
{"file":"internal/controller/http/fiber/public_errors.go","statements":13,"covered":12,"percent":92.30769231,"sha256":"eb6b147bbfe46b7ea519d3d65d813e8b28eeaa735dbb77ffa74bae285bc91536"},
|
||||
{"file":"internal/controller/http/fiber/errors.go","statements":28,"covered":28,"percent":100.00000000,"sha256":"dbefa0ce973d65b269dfc5f229799b2c5bf16a99547d348eaf6668660a536fcf"},
|
||||
{"file":"internal/store/postgres/users.go","statements":21,"covered":20,"percent":95.23809524,"sha256":"034cd07af2e065a3a49ff8cca619ce1f4aaef96758a1fa0d12d1fb1319dcf9e9"},
|
||||
{"file":"internal/service/production/users.go","statements":19,"covered":19,"percent":100.00000000,"sha256":"b1bec2c45ca926d193f7956ae3e3ae0868e4e0f722577d0095c737c2484e4da5"},
|
||||
{"file":"internal/service/authentication/service.go","statements":48,"covered":47,"percent":97.91666667,"sha256":"398b9c206556e2cd0f57f8ebd0757ab50e061683483d63a3f4ed33d1978bb27d"},
|
||||
{"file":"internal/store/memory/users.go","statements":22,"covered":21,"percent":95.45454545,"sha256":"750fbcdb34c66262c9b39f535a7d0acb3403f85d1158e9719356fc312b7ec932"},
|
||||
{"file":"cmd/server/persistence.go","statements":18,"covered":18,"percent":100.00000000,"sha256":"e109fb168675a92f990a1c983656623b150ed866062caf718e6b1a1068e19f46"},
|
||||
{"file":"internal/controller/http/fiber/configure.go","statements":7,"covered":7,"percent":100.00000000,"sha256":"be356cf26c228958d51f5bafa4305d7325e81ab01065575acbc9b2d7a6ddd4bd"},
|
||||
{"file":"internal/service/cursor.go","statements":0,"covered":0,"percent":null,"sha256":"478c8c9aca24d0fc7c471dfba43dcdd3c5b78a9d2c4d97c87fbcc058640c99d0"},
|
||||
{"file":"internal/controller/http/fiber/lifecycle.go","statements":24,"covered":22,"percent":91.66666667,"sha256":"f39cf7a0049a2ed39d6cc1fcc66b44656d9d6120914d0e973b032e12f3d0de08"},
|
||||
{"file":"internal/controller/http/fiber/headers.go","statements":0,"covered":0,"percent":null,"sha256":"d32a9a01a8b391f4d986e14947a25a0504f4363335ea1524df05e0dd8e9e61bd"},
|
||||
{"file":"internal/config/memory.go","statements":11,"covered":11,"percent":100.00000000,"sha256":"86cdf9e90b576f4484946bfd9605333fc52077f38d3a39c5d71ddca4cdeecda0"},
|
||||
{"file":"internal/valkey/admission.go","statements":45,"covered":45,"percent":100.00000000,"sha256":"a25eb9130eeb832411fd7ab8a359a6d4e0ba39f7e12b71ec62917594293343f0"}
|
||||
],"passed":true}
|
||||
@@ -0,0 +1,92 @@
|
||||
GO="go" scripts/coverage.sh
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/cmd/server 2.112s coverage: 31.0% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/admission 1.352s coverage: 1.5% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/config 1.352s coverage: 7.6% of statements in ./...
|
||||
gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/controller coverage: 0.0% of statements
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/controller/http/fiber 1.607s coverage: 55.5% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/cursor 1.350s coverage: 2.8% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/hashring 1.919s coverage: 1.8% of statements in ./...
|
||||
? gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/model/dto [no test files]
|
||||
? gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/model/http [no test files]
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/password 2.497s coverage: 1.6% of statements in ./...
|
||||
? gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/service [no test files]
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/service/authentication 1.352s coverage: 4.9% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/service/production 1.369s coverage: 19.1% of statements in ./...
|
||||
? gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store [no test files]
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store/memory 1.356s coverage: 8.4% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store/postgres 2.388s coverage: 11.0% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/strictjson 1.255s coverage: 3.3% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/valkey 1.334s coverage: 10.6% of statements in ./...
|
||||
ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/student-tests 1.313s coverage: 0.0% of statements in ./...
|
||||
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
|
||||
93.94% internal/cursor/codec.go
|
||||
97.14% internal/valkey/client.go
|
||||
97.30% internal/controller/http/fiber/handlers.go
|
||||
100.00% internal/service/production/members.go
|
||||
100.00% internal/service/production/creation.go
|
||||
N/A internal/controller/interface.go
|
||||
N/A internal/model/http/models.go
|
||||
100.00% internal/config/config.go
|
||||
100.00% internal/service/production/messages.go
|
||||
100.00% internal/service/production/service.go
|
||||
N/A internal/service/errors.go
|
||||
90.00% cmd/server/logger.go
|
||||
N/A internal/model/dto/session.go
|
||||
100.00% internal/service/production/pagination.go
|
||||
100.00% internal/service/production/validation.go
|
||||
94.74% cmd/server/healthcheck.go
|
||||
100.00% internal/store/memory/capacity.go
|
||||
N/A internal/service/cache.go
|
||||
94.12% internal/service/production/pages.go
|
||||
100.00% internal/config/environment.go
|
||||
N/A internal/model/dto/models.go
|
||||
94.74% internal/valkey/cache.go
|
||||
N/A internal/service/interface.go
|
||||
100.00% internal/controller/http/fiber/routes.go
|
||||
100.00% internal/controller/http/fiber/health.go
|
||||
N/A internal/service/auth.go
|
||||
100.00% internal/admission/limiter.go
|
||||
100.00% internal/service/production/chats.go
|
||||
100.00% internal/config/logger.go
|
||||
100.00% internal/store/postgres/sessions.go
|
||||
100.00% internal/store/memory/chats.go
|
||||
94.74% internal/store/memory/messages.go
|
||||
N/A internal/controller/http/fiber/dependencies.go
|
||||
100.00% cmd/server/app.go
|
||||
92.31% internal/store/postgres/chats.go
|
||||
100.00% internal/controller/http/fiber/auth.go
|
||||
100.00% cmd/server/commands.go
|
||||
N/A internal/controller/http/fiber/error_codes.go
|
||||
100.00% internal/controller/http/fiber/controller.go
|
||||
95.83% internal/config/controller.go
|
||||
100.00% internal/controller/http/fiber/error_registry.go
|
||||
100.00% internal/service/production/access.go
|
||||
94.44% internal/password/password.go
|
||||
97.06% internal/controller/http/fiber/middleware.go
|
||||
100.00% internal/controller/fx.go
|
||||
97.30% internal/strictjson/decode.go
|
||||
100.00% internal/store/memory/ordering.go
|
||||
100.00% internal/controller/http/fiber/decode.go
|
||||
95.24% internal/store/postgres/messages.go
|
||||
100.00% internal/config/persistence.go
|
||||
100.00% internal/service/production/errors.go
|
||||
95.24% internal/hashring/ring.go
|
||||
N/A internal/admission/distributed.go
|
||||
100.00% internal/store/memory/store.go
|
||||
N/A internal/store/interface.go
|
||||
100.00% cmd/server/main.go
|
||||
93.48% internal/store/postgres/store.go
|
||||
100.00% internal/controller/http/fiber/mapping.go
|
||||
92.31% internal/controller/http/fiber/public_errors.go
|
||||
100.00% internal/controller/http/fiber/errors.go
|
||||
95.24% internal/store/postgres/users.go
|
||||
100.00% internal/service/production/users.go
|
||||
97.92% internal/service/authentication/service.go
|
||||
95.45% internal/store/memory/users.go
|
||||
100.00% cmd/server/persistence.go
|
||||
100.00% internal/controller/http/fiber/configure.go
|
||||
N/A internal/service/cursor.go
|
||||
91.67% internal/controller/http/fiber/lifecycle.go
|
||||
N/A internal/controller/http/fiber/headers.go
|
||||
100.00% internal/config/memory.go
|
||||
100.00% internal/valkey/admission.go
|
||||
@@ -0,0 +1,2 @@
|
||||
golangci-lint run ./...
|
||||
0 issues.
|
||||
@@ -0,0 +1,27 @@
|
||||
scripts/test-faults.sh
|
||||
UTC 2026-10-16T07:16:07Z
|
||||
b90581f613aa82866be2dce08afe725d9a7426a9
|
||||
6bfacaeabe25f14cc400f3ce83aca807692872c4d364797abf20969e65cdf6a4 internal/store/postgres/chats.go
|
||||
1d0179aa490fa03ed545141f9dc5b40e454a197689a8a40c244358d9ed3f229e internal/store/postgres/errors_test.go
|
||||
45984d4dd4548f3ed96557bf5f8dac8b3b9fdf729e2b1296ef39f7860f0410db internal/store/postgres/messages.go
|
||||
889a63b51b29012f4ae5499d1c0577fe29f2f2959b05629f8e123715cfc1f75f internal/store/postgres/sessions.go
|
||||
697b8e9bd462b88b6a3d0e5027b1a6157cbb5567f42042b561ffff8274d4faae internal/store/postgres/store.go
|
||||
601c9cde6c08314c6107bfaa79cbcc50e02768d38998d921ae825d0877cdc729 internal/store/postgres/store_test.go
|
||||
034cd07af2e065a3a49ff8cca619ce1f4aaef96758a1fa0d12d1fb1319dcf9e9 internal/store/postgres/users.go
|
||||
9dd4d2998e37c48e104298ae7bc9f311f193ff5212608f9c579cd569941d5054 internal/service/errors.go
|
||||
7e48fc1130123b259ce4c7d8b699262728d73ba0756c4607e0ad8ec4100c0e4b internal/store/interface.go
|
||||
eb6b147bbfe46b7ea519d3d65d813e8b28eeaa735dbb77ffa74bae285bc91536 internal/controller/http/fiber/public_errors.go
|
||||
97614aa2647c42caecc9ab265673702e4c7eede8d0f2281acf16f44ac1d0e6da scripts/test-faults.sh
|
||||
PASS: postgres stop authenticated history => 503 unavailable (0.001530s)
|
||||
PASS: postgres stop rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503
|
||||
PASS: postgres stop recovery preserves the original session and message
|
||||
PASS: postgres pause authenticated history => 503 unavailable (0.507818s)
|
||||
PASS: postgres pause rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503
|
||||
PASS: postgres pause recovery preserves the original session and message
|
||||
PASS: valkey stop authenticated history => 503 unavailable (0.503123s)
|
||||
PASS: valkey stop rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503
|
||||
PASS: valkey stop recovery preserves the original session and message
|
||||
PASS: valkey pause authenticated history => 503 unavailable (0.506513s)
|
||||
PASS: valkey pause rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503
|
||||
PASS: valkey pause recovery preserves the original session and message
|
||||
PASS: real dependency fault scenarios completed
|
||||
@@ -0,0 +1 @@
|
||||
go vet ./...
|
||||
@@ -25,6 +25,8 @@ func publicFailure(code, message string) error {
|
||||
// Unknown errors receive a fixed response without exposing their details.
|
||||
func publicError(err error) error {
|
||||
switch {
|
||||
case errors.Is(err, service.ErrUnavailable):
|
||||
return publicFailure(codeUnavailable, "dependency unavailable")
|
||||
case errors.Is(err, service.ErrInvalid):
|
||||
return fielderr.WithStatus(err, fielderr.NewStatusCode(codeInvalid), "invalid request")
|
||||
case errors.Is(err, service.ErrUnauthorized):
|
||||
|
||||
@@ -32,3 +32,12 @@ func TestPublicErrorSafety(t *testing.T) {
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
// TestPublicErrorUnavailable keeps dependency details out of the public envelope.
|
||||
func TestPublicErrorUnavailable(t *testing.T) {
|
||||
err := publicError(fmt.Errorf("private database detail: %w", service.ErrUnavailable))
|
||||
response := errorResponse(err, "request")
|
||||
if response.Error.Code != codeUnavailable || response.Error.Message != "dependency unavailable" {
|
||||
t.Fatalf("unexpected response: %+v", response)
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,8 +1,15 @@
|
||||
package service
|
||||
|
||||
import "errors"
|
||||
import (
|
||||
"errors"
|
||||
|
||||
"gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store"
|
||||
)
|
||||
|
||||
var (
|
||||
// ErrUnavailable preserves the dependency failure category across service boundaries.
|
||||
ErrUnavailable = store.ErrUnavailable
|
||||
|
||||
// ErrInvalid indicates invalid operation input.
|
||||
ErrInvalid = errors.New("invalid request")
|
||||
// ErrUnauthorized indicates an unresolved current user.
|
||||
|
||||
@@ -11,6 +11,9 @@ import (
|
||||
)
|
||||
|
||||
var (
|
||||
// ErrUnavailable means a required storage dependency cannot serve the operation.
|
||||
ErrUnavailable = errors.New("storage unavailable")
|
||||
|
||||
// ErrNotFound means a record does not exist.
|
||||
ErrNotFound = errors.New("record not found")
|
||||
|
||||
|
||||
@@ -43,16 +43,16 @@ func (s *Store) Chats(ctx context.Context, userID uuid.UUID, position dto.Positi
|
||||
"user": userID, "time": position.CreatedAt, "id": position.ID, "limit": limit,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
return nil, normalize(err)
|
||||
}
|
||||
defer rows.Close()
|
||||
chats := make([]dto.ChatDTO, 0)
|
||||
for rows.Next() {
|
||||
var chat dto.ChatDTO
|
||||
if err := rows.Scan(&chat.ID, &chat.Title, &chat.CreatedAt, &chat.MemberIDs); err != nil {
|
||||
return nil, err
|
||||
return nil, normalize(err)
|
||||
}
|
||||
chats = append(chats, chat)
|
||||
}
|
||||
return chats, rows.Err()
|
||||
return chats, normalize(rows.Err())
|
||||
}
|
||||
|
||||
@@ -0,0 +1,52 @@
|
||||
package postgres
|
||||
|
||||
import (
|
||||
"context"
|
||||
"errors"
|
||||
"fmt"
|
||||
"io"
|
||||
"net"
|
||||
"testing"
|
||||
|
||||
"github.com/jackc/pgx/v5/pgconn"
|
||||
|
||||
"gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store"
|
||||
)
|
||||
|
||||
// TestNormalizeUnavailable classifies dependency failures while retaining their causes.
|
||||
func TestNormalizeUnavailable(t *testing.T) {
|
||||
cases := []struct {
|
||||
name string
|
||||
err error
|
||||
}{
|
||||
{"deadline", context.DeadlineExceeded},
|
||||
{"closed stream", io.EOF},
|
||||
{"truncated stream", io.ErrUnexpectedEOF},
|
||||
{"network", &net.OpError{Op: "dial", Net: "tcp", Err: errors.New("refused")}},
|
||||
{"connection exception", &pgconn.PgError{Code: "08006"}},
|
||||
{"connection limit", &pgconn.PgError{Code: "53300"}},
|
||||
{"shutdown", &pgconn.PgError{Code: "57P01"}},
|
||||
{"crash", &pgconn.PgError{Code: "57P02"}},
|
||||
{"starting", &pgconn.PgError{Code: "57P03"}},
|
||||
}
|
||||
for _, tc := range cases {
|
||||
t.Run(tc.name, func(t *testing.T) {
|
||||
err := normalize(fmt.Errorf("operation failed: %w", tc.err))
|
||||
if !errors.Is(err, store.ErrUnavailable) || !errors.Is(err, tc.err) {
|
||||
t.Fatalf("failure category or cause lost: %T", tc.err)
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
// TestNormalizeUnexpected preserves programming errors instead of misclassifying them as outages.
|
||||
func TestNormalizeUnexpected(t *testing.T) {
|
||||
for _, code := range []string{"42601", "23503", "42P01"} {
|
||||
t.Run(code, func(t *testing.T) {
|
||||
err := &pgconn.PgError{Code: code}
|
||||
if normalize(err) != err {
|
||||
t.Fatal("unexpected SQL error was reclassified")
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
@@ -35,16 +35,16 @@ func (s *Store) Messages(ctx context.Context, chatID uuid.UUID, position dto.Pos
|
||||
"chat": chatID, "time": position.CreatedAt, "id": position.ID, "limit": limit,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
return nil, normalize(err)
|
||||
}
|
||||
defer rows.Close()
|
||||
messages := make([]dto.MessageDTO, 0)
|
||||
for rows.Next() {
|
||||
var message dto.MessageDTO
|
||||
if err := rows.Scan(&message.ID, &message.ChatID, &message.SenderID, &message.Text, &message.CreatedAt); err != nil {
|
||||
return nil, err
|
||||
return nil, normalize(err)
|
||||
}
|
||||
messages = append(messages, message)
|
||||
}
|
||||
return messages, rows.Err()
|
||||
return messages, normalize(rows.Err())
|
||||
}
|
||||
|
||||
@@ -32,5 +32,5 @@ func (s *Store) RevokeSession(ctx context.Context, hash string) error {
|
||||
ctx, cancel := context.WithTimeout(ctx, s.timeout)
|
||||
defer cancel()
|
||||
_, err := s.pool.Exec(ctx, `DELETE FROM sessions WHERE token_hash=@hash`, pgx.StrictNamedArgs{"hash": hash})
|
||||
return err
|
||||
return normalize(err)
|
||||
}
|
||||
|
||||
@@ -6,6 +6,9 @@ import (
|
||||
_ "embed"
|
||||
"errors"
|
||||
"fmt"
|
||||
"io"
|
||||
"net"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"github.com/jackc/pgx/v5"
|
||||
@@ -105,8 +108,20 @@ func normalize(err error) error {
|
||||
if errors.Is(err, pgx.ErrNoRows) {
|
||||
return store.ErrNotFound
|
||||
}
|
||||
if databaseError, ok := errors.AsType[*pgconn.PgError](err); ok && databaseError.Code == "23505" {
|
||||
return store.ErrConflict
|
||||
if databaseError, ok := errors.AsType[*pgconn.PgError](err); ok {
|
||||
if databaseError.Code == "23505" {
|
||||
return store.ErrConflict
|
||||
}
|
||||
if strings.HasPrefix(databaseError.Code, "08") || strings.HasPrefix(databaseError.Code, "53") ||
|
||||
databaseError.Code == "57P01" || databaseError.Code == "57P02" || databaseError.Code == "57P03" {
|
||||
return fmt.Errorf("%w: %w", store.ErrUnavailable, err)
|
||||
}
|
||||
}
|
||||
var networkError net.Error
|
||||
var connectError *pgconn.ConnectError
|
||||
if errors.Is(err, context.DeadlineExceeded) || errors.Is(err, io.EOF) || errors.Is(err, io.ErrUnexpectedEOF) ||
|
||||
errors.As(err, &networkError) || errors.As(err, &connectError) || pgconn.SafeToRetry(err) {
|
||||
return fmt.Errorf("%w: %w", store.ErrUnavailable, err)
|
||||
}
|
||||
return err
|
||||
}
|
||||
|
||||
@@ -54,5 +54,5 @@ func (s *Store) UsersExist(ctx context.Context, ids []uuid.UUID) (bool, error) {
|
||||
var exists bool
|
||||
err := s.pool.QueryRow(ctx, `SELECT NOT EXISTS (SELECT id FROM unnest(@ids::uuid[]) AS requested(id)
|
||||
WHERE NOT EXISTS (SELECT 1 FROM users WHERE users.id=requested.id))`, pgx.StrictNamedArgs{"ids": ids}).Scan(&exists)
|
||||
return exists, err
|
||||
return exists, normalize(err)
|
||||
}
|
||||
|
||||
Executable
+112
@@ -0,0 +1,112 @@
|
||||
#!/bin/sh
|
||||
# Exercise real dependency outages on disposable containers; never target the dev cluster.
|
||||
set -eu
|
||||
cd "$(dirname "$0")/.."
|
||||
umask 077
|
||||
work=$(mktemp -d)
|
||||
name="lab2-fault-$(basename "$work" | tr '[:upper:].' '[:lower:]-')"
|
||||
containers=
|
||||
cleanup() {
|
||||
for container in $containers; do
|
||||
docker unpause "$container" >/dev/null 2>&1 || true
|
||||
docker rm -f "$container" >/dev/null 2>&1 || true
|
||||
done
|
||||
docker network rm "$name" >/dev/null 2>&1 || true
|
||||
docker image rm "$name" >/dev/null 2>&1 || true
|
||||
rm -rf "$work"
|
||||
}
|
||||
trap cleanup EXIT
|
||||
trap 'exit 130' INT
|
||||
trap 'exit 143' TERM
|
||||
printf 'UTC %s\n' "$(date -u '+%Y-%m-%dT%H:%M:%SZ')"
|
||||
git rev-parse HEAD
|
||||
shasum -a 256 internal/store/postgres/*.go internal/service/errors.go internal/store/interface.go internal/controller/http/fiber/public_errors.go scripts/test-faults.sh
|
||||
# Build the working tree, including uncommitted fixes, without publishing an image.
|
||||
docker build -q -t "$name" . > "$work/build.txt"
|
||||
docker network create "$name" >/dev/null
|
||||
pg=$(docker run -d --network "$name" --network-alias postgres -e POSTGRES_PASSWORD=synthetic-fault-password -e POSTGRES_DB=messenger postgres:17.6-alpine)
|
||||
containers="$pg"
|
||||
cache=$(docker run -d --network "$name" --network-alias valkey valkey/valkey:8.1.3-alpine)
|
||||
containers="$containers $cache"
|
||||
for attempt in $(seq 1 60); do
|
||||
if docker exec "$pg" pg_isready -U postgres >/dev/null 2>&1; then break; fi
|
||||
sleep 1
|
||||
done
|
||||
api=$(docker run -d --network "$name" -p 127.0.0.1::8080 \
|
||||
-e DATABASE_URL=postgres://postgres:synthetic-fault-password@postgres:5432/messenger?sslmode=disable \
|
||||
-e VALKEY_SHARDS=shard0=valkey:6379 -e VALKEY_COORDINATOR=shard0 \
|
||||
-e DEPENDENCY_TIMEOUT_MS=500 -e LOG_LEVEL=error "$name")
|
||||
containers="$containers $api"
|
||||
base="http://$(docker port "$api" 8080/tcp)"
|
||||
: > "$work/anonymous"
|
||||
wait_ready() {
|
||||
for attempt in $(seq 1 60); do
|
||||
if curl -fsS --max-time 2 "$base/health/ready" >/dev/null 2>&1; then return; fi
|
||||
sleep 1
|
||||
done
|
||||
echo 'FAIL: API did not recover within 60 seconds' >&2
|
||||
exit 1
|
||||
}
|
||||
# Credentials remain in private temporary curl config files, never in evidence or argv.
|
||||
request() {
|
||||
method=$1; path=$2; expected=$3; auth=$4
|
||||
shift 4
|
||||
result=$(curl -sS --max-time 3 --config "$work/$auth" -X "$method" \
|
||||
-H 'Content-Type: application/json' -o "$work/response" \
|
||||
-w '%{http_code} %{time_total}' "$base$path" "$@")
|
||||
status=${result%% *}
|
||||
elapsed=${result#* }
|
||||
if [ "$status" != "$expected" ]; then
|
||||
printf 'FAIL: %s %s expected=%s actual=%s\n' "$method" "$path" "$expected" "$status" >&2
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
assert_error() {
|
||||
jq -e --arg code "$1" '.error.code == $code and (.error.request_id | type == "string") and (has("items") | not)' "$work/response" >/dev/null
|
||||
if rg -qi 'postgres|synthetic-fault-password|dial tcp|SELECT |SQLSTATE|redis|valkey|token_hash' "$work/response"; then
|
||||
echo 'FAIL: internal dependency details exposed' >&2
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
wait_ready
|
||||
request POST /api/v1/users 201 anonymous --data '{"username":"fault_actor","display_name":"Synthetic","password":"synthetic-user-password"}'
|
||||
user=$(jq -er .id "$work/response")
|
||||
printf 'header = "Authorization: Basic %s"\n' "$(printf 'fault_actor:synthetic-user-password' | openssl base64 -A)" > "$work/basic"
|
||||
request POST /api/v1/auth/sessions 201 basic
|
||||
jq -er '"header = \"Authorization: Bearer " + .token + "\""' "$work/response" > "$work/bearer"
|
||||
printf 'header = "X-User-Id: %s"\n' "$user" > "$work/spoofed"
|
||||
printf 'header = "Authorization: Bearer malformed"\n' > "$work/malformed"
|
||||
printf 'header = "Authorization: Bearer AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"\n' > "$work/unknown"
|
||||
request POST /api/v1/chats 201 bearer --data "{\"title\":\"Synthetic fault chat\",\"member_ids\":[\"$user\"]}"
|
||||
chat=$(jq -er .id "$work/response")
|
||||
history="/api/v1/chats/$chat/messages"
|
||||
request POST "$history" 201 bearer --data '{"text":"confirmed before outage"}'
|
||||
cp "$work/response" "$work/message"
|
||||
request GET "$history" 200 bearer
|
||||
for dependency in "$pg" "$cache"; do
|
||||
if [ "$dependency" = "$pg" ]; then label=postgres; else label=valkey; fi
|
||||
for fault in stop pause; do
|
||||
docker "$fault" "$dependency" >/dev/null
|
||||
request GET "$history" 503 bearer
|
||||
assert_error unavailable
|
||||
printf 'PASS: %s %s authenticated history => 503 unavailable (%ss)\n' "$label" "$fault" "$elapsed"
|
||||
request GET /health/ready 503 anonymous
|
||||
assert_error unavailable
|
||||
request GET /health/live 200 anonymous
|
||||
for auth in anonymous spoofed malformed unknown; do
|
||||
expected=503
|
||||
if [ "$label" = postgres ] && [ "$auth" != unknown ]; then expected=401; fi
|
||||
request GET "$history" "$expected" "$auth"
|
||||
if [ "$expected" = 401 ]; then assert_error unauthorized; else assert_error unavailable; fi
|
||||
done
|
||||
printf 'PASS: %s %s rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503\n' "$label" "$fault"
|
||||
if [ "$fault" = stop ]; then docker start "$dependency" >/dev/null; else docker unpause "$dependency" >/dev/null; fi
|
||||
wait_ready
|
||||
request GET "$history" 200 bearer
|
||||
jq -e --slurpfile message "$work/message" '.items == $message' "$work/response" >/dev/null
|
||||
request GET "$history" 401 anonymous
|
||||
assert_error unauthorized
|
||||
printf 'PASS: %s %s recovery preserves the original session and message\n' "$label" "$fault"
|
||||
done
|
||||
done
|
||||
printf 'PASS: real dependency fault scenarios completed\n'
|
||||
@@ -6,4 +6,8 @@ Go-тесты расположены рядом с кодом. `quality_test.go`
|
||||
|
||||
Тестовые controller fixtures заменяют только Authentication/Admission/Readiness: fixture Bearer равен UUID для изоляции бизнес-сценариев. Production Authentication всегда использует случайный токен и PostgreSQL; это отдельно проверяют unit tests authentication и настоящие HTTP smoke/expiry/persistence. Fixture токены не являются доступным режимом приложения.
|
||||
|
||||
`make research` запускает SQL из `research.sql` и `plans.sql` в новом временном контейнере, с ограничениями 1 CPU и 512 MiB. Исследуемые запросы находятся непосредственно в SQL, shell отвечает только за запуск PostgreSQL и dump/restore. Сохранённые ранее HTTP-проверки отказов и TTL описаны в `evidence/dependencies.json`; прежняя Python-обвязка удалена. Регрессионные проверки TTL и отказов клиентов остаются в Go-тестах рядом с реализацией.
|
||||
`make research` запускает SQL из `research.sql` и `plans.sql` в новом временном контейнере, с ограничениями 1 CPU и 512 MiB. Исследуемые запросы находятся непосредственно в SQL, shell отвечает только за запуск PostgreSQL и dump/restore.
|
||||
|
||||
`make test-faults` — воспроизводимый HTTP-сценарий реальных отказов PostgreSQL и Valkey. Нужны Docker, curl, jq, rg, OpenSSL и shasum. Скрипт собирает текущий код в локальный образ, создаёт отдельную Docker-сеть и временные контейнеры. Каждый backend по очереди останавливается и приостанавливается (`stop`/`pause`). Проверяются 503/unavailable с действительным токеном, ограничение ожидания 3 секундами при timeout зависимости 500 мс, readiness=503, liveness=200, отсутствие доступа без токена, по X-User-Id, с повреждённым и неизвестным Bearer. После каждого восстановления прежняя сессия читает подтверждённое сообщение без повторного входа. Секреты находятся только во временных файлах; вывод не содержит токенов или тел сообщений. Ресурсы удаляются через trap, dev-кластер не используется.
|
||||
|
||||
Свежий результат: [fault-regression.txt](../evidence/fault-regression.txt). Старые проверки в [dependencies.json](../evidence/dependencies.json) остаются историческими измерениями; текущий сценарий не зависит от удалённой Python-обвязки. TTL отдельно проверяется Go-тестами.
|
||||
|
||||
Reference in New Issue
Block a user