Files

T

embeddevio c7f2ea128e deploy: гейт покрытия стенда и тестируемая health-заглушка (#56 )

- deploy/api_stub.py: make_server() выделен из main(), main(argv) — тесты поднимают
  настоящий сервер на порту 0 (покрытие api_stub.py 0 % -> 98 %).
- Makefile: make test-deploy (гейт ≥70 % через tests/deploy/pytest.ini),
  test-netns-ci прокидывает AWG_NS_EXEC_MODE.

Refs #21, Refs #15, Refs #56

2026-10-28 21:30:33 +03:00

api_stub.py

deploy: гейт покрытия стенда и тестируемая health-заглушка (#56 )

2026-10-28 21:30:33 +03:00

dev-stand.md

docs(#21 ): runbook dev-стенда — быстрый старт, таблица AC, зависимости и откат

2026-10-21 23:50:19 +03:00

docker-compose.dev.yml

docs(#21 ): в шапке compose описан авто-режим dev-up до #31

2026-10-22 00:13:07 +03:00

docker-compose.stub.yml

feat(#21 ): dev-стенд — compose-файлы, health-заглушка до #31

2026-10-21 23:49:11 +03:00

docker-compose.test.yml

netns: nsenter в topology.sh, netns_common и документации (#56 )

2026-10-28 21:30:22 +03:00

README.md

test(#21 ): тесты инвариантов compose, Make-цели стенда и обновлённый deploy/README

2026-10-21 23:50:01 +03:00

VERIFICATION-21.md

docs(#21 ): отчёт о фактических прогонах гейтов и AC на 192.168.1.147 (HEAD 7af9caba)

2026-10-22 00:16:00 +03:00

verify-dev-stand.sh

fix(#21 ): verify-dev-stand не даёт ложный [fail] после --force-recreate (перезапрос id)

2026-10-22 00:13:07 +03:00

README.md

deploy — сборка и развёртывание

Артефакт	Назначение	Задача
`Dockerfile`	multi-stage: amneziawg-go + awg-tools → runtime alpine	#18
`entrypoint.sh`	супервизор: `awg-agent` (root) + `awg-api`	#18
`docker-compose.dev.yml`	dev-стенд: порт 8080, тома `/config` `/data`, healthcheck	#21
`docker-compose.test.yml`	стенд для тестов	#21
`docker-compose.stub.yml`	DEV-ONLY оверрайд: health-заглушка до мержа #31	#21
`api_stub.py`	минимальный `/api/v1/health` для проверки плумбинга стенда	#21
`verify-dev-stand.sh`	проверка AC #21 на Docker-хосте (`make dev-verify`)	#21
`dev-stand.md`	runbook dev-стенда: запуск, AC, откат, pitfalls	#21
`grafana/`	дашборд JSON (опциональный профиль monitoring)	#46
`awg0.conf.example`	пример клиентского конфига	#22

Запуск по ТЗ (после релиза): --network=host, --device=/dev/net/tun, --cap-add=NET_ADMIN --cap-add=SYS_MODULE, --restart always.

Dev-стенд (задача #21)

make dev-up            # поднять стенд (compose project awg-dash-dev)
make dev-verify        # AC: health 200 + /config /data переживают restart
make dev-up-stub       # + health-заглушка, пока нет API (#31)
make dev-logs
make dev-down

Состояние: /opt/awg-dash-dev/{config,data} на Docker-хосте (AWG_DASH_HOST_DIR).
Хост-порт: AWG_DASH_PORT (по умолчанию 8180 — 8080 занят на dev-хосте; в контейнере всегда 8080).
Подробности, таблица AC, откат и pitfalls — dev-stand.md.

Тестовый стенд без реального провайдера

make test-netns        # netns-топология client/gw/uplink + мок WireGuard-endpoint
make test-netns-ci     # то же в привилегированном контейнере (путь для CI, #17)
make test-manifests    # статическая проверка compose-файлов (без Docker)
make lint-shell        # shellcheck для скриптов стенда

Описание топологии, тестов и pitfalls — ../tests/netns/README.md.