- Split TODO into a thin status index plus docs/roadmap/ with one file per task (v0.4 reliability, v0.5 product, v0.6 research, icebox). - Add docs/architecture.md (current processes, packet/data path, layers, storage, metrics) and docs/development.md (rules, gates, DoD). - Add CHANGELOG.md reconstructed from history; move round details out of TODO. - Align docs with the code: config defaults and missing [detect]/ [protocol.http] sections, XDP metric names, ClickHouse table and TTL, Redis RDB restore, multiarch clang include, CLI binary name. - Add scripts/check_docs_links.sh and run it in CI. - release profile: thin LTO + one codegen unit. Binary 12.3 MB -> 9.7 MB, http parser bench 314 ns -> 278 ns; panic=abort stays off for catch_unwind in the Redis subscriber. - Drop the unused JWT role claim; fix 'rampart doctor' hints in the CLI.
3.7 KiB
3.7 KiB
v0.4 — XDP netns+veth harness в CI
| Milestone | v0.4 |
| Status | planned |
| Priority | P0 |
| Depends on | — |
Цель
Каждый PR проверяет XDP-программу на реальном ядре: загрузка через verifier, attach в netns, баны, whitelist, expiry — без ручных шагов на живой ноде.
Зачем
Сейчас scripts/xdp_ipv6_smoke.sh, xdp_pkt_test.sh и xdp_netns_smoke.sh
запускаются вручную. Регрессии ловятся только на реальном сервере, а раунд
2026-11 показал, что именно там ломается (UAF при чтении map, .rodata-раскладка,
имена карт в загрузчике). В конкурентном анализе (вывод №7) такой харнесс
отсутствует у всех — это наше преимущество в надёжности.
Scope
- Единая точка входа
scripts/xdp_ci.sh: поднимает netns+veth, собирает BPF черезbuild.rs, грузит программу, гоняет фазы v4/v6/ban/whitelist/expiry/udp. - Формат вывода и код возврата, пригодные для CI (без интерактивных шагов).
- CI-job: либо self-hosted runner с
CAP_BPF/CAP_NET_ADMIN, либо hostedubuntu-24.04сsudoи проверкой, что kernel ≥ 5.10 и программа реально загрузилась (не только скомпилировалась). - Документация: как запустить локально и что делать, если в окружении нет прав.
Non-goals
- Нагрузочный тест на 1M pps: это
deploy/test/stress/, отдельный стенд. - Проверка на всех драйверах: native/generic режимы достаточно проверить на veth.
Approach
- Обернуть существующие скрипты общим хелпером (создание netns/veth, cleanup через trap) — сейчас логика дублируется.
- Добавить
--ciрежим: короткие таймауты, машиночитаемые PASS/FAIL строки. - Job в
.github/workflows/ci.yml; при отсутствии прав — честныйSKIP, а не зелёный тест. - Регрессионный тест на загрузчик:
tests/xdp_object_maps.rsуже проверяет имена карт без root, оставить его обязательным.
Критерии приёмки
sudo bash scripts/xdp_ci.shпроходит на kernel ≥ 5.10 сbpftool.- CI-job падает при регрессе в
universal_filter.c,config.h,maps.h. - Нет root-прав — job выдаёт
SKIPс причиной, а не ложный успех. - README/testing.md и docs/testing.md описывают один и тот же путь запуска.
Верификация
sudo bash scripts/xdp_ci.sh на dev-машине + прогон job в PR с намеренно
сломанным заголовком config.h (должен упасть).
Риски
- GitHub-hosted runner может не дать
CAP_BPF; тогда нужен self-hosted runner. Решение принимается на этапе дизайна, до реализации. - veth не воспроизводит offload-поведение реального NIC; паддинг и VLAN
покрываются
xdp_pkt_test.shотдельно.