feat(netbird): плейбук и манифесты панели для запуска из Gitea
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
4a23e17290
commit
a1573775ef
12 files changed
+491
-24
No files matched your search
+13
-14
@@ -1,6 +1,6 @@
|
||||
# NetBird: архитектура overlay-сети
|
||||
|
||||
Статус: **проект**. VPS ещё не арендован. Документ фиксирует состав сервиса и решения, которые нужны до развёртывания.
|
||||
Статус: **установка панели**. Хост — `central.gunihome.ru`. Эталон файлов лежит в `services/netbird/`.
|
||||
|
||||
## Задача
|
||||
|
||||
@@ -12,13 +12,12 @@ NetBird — транспортный фундамент новой инфрас
|
||||
|
||||
| Компонент | Назначение | Порты |
|
||||
| --- | --- | --- |
|
||||
| Management | control plane: пиры, политики, ключи, координация | 443/tcp, 33073/tcp (gRPC) |
|
||||
| Signal | обмен метаданными для установления соединений | 10000/tcp |
|
||||
| Relay (TURN) | ретрансляция, если p2p не собрался | 3478/udp |
|
||||
| Dashboard | веб-панель | 443/tcp |
|
||||
| IdP | аутентификация. На старте — встроенный Zitadel | — |
|
||||
| `netbird-server` 0.82.0 | management, signal, relay и STUN в одном контейнере | 443/tcp через Traefik, 3478/udp |
|
||||
| Dashboard | веб-панель | 443/tcp через Traefik |
|
||||
| Traefik v3.7.14 | сертификат Let's Encrypt и маршрутизация | 80/tcp, 443/tcp |
|
||||
| Встроенный вход | пользователи панели без отдельного Zitadel | — |
|
||||
|
||||
Манифесты живут в `services/netbird/` и рассчитаны на доставку через Gitea Actions. Официальный установщик — ориентир по составу контейнеров, не способ запуска в проде.
|
||||
Манифесты живут в `services/netbird/` и доставляются сценарием Gitea Actions. Официальный установщик — ориентир по составу контейнеров, не способ запуска.
|
||||
|
||||
## Требования к VPS
|
||||
|
||||
@@ -28,7 +27,7 @@ NetBird — транспортный фундамент новой инфрас
|
||||
| Диск | 20 ГБ | база management растёт медленно |
|
||||
| Сеть | белый IPv4 | стабильность важнее локации |
|
||||
| ОС | Ubuntu 24.04 или Debian 12+ | baseline хоста тоже из этого репозитория |
|
||||
| Порты | 80, 443, 33073/tcp; 3478/udp | 10000/tcp, если signal на том же хосте |
|
||||
| Порты | 80, 443/tcp; 3478/udp | signal и API идут через 443 |
|
||||
|
||||
80/tcp нужен на выпуск Let's Encrypt. Дальше трафик панели и management идёт на 443.
|
||||
|
||||
@@ -49,15 +48,15 @@ Overlay NetBird — `100.64.0.0/10`.
|
||||
|
||||
## Решения до аренды VPS
|
||||
|
||||
1. **Домен.** Поддомен `gunihome.ru` для management и dashboard. Кто создаёт DNS-запись: вручную или через API.
|
||||
2. **IdP.** На старте встроенный Zitadel. Внешний IdP — отдельное решение, когда появится общий SSO.
|
||||
1. **Домен.** `central.gunihome.ru`, A-запись на адрес VPS создана вручную.
|
||||
2. **IdP.** На старте встроенный вход панели. Внешний IdP — отдельное решение, когда появится общий SSO.
|
||||
3. **Хостинг.** Провайдер и локация. На состав сервиса не влияют.
|
||||
4. **Бэкап базы management.** Куда складывать снимок и как часто. Решить до появления пиров кроме рабочей станции.
|
||||
|
||||
## Развёртывание
|
||||
|
||||
1. Аренда VPS. В репозитории появляется цель доставки, не отдельный каталог «хост».
|
||||
2. Baseline через код: пользователь `deploy`, SSH-ключ, firewall на порты из таблицы выше, Docker.
|
||||
3. Манифесты `services/netbird/` коммитятся и доставляются на VPS. Пока runner не подключён — по runbook из `services/netbird/README.md`, сразу следом — Gitea Actions.
|
||||
4. Сертификат, вход в dashboard, группы и политики из этого документа.
|
||||
1. Цель доставки — `central.gunihome.ru`. Отдельного каталога хоста нет.
|
||||
2. Сценарий `netbird-install` запускает плейбук `services/netbird/playbook.yml`. Плейбук ставит Docker, открывает порты из таблицы выше и поднимает панель.
|
||||
3. Сертификат выпускает Traefik. Первый администратор создаётся на `/setup`.
|
||||
4. Группы и политики из этого документа задаются уже в панели.
|
||||
5. Первый пир — рабочая станция. Проверка: пинг по overlay-адресу и SSH на management по адресу NetBird.
|
||||
Reference in new issue
Block a user