# План внедрения: контейнерный POC anycast-топологии FRR

**Дата:** 2026-09-03
**Источник:** [hld.md](../hld.md)

## Цель

Развернуть в Docker Compose топологию из `hld.md` (5 FRR-роутеров, anycast `10.200.200.1/32` на площадке A, клиентские сети площадки B) и убедиться, что трафик от клиентов B реально распределяется по ECMP между тремя anycast-узлами A1/A2/A3.

## Проверка окружения (выполнена)

- Docker 28.3.2 + Compose plugin v2.38.2 — доступны, `NET_ADMIN`-контейнеры работают.
- `frrouting/frr:latest` (Alpine 3.16) — тянется из Docker Hub, содержит `vtysh`, `zebra`, `bgpd`, `staticd`, `ip`, `ping`, `python3`, `nc`. Кастомный образ не нужен.
- Модуль ядра `dummy` доступен — anycast-интерфейс на A-узлах создаётся в рантайме через `ip link add dummy0 type dummy`.
- `containerlab` не устанавливаем — Docker Compose с `internal`-сетями на каждый p2p-линк полностью закрывает задачу без дополнительных зависимостей.

## Архитектура

Каждый линк HLD (`/30` A↔B, `/24` клиентские сегменты) — отдельная Docker-сеть `internal: true` со статическими IP на участниках (без Docker-gateway, который иначе занял бы адрес в `/30`).

| Сеть | CIDR | Участники |
|---|---|---|
| `link-a1-b1` | 10.0.1.0/30 | a1 (.1), b1 (.2) |
| `link-a1-b2` | 10.0.2.0/30 | a1 (.1), b2 (.2) |
| `link-a2-b1` | 10.0.3.0/30 | a2 (.1), b1 (.2) |
| `link-a2-b2` | 10.0.4.0/30 | a2 (.1), b2 (.2) |
| `link-a3-b1` | 10.0.5.0/30 | a3 (.1), b1 (.2) |
| `link-a3-b2` | 10.0.6.0/30 | a3 (.1), b2 (.2) |
| `net-b1-clients` | 10.100.1.0/24 | b1 (.1), c1 (.11), c2 (.12), c3 (.13) |
| `net-b2-clients` | 10.100.2.0/24 | b2 (.1), c4 (.14), c5 (.15), c6 (.16) |

- **a1/a2/a3**: `frrouting/frr:latest`, `cap_add: [NET_ADMIN, NET_RAW]`. Кастомный entrypoint создаёт `dummy0` (`10.200.200.1/32`) и поднимает HTTP-responder на этом адресе (отдаёт hostname контейнера — видно, какой узел ответил), затем стартует штатный `docker-start` FRR. Конфиг — прямая транскрипция A1/A2/A3 из `hld.md`.
- **b1/b2**: `frrouting/frr:latest`, конфиг — транскрипция B1/B2 из `hld.md` (`bgp bestpath as-path multipath-relax`, `maximum-paths 3`).
- **c1…c6**: `nicolaka/netshoot` (ping/curl/traceroute/iperf3/mtr), entrypoint выставляет статический IP и `ip route add default via <B-роутер>`.

## Файлы

```
docker-compose.yml
frr/{a1,a2,a3,b1,b2}/{daemons,frr.conf,vtysh.conf}
entrypoints/{a-entrypoint.sh,b-entrypoint.sh,client-entrypoint.sh}
scripts/{verify.sh,traffic-test.sh}
docs/2026-09-03-anycast-lab-plan.md      (этот файл)
docs/2026-09-03-anycast-lab-summary.md   (по завершении)
README.md                                 (дополняется)
```

## Шаги

1. FRR-конфиги для 5 узлов (daemons, frr.conf, vtysh.conf).
2. Entrypoint-скрипты (dummy0 + anycast responder для A; статическая адресация для клиентов).
3. `docker-compose.yml` — 8 сетей + 5 роутеров + 6 клиентов.
4. `scripts/verify.sh` — проверка BGP-сессий (Established) и ECMP-маршрута до `10.200.200.1/32` (3 пути) на b1/b2.
5. `scripts/traffic-test.sh` — ping/traceroute/curl-цикл с клиентов, демонстрирующий распределение трафика по A1/A2/A3.
6. Поднятие (`docker compose up -d`), прогон проверок.
7. Обновление `README.md`.
8. Summary-артефакт с результатами.

## Definition of done

- Все 13 контейнеров поднимаются без ошибок.
- На b1/b2: 3 Established BGP-сессии, 3 ECMP-пути до `10.200.200.1/32`.
- С клиентов `ping 10.200.200.1` проходит; `traffic-test.sh` показывает ответы от разных anycast-узлов (a1/a2/a3) при варьировании src-port.