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
@@ -0,0 +1,71 @@
|
|||||||
|
name: netbird-install
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
letsencrypt_email:
|
||||||
|
description: Почта для уведомлений Let's Encrypt
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
install:
|
||||||
|
runs-on: homelab
|
||||||
|
timeout-minutes: 30
|
||||||
|
steps:
|
||||||
|
- name: Запустить плейбук NetBird
|
||||||
|
env:
|
||||||
|
RUNNER_SSH_KEY: ${{ secrets.RUNNER_SSH_KEY }}
|
||||||
|
NETBIRD_LETSENCRYPT_EMAIL: ${{ inputs.letsencrypt_email }}
|
||||||
|
run: |
|
||||||
|
set -eu
|
||||||
|
if [ -z "${RUNNER_SSH_KEY}" ]; then
|
||||||
|
echo "В секретах нет RUNNER_SSH_KEY." >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
if [ -z "${NETBIRD_LETSENCRYPT_EMAIL}" ]; then
|
||||||
|
echo "Укажите почту Let's Encrypt при запуске." >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$(id -u)" -eq 0 ]; then
|
||||||
|
apt-get update
|
||||||
|
apt-get install -y git openssh-client ansible-core
|
||||||
|
else
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y git openssh-client ansible-core
|
||||||
|
fi
|
||||||
|
|
||||||
|
rm -rf /tmp/homelab-infra
|
||||||
|
git clone https://gitea.gunihome.ru/karpenok/homelab-infra.git /tmp/homelab-infra
|
||||||
|
sha="${GITHUB_SHA:-${GITEA_SHA:-}}"
|
||||||
|
if [ -n "${sha}" ]; then
|
||||||
|
git -C /tmp/homelab-infra checkout "${sha}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
install -d -m 700 "${HOME}/.ssh"
|
||||||
|
printf '%s\n' "${RUNNER_SSH_KEY}" > "${HOME}/.ssh/id_ed25519"
|
||||||
|
chmod 600 "${HOME}/.ssh/id_ed25519"
|
||||||
|
ssh-keyscan -H central.gunihome.ru >> "${HOME}/.ssh/known_hosts"
|
||||||
|
printf '%s\n' "central.gunihome.ru" > /tmp/netbird-inventory.ini
|
||||||
|
|
||||||
|
ansible-playbook /tmp/homelab-infra/services/netbird/playbook.yml \
|
||||||
|
-i /tmp/netbird-inventory.ini \
|
||||||
|
-u root \
|
||||||
|
--private-key "${HOME}/.ssh/id_ed25519" \
|
||||||
|
-e "netbird_letsencrypt_email=${NETBIRD_LETSENCRYPT_EMAIL}"
|
||||||
|
|
||||||
|
ready=0
|
||||||
|
for _ in $(seq 1 30); do
|
||||||
|
code=$(curl -sk -o /dev/null -w '%{http_code}' https://central.gunihome.ru/ || true)
|
||||||
|
echo "https://central.gunihome.ru/ -> ${code}"
|
||||||
|
if [ "${code}" = "200" ] || [ "${code}" = "302" ]; then
|
||||||
|
ready=1
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
sleep 10
|
||||||
|
done
|
||||||
|
if [ "${ready}" -ne 1 ]; then
|
||||||
|
echo "Панель не ответила по HTTPS за отведённое время." >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
@@ -2,6 +2,7 @@
|
|||||||
.env
|
.env
|
||||||
.env.*
|
.env.*
|
||||||
!.env.example
|
!.env.example
|
||||||
|
services/netbird/config.yaml
|
||||||
*.key
|
*.key
|
||||||
*.pem
|
*.pem
|
||||||
id_rsa*
|
id_rsa*
|
||||||
|
|||||||
@@ -1,22 +1,34 @@
|
|||||||
# Правила для AI-агентов
|
# Правила для AI-агентов
|
||||||
|
|
||||||
Ты — DevOps/SRE-ассистент, управляющий личной инфраструктурой на базе Docker Compose и GitOps (Gitea Actions). Этот файл — системные инструкции. Соблюдай их без напоминаний.
|
Ты — DevOps/SRE-ассистент, управляющий личной инфраструктурой на базе Ansible, Docker Compose и GitOps (Gitea Actions). Этот файл — системные инструкции. Соблюдай их без напоминаний.
|
||||||
|
|
||||||
## Контекст
|
## Контекст
|
||||||
|
|
||||||
- Репозиторий `homelab-infra` описывает **новую** инфраструктуру. Это единственный источник правды о том, что разворачивается отсюда.
|
- Репозиторий `homelab-infra` описывает **новую** инфраструктуру. Это единственный источник правды о том, что разворачивается отсюда.
|
||||||
- Прежний homelab, текущие VPS и их поломки — вне скоупа. Не инвентаризируй их, не предлагай починку и не переноси в этот репозиторий, пока пользователь явно не попросил.
|
- Прежний homelab, текущие VPS и их поломки — вне скоупа. Не инвентаризируй их, не предлагай починку и не переноси в этот репозиторий, пока пользователь явно не попросил.
|
||||||
- Инфраструктура строится вокруг overlay-сети **NetBird**: новый хост сначала входит в сеть, потом получает роль.
|
- Инфраструктура строится вокруг overlay-сети **NetBird**: новый хост сначала входит в сеть, потом получает роль.
|
||||||
- Сервисы первичны. Хост и набор сервисов на нём меняются. Не создавай каталог на каждую машину и не привязывай манифест к имени хоста, если цель доставки можно задать иначе.
|
- Сервисы первичны. Хост и набор сервисов на нём меняются. Не создавай каталог на каждую машину и не пиши отдельный плейбук, который описывает одну машину целиком.
|
||||||
- Trilium, дерево «Хоумлаб», — архив прежней лабы. Читать его только по прямой просьбе. Ветку «Работа» не читать.
|
- Trilium, дерево «Хоумлаб», — архив прежней лабы. Читать его только по прямой просьбе. Ветку «Работа» не читать.
|
||||||
|
|
||||||
## Границы (критически важно)
|
## Границы (критически важно)
|
||||||
|
|
||||||
1. **Рабочая инфраструктура (Iterika) — запретная зона.** Не подключайся и не изменяй хосты из рабочего SSH-конфига (`pve203`, `pve215`, `pve216`, `stata`, `bastion`, `billing` и остальные из `~/.ssh/config.d/work.conf`). Не читай заметки Trilium из ветки «Работа».
|
1. **Рабочая инфраструктура (Iterika) — запретная зона.** Не подключайся и не изменяй хосты из рабочего SSH-конфига (`pve203`, `pve215`, `pve216`, `stata`, `bastion`, `billing` и остальные из `~/.ssh/config.d/work.conf`). Не читай заметки Trilium из ветки «Работа».
|
||||||
2. **Секреты не хардкодить.** Никаких паролей, токенов, приватных ключей в манифестах и документах. Используй переменные окружения (`${VAR}`) и шаблоны (`*.template`). Реальные значения — только в Gitea Actions Secrets или локально в `.env` (в `.gitignore`).
|
2. **Секреты не хардкодить.** Никаких паролей, токенов, приватных ключей в манифестах и документах. Используй переменные окружения (`${VAR}`) и шаблоны Ansible (`*.j2`). Реальные значения — только в Gitea Actions Secrets или локально в `.env` (в `.gitignore`).
|
||||||
3. **Ничего не исполнять на хостах напрямую**, кроме явно read-only команд диагностики (`docker ps`, `df -h`, `systemctl status` и т.п.), и только после подтверждения пользователем.
|
3. **Ничего не исполнять на хостах напрямую**, кроме явно read-only команд диагностики (`docker ps`, `df -h`, `systemctl status` и т.п.), и только после подтверждения пользователем.
|
||||||
4. Деструктивные действия (удаление данных, рестарты боевых сервисов, правка фаервола) — только с явного подтверждения пользователя (human-in-the-loop).
|
4. Деструктивные действия (удаление данных, рестарты боевых сервисов, правка фаервола) — только с явного подтверждения пользователя (human-in-the-loop).
|
||||||
|
|
||||||
|
## Как устроена доставка
|
||||||
|
|
||||||
|
Три слоя, и у каждого своё место. Не смешивать их в одном файле.
|
||||||
|
|
||||||
|
1. **Хост один на всех.** Плейбук `playbooks/host.yml` готовит любую машину: Docker, базовый firewall, каталоги. Новый VPS попадает в inventory и получает этот плейбук. Задачи хоста не копируются внутрь сервиса.
|
||||||
|
2. **Сервис один на всех хостов, где он нужен.** Каталог `services/<имя>/` хранит Compose и шаблоны. Плейбук `playbooks/<имя>.yml` только доставляет этот сервис и в начале подключает плейбук хоста. Сотня сервисов — сотня таких пар, не сотня описаний машин.
|
||||||
|
3. **Кто где стоит — только inventory.** Имя хоста, группа и публичный домен сервиса лежат в `inventory/` и `group_vars/`. Compose, шаблоны и workflow получают их переменными. Не хардкодить адрес и домен в манифесте.
|
||||||
|
|
||||||
|
Gitea Actions запускает `ansible-playbook`. Сценарий не ставит пакеты, не правит firewall и не описывает контейнеры. Shell-скрипт не заменяет плейбук.
|
||||||
|
|
||||||
|
Шаблоны Ansible — `*.j2`. Секреты по-прежнему не в git: только `${VAR}` в Compose и плейсхолдеры в шаблонах.
|
||||||
|
|
||||||
## Технические стандарты
|
## Технические стандарты
|
||||||
|
|
||||||
- Только **Docker Compose v2** (`docker compose`, не `docker-compose`). Ключ `version:` в compose-файлах не указывать.
|
- Только **Docker Compose v2** (`docker compose`, не `docker-compose`). Ключ `version:` в compose-файлах не указывать.
|
||||||
|
|||||||
@@ -27,7 +27,7 @@ homelab-infra/
|
|||||||
|
|
||||||
## Сейчас
|
## Сейчас
|
||||||
|
|
||||||
Проектируем **NetBird management** на новом арендованном VPS. Решения и состав компонентов — в `docs/netbird/design.md`. Манифесты появятся в `services/netbird/` после аренды VPS.
|
Панель NetBird описана в `services/netbird/` и ставится сценарием `.gitea/workflows/netbird-install.yml` на `central.gunihome.ru`. Состав и решения — в `docs/netbird/design.md`.
|
||||||
|
|
||||||
## Ресурсы
|
## Ресурсы
|
||||||
|
|
||||||
|
|||||||
+13
-14
@@ -1,6 +1,6 @@
|
|||||||
# NetBird: архитектура overlay-сети
|
# NetBird: архитектура overlay-сети
|
||||||
|
|
||||||
Статус: **проект**. VPS ещё не арендован. Документ фиксирует состав сервиса и решения, которые нужны до развёртывания.
|
Статус: **установка панели**. Хост — `central.gunihome.ru`. Эталон файлов лежит в `services/netbird/`.
|
||||||
|
|
||||||
## Задача
|
## Задача
|
||||||
|
|
||||||
@@ -12,13 +12,12 @@ NetBird — транспортный фундамент новой инфрас
|
|||||||
|
|
||||||
| Компонент | Назначение | Порты |
|
| Компонент | Назначение | Порты |
|
||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| Management | control plane: пиры, политики, ключи, координация | 443/tcp, 33073/tcp (gRPC) |
|
| `netbird-server` 0.82.0 | management, signal, relay и STUN в одном контейнере | 443/tcp через Traefik, 3478/udp |
|
||||||
| Signal | обмен метаданными для установления соединений | 10000/tcp |
|
| Dashboard | веб-панель | 443/tcp через Traefik |
|
||||||
| Relay (TURN) | ретрансляция, если p2p не собрался | 3478/udp |
|
| Traefik v3.7.14 | сертификат Let's Encrypt и маршрутизация | 80/tcp, 443/tcp |
|
||||||
| Dashboard | веб-панель | 443/tcp |
|
| Встроенный вход | пользователи панели без отдельного Zitadel | — |
|
||||||
| IdP | аутентификация. На старте — встроенный Zitadel | — |
|
|
||||||
|
|
||||||
Манифесты живут в `services/netbird/` и рассчитаны на доставку через Gitea Actions. Официальный установщик — ориентир по составу контейнеров, не способ запуска в проде.
|
Манифесты живут в `services/netbird/` и доставляются сценарием Gitea Actions. Официальный установщик — ориентир по составу контейнеров, не способ запуска.
|
||||||
|
|
||||||
## Требования к VPS
|
## Требования к VPS
|
||||||
|
|
||||||
@@ -28,7 +27,7 @@ NetBird — транспортный фундамент новой инфрас
|
|||||||
| Диск | 20 ГБ | база management растёт медленно |
|
| Диск | 20 ГБ | база management растёт медленно |
|
||||||
| Сеть | белый IPv4 | стабильность важнее локации |
|
| Сеть | белый IPv4 | стабильность важнее локации |
|
||||||
| ОС | Ubuntu 24.04 или Debian 12+ | baseline хоста тоже из этого репозитория |
|
| ОС | 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.
|
80/tcp нужен на выпуск Let's Encrypt. Дальше трафик панели и management идёт на 443.
|
||||||
|
|
||||||
@@ -49,15 +48,15 @@ Overlay NetBird — `100.64.0.0/10`.
|
|||||||
|
|
||||||
## Решения до аренды VPS
|
## Решения до аренды VPS
|
||||||
|
|
||||||
1. **Домен.** Поддомен `gunihome.ru` для management и dashboard. Кто создаёт DNS-запись: вручную или через API.
|
1. **Домен.** `central.gunihome.ru`, A-запись на адрес VPS создана вручную.
|
||||||
2. **IdP.** На старте встроенный Zitadel. Внешний IdP — отдельное решение, когда появится общий SSO.
|
2. **IdP.** На старте встроенный вход панели. Внешний IdP — отдельное решение, когда появится общий SSO.
|
||||||
3. **Хостинг.** Провайдер и локация. На состав сервиса не влияют.
|
3. **Хостинг.** Провайдер и локация. На состав сервиса не влияют.
|
||||||
4. **Бэкап базы management.** Куда складывать снимок и как часто. Решить до появления пиров кроме рабочей станции.
|
4. **Бэкап базы management.** Куда складывать снимок и как часто. Решить до появления пиров кроме рабочей станции.
|
||||||
|
|
||||||
## Развёртывание
|
## Развёртывание
|
||||||
|
|
||||||
1. Аренда VPS. В репозитории появляется цель доставки, не отдельный каталог «хост».
|
1. Цель доставки — `central.gunihome.ru`. Отдельного каталога хоста нет.
|
||||||
2. Baseline через код: пользователь `deploy`, SSH-ключ, firewall на порты из таблицы выше, Docker.
|
2. Сценарий `netbird-install` запускает плейбук `services/netbird/playbook.yml`. Плейбук ставит Docker, открывает порты из таблицы выше и поднимает панель.
|
||||||
3. Манифесты `services/netbird/` коммитятся и доставляются на VPS. Пока runner не подключён — по runbook из `services/netbird/README.md`, сразу следом — Gitea Actions.
|
3. Сертификат выпускает Traefik. Первый администратор создаётся на `/setup`.
|
||||||
4. Сертификат, вход в dashboard, группы и политики из этого документа.
|
4. Группы и политики из этого документа задаются уже в панели.
|
||||||
5. Первый пир — рабочая станция. Проверка: пинг по overlay-адресу и SSH на management по адресу NetBird.
|
5. Первый пир — рабочая станция. Проверка: пинг по overlay-адресу и SSH на management по адресу NetBird.
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# Пример переменных. На хосте файл называется .env и создаётся плейбуком при первом запуске.
|
||||||
|
# Значения ключей сюда не записывать.
|
||||||
|
|
||||||
|
COMPOSE_PROJECT_NAME=netbird
|
||||||
|
NETBIRD_LETSENCRYPT_EMAIL=
|
||||||
|
NETBIRD_AUTH_SECRET=
|
||||||
|
NETBIRD_DATASTORE_KEY=
|
||||||
|
NETBIRD_SESSION_KEY=
|
||||||
@@ -1,11 +1,18 @@
|
|||||||
# services/netbird
|
# services/netbird
|
||||||
|
|
||||||
Манифесты NetBird: management, signal, relay, dashboard.
|
Эталон панели NetBird `0.82.0` для `https://central.gunihome.ru`.
|
||||||
|
|
||||||
Появятся после аренды VPS и ответов на вопросы из `docs/netbird/design.md`:
|
Установку делает Ansible-плейбук `playbook.yml`. Сценарий Gitea Actions только запускает его. Состав контейнеров совпадает с официальным установщиком релиза v0.82.0: `netbird-server`, панель и Traefik.
|
||||||
|
|
||||||
- `docker-compose.yml` — сервисы NetBird
|
| Файл | Назначение |
|
||||||
- `management.json.template` — конфигурация с плейсхолдерами `${VAR}`
|
| --- | --- |
|
||||||
- runbook развёртывания в этом файле
|
| `playbook.yml` | Плейбук: пакеты, firewall, ключи, запуск панели |
|
||||||
|
| `compose.yaml` | Сервисы, порты `80/tcp`, `443/tcp`, `3478/udp` |
|
||||||
|
| `templates/config.yaml.j2` | Шаблон сервера. Ключи подставляет плейбук |
|
||||||
|
| `templates/env.j2` | Шаблон `.env` для Compose |
|
||||||
|
| `dashboard.env` | Публичные адреса панели |
|
||||||
|
| `.env.example` | Имена переменных без значений |
|
||||||
|
|
||||||
Секреты (домен, ключи шифрования, пароли TURN, IdP) задаются переменными. Значения лежат в Gitea Actions Secrets или в локальном `.env`, который не коммитится.
|
`.env` и готовый `config.yaml` остаются на хосте в `/opt/netbird`. В git их нет. Повторный прогон не пересоздаёт ключи и не удаляет тома `netbird_data` и `netbird_traefik_letsencrypt`.
|
||||||
|
|
||||||
|
Кнопка запуска — сценарий `.gitea/workflows/netbird-install.yml`. В его журнале виден вывод плейбука: каждая задача отдельной строкой. После зелёного прогона первый администратор создаётся в браузере на `https://central.gunihome.ru/setup`.
|
||||||
@@ -0,0 +1,156 @@
|
|||||||
|
# Панель NetBird по образцу getting-started.sh из релиза v0.82.0.
|
||||||
|
# Встроенный Traefik выпускает сертификат Let's Encrypt и ведёт трафик на панель и сервер.
|
||||||
|
# Секрет почты и ключи подставляются из .env, который создаётся на хосте и в git не попадает.
|
||||||
|
|
||||||
|
name: netbird
|
||||||
|
|
||||||
|
services:
|
||||||
|
traefik:
|
||||||
|
image: traefik:v3.7.14
|
||||||
|
container_name: netbird-traefik
|
||||||
|
restart: unless-stopped
|
||||||
|
networks:
|
||||||
|
netbird:
|
||||||
|
ipv4_address: 172.30.0.10
|
||||||
|
command:
|
||||||
|
- "--log.level=INFO"
|
||||||
|
- "--accesslog=true"
|
||||||
|
- "--providers.docker=true"
|
||||||
|
- "--providers.docker.exposedbydefault=false"
|
||||||
|
- "--providers.docker.network=netbird_netbird"
|
||||||
|
- "--entrypoints.web.address=:80"
|
||||||
|
- "--entrypoints.websecure.address=:443"
|
||||||
|
- "--entrypoints.websecure.allowACMEByPass=true"
|
||||||
|
- "--entrypoints.web.http.aliasHeadersStrategy=delete"
|
||||||
|
- "--entrypoints.websecure.http.aliasHeadersStrategy=delete"
|
||||||
|
- "--entrypoints.websecure.transport.respondingTimeouts.readTimeout=0"
|
||||||
|
- "--entrypoints.websecure.transport.respondingTimeouts.writeTimeout=0"
|
||||||
|
- "--entrypoints.websecure.transport.respondingTimeouts.idleTimeout=0"
|
||||||
|
- "--entrypoints.web.http.redirections.entrypoint.to=websecure"
|
||||||
|
- "--entrypoints.web.http.redirections.entrypoint.scheme=https"
|
||||||
|
- "--certificatesresolvers.letsencrypt.acme.email=${NETBIRD_LETSENCRYPT_EMAIL}"
|
||||||
|
- "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json"
|
||||||
|
- "--certificatesresolvers.letsencrypt.acme.tlschallenge=true"
|
||||||
|
- "--serverstransport.forwardingtimeouts.responseheadertimeout=0s"
|
||||||
|
- "--serverstransport.forwardingtimeouts.idleconntimeout=0s"
|
||||||
|
- "--ping=true"
|
||||||
|
- "--ping.entrypoint=ping"
|
||||||
|
- "--entrypoints.ping.address=:8082"
|
||||||
|
ports:
|
||||||
|
- "443:443"
|
||||||
|
- "80:80"
|
||||||
|
volumes:
|
||||||
|
- /var/run/docker.sock:/var/run/docker.sock:ro
|
||||||
|
- netbird_traefik_letsencrypt:/letsencrypt
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "traefik", "healthcheck", "--ping"]
|
||||||
|
interval: 5s
|
||||||
|
timeout: 3s
|
||||||
|
retries: 10
|
||||||
|
start_period: 10s
|
||||||
|
logging:
|
||||||
|
driver: json-file
|
||||||
|
options:
|
||||||
|
max-size: "500m"
|
||||||
|
max-file: "2"
|
||||||
|
|
||||||
|
dashboard:
|
||||||
|
image: netbirdio/dashboard@sha256:340b13c00b84349572a2acc5605e907cb09250a9e6461c757097eabdb8e02f2c
|
||||||
|
container_name: netbird-dashboard
|
||||||
|
restart: unless-stopped
|
||||||
|
networks: [netbird]
|
||||||
|
env_file:
|
||||||
|
- ./dashboard.env
|
||||||
|
depends_on:
|
||||||
|
server-health:
|
||||||
|
condition: service_healthy
|
||||||
|
labels:
|
||||||
|
- traefik.enable=true
|
||||||
|
- traefik.http.routers.netbird-dashboard.rule=Host(`central.gunihome.ru`)
|
||||||
|
- traefik.http.routers.netbird-dashboard.entrypoints=websecure
|
||||||
|
- traefik.http.routers.netbird-dashboard.tls=true
|
||||||
|
- traefik.http.routers.netbird-dashboard.tls.certresolver=letsencrypt
|
||||||
|
- traefik.http.routers.netbird-dashboard.service=dashboard
|
||||||
|
- traefik.http.routers.netbird-dashboard.priority=1
|
||||||
|
- traefik.http.services.dashboard.loadbalancer.server.port=80
|
||||||
|
logging:
|
||||||
|
driver: json-file
|
||||||
|
options:
|
||||||
|
max-size: "500m"
|
||||||
|
max-file: "2"
|
||||||
|
|
||||||
|
dashboard-health:
|
||||||
|
image: curlimages/curl:8.22.0
|
||||||
|
network_mode: service:dashboard
|
||||||
|
depends_on:
|
||||||
|
dashboard:
|
||||||
|
condition: service_started
|
||||||
|
entrypoint: ["sleep", "infinity"]
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "curl", "-fsS", "http://127.0.0.1/"]
|
||||||
|
interval: 5s
|
||||||
|
timeout: 3s
|
||||||
|
retries: 10
|
||||||
|
start_period: 15s
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
netbird-server:
|
||||||
|
image: netbirdio/netbird-server:0.82.0
|
||||||
|
container_name: netbird-server
|
||||||
|
restart: unless-stopped
|
||||||
|
networks: [netbird]
|
||||||
|
ports:
|
||||||
|
- "3478:3478/udp"
|
||||||
|
volumes:
|
||||||
|
- netbird_data:/var/lib/netbird
|
||||||
|
- ./config.yaml:/etc/netbird/config.yaml:ro
|
||||||
|
command: ["--config", "/etc/netbird/config.yaml"]
|
||||||
|
labels:
|
||||||
|
- traefik.enable=true
|
||||||
|
- traefik.http.routers.netbird-grpc.rule=Host(`central.gunihome.ru`) && (PathPrefix(`/signalexchange.SignalExchange/`) || PathPrefix(`/management.ManagementService/`) || PathPrefix(`/management.ProxyService/`))
|
||||||
|
- traefik.http.routers.netbird-grpc.entrypoints=websecure
|
||||||
|
- traefik.http.routers.netbird-grpc.tls=true
|
||||||
|
- traefik.http.routers.netbird-grpc.tls.certresolver=letsencrypt
|
||||||
|
- traefik.http.routers.netbird-grpc.service=netbird-server-h2c
|
||||||
|
- traefik.http.routers.netbird-grpc.priority=100
|
||||||
|
- traefik.http.routers.netbird-backend.rule=Host(`central.gunihome.ru`) && (PathPrefix(`/relay`) || PathPrefix(`/ws-proxy/`) || PathPrefix(`/api`) || PathPrefix(`/oauth2`))
|
||||||
|
- traefik.http.routers.netbird-backend.entrypoints=websecure
|
||||||
|
- traefik.http.routers.netbird-backend.tls=true
|
||||||
|
- traefik.http.routers.netbird-backend.tls.certresolver=letsencrypt
|
||||||
|
- traefik.http.routers.netbird-backend.service=netbird-server
|
||||||
|
- traefik.http.routers.netbird-backend.priority=100
|
||||||
|
- traefik.http.services.netbird-server.loadbalancer.server.port=80
|
||||||
|
- traefik.http.services.netbird-server-h2c.loadbalancer.server.port=80
|
||||||
|
- traefik.http.services.netbird-server-h2c.loadbalancer.server.scheme=h2c
|
||||||
|
logging:
|
||||||
|
driver: json-file
|
||||||
|
options:
|
||||||
|
max-size: "500m"
|
||||||
|
max-file: "2"
|
||||||
|
|
||||||
|
server-health:
|
||||||
|
image: curlimages/curl:8.22.0
|
||||||
|
network_mode: service:netbird-server
|
||||||
|
depends_on:
|
||||||
|
netbird-server:
|
||||||
|
condition: service_started
|
||||||
|
entrypoint: ["sleep", "infinity"]
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "curl", "-fsS", "http://127.0.0.1:9000/health"]
|
||||||
|
interval: 5s
|
||||||
|
timeout: 3s
|
||||||
|
retries: 12
|
||||||
|
start_period: 20s
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
volumes:
|
||||||
|
netbird_data:
|
||||||
|
netbird_traefik_letsencrypt:
|
||||||
|
|
||||||
|
networks:
|
||||||
|
netbird:
|
||||||
|
driver: bridge
|
||||||
|
ipam:
|
||||||
|
config:
|
||||||
|
- subnet: 172.30.0.0/24
|
||||||
|
gateway: 172.30.0.1
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
# Панель за Traefik. Сертификат выпускает Traefik, поэтому LETSENCRYPT_DOMAIN=none.
|
||||||
|
NETBIRD_MGMT_API_ENDPOINT=https://central.gunihome.ru
|
||||||
|
NETBIRD_MGMT_GRPC_API_ENDPOINT=https://central.gunihome.ru
|
||||||
|
AUTH_AUDIENCE=netbird-dashboard
|
||||||
|
AUTH_CLIENT_ID=netbird-dashboard
|
||||||
|
AUTH_CLIENT_SECRET=
|
||||||
|
AUTH_AUTHORITY=https://central.gunihome.ru/oauth2
|
||||||
|
USE_AUTH0=false
|
||||||
|
AUTH_SUPPORTED_SCOPES=openid profile email groups
|
||||||
|
AUTH_REDIRECT_URI=/nb-auth
|
||||||
|
AUTH_SILENT_REDIRECT_URI=/nb-silent-auth
|
||||||
|
NGINX_SSL_PORT=443
|
||||||
|
LETSENCRYPT_DOMAIN=none
|
||||||
@@ -0,0 +1,161 @@
|
|||||||
|
---
|
||||||
|
# Плейбук панели NetBird. Его запускает сценарий Gitea Actions.
|
||||||
|
# Повторный прогон не пересоздаёт ключи и не удаляет данные панели.
|
||||||
|
|
||||||
|
- name: Установить панель NetBird
|
||||||
|
hosts: netbird
|
||||||
|
gather_facts: false
|
||||||
|
vars:
|
||||||
|
netbird_dir: /opt/netbird
|
||||||
|
|
||||||
|
tasks:
|
||||||
|
- name: Подготовить Python для Ansible
|
||||||
|
ansible.builtin.raw: DEBIAN_FRONTEND=noninteractive apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y python3 python3-apt
|
||||||
|
changed_when: false
|
||||||
|
|
||||||
|
- name: Собрать факты
|
||||||
|
ansible.builtin.setup:
|
||||||
|
|
||||||
|
- name: Поставить Docker и firewall
|
||||||
|
ansible.builtin.apt:
|
||||||
|
name:
|
||||||
|
- docker.io
|
||||||
|
- docker-compose-v2
|
||||||
|
- ufw
|
||||||
|
- openssl
|
||||||
|
- ca-certificates
|
||||||
|
state: present
|
||||||
|
update_cache: true
|
||||||
|
|
||||||
|
- name: Включить Docker
|
||||||
|
ansible.builtin.systemd:
|
||||||
|
name: docker
|
||||||
|
enabled: true
|
||||||
|
state: started
|
||||||
|
|
||||||
|
- name: Разрешить порты панели
|
||||||
|
ansible.builtin.command: ufw allow {{ item }}
|
||||||
|
register: ufw_rule
|
||||||
|
changed_when: "'added' in (ufw_rule.stdout | lower)"
|
||||||
|
loop:
|
||||||
|
- OpenSSH
|
||||||
|
- 80/tcp
|
||||||
|
- 443/tcp
|
||||||
|
- 3478/udp
|
||||||
|
|
||||||
|
- name: Проверить состояние firewall
|
||||||
|
ansible.builtin.command: ufw status
|
||||||
|
register: ufw_status
|
||||||
|
changed_when: false
|
||||||
|
|
||||||
|
- name: Включить firewall
|
||||||
|
ansible.builtin.command: ufw --force enable
|
||||||
|
when: "'Status: active' not in ufw_status.stdout"
|
||||||
|
changed_when: true
|
||||||
|
|
||||||
|
- name: Создать каталог панели
|
||||||
|
ansible.builtin.file:
|
||||||
|
path: "{{ netbird_dir }}"
|
||||||
|
state: directory
|
||||||
|
owner: root
|
||||||
|
group: root
|
||||||
|
mode: "0700"
|
||||||
|
|
||||||
|
- name: Проверить, созданы ли уже ключи
|
||||||
|
ansible.builtin.stat:
|
||||||
|
path: "{{ netbird_dir }}/.env"
|
||||||
|
register: netbird_env
|
||||||
|
|
||||||
|
- name: Проверить почту Let's Encrypt
|
||||||
|
ansible.builtin.assert:
|
||||||
|
that:
|
||||||
|
- netbird_letsencrypt_email is defined
|
||||||
|
- netbird_letsencrypt_email | length > 3
|
||||||
|
fail_msg: Укажите почту Let's Encrypt при запуске плейбука.
|
||||||
|
when: not netbird_env.stat.exists
|
||||||
|
|
||||||
|
- name: Сгенерировать ключи панели
|
||||||
|
ansible.builtin.shell: openssl rand -base64 32 | tr -d '\n'
|
||||||
|
register: netbird_generated_keys
|
||||||
|
changed_when: false
|
||||||
|
no_log: true
|
||||||
|
loop:
|
||||||
|
- auth
|
||||||
|
- datastore
|
||||||
|
- session
|
||||||
|
when: not netbird_env.stat.exists
|
||||||
|
|
||||||
|
- name: Запомнить новые ключи
|
||||||
|
ansible.builtin.set_fact:
|
||||||
|
netbird_auth_secret: "{{ netbird_generated_keys.results[0].stdout }}"
|
||||||
|
netbird_datastore_key: "{{ netbird_generated_keys.results[1].stdout }}"
|
||||||
|
netbird_session_key: "{{ netbird_generated_keys.results[2].stdout }}"
|
||||||
|
no_log: true
|
||||||
|
when: not netbird_env.stat.exists
|
||||||
|
|
||||||
|
- name: Прочитать сохранённые ключи
|
||||||
|
ansible.builtin.slurp:
|
||||||
|
src: "{{ netbird_dir }}/.env"
|
||||||
|
register: netbird_env_raw
|
||||||
|
no_log: true
|
||||||
|
when: netbird_env.stat.exists
|
||||||
|
|
||||||
|
- name: Разобрать сохранённые ключи
|
||||||
|
ansible.builtin.set_fact:
|
||||||
|
netbird_auth_secret: "{{ env_map['NETBIRD_AUTH_SECRET'] }}"
|
||||||
|
netbird_datastore_key: "{{ env_map['NETBIRD_DATASTORE_KEY'] }}"
|
||||||
|
netbird_session_key: "{{ env_map['NETBIRD_SESSION_KEY'] }}"
|
||||||
|
netbird_letsencrypt_email: "{{ env_map['NETBIRD_LETSENCRYPT_EMAIL'] }}"
|
||||||
|
vars:
|
||||||
|
env_lines: "{{ (netbird_env_raw.content | b64decode).splitlines() | reject('equalto', '') | list }}"
|
||||||
|
env_map: "{{ dict(env_lines | map('split', '=', 1)) }}"
|
||||||
|
no_log: true
|
||||||
|
when: netbird_env.stat.exists
|
||||||
|
|
||||||
|
- name: Записать .env
|
||||||
|
ansible.builtin.template:
|
||||||
|
src: env.j2
|
||||||
|
dest: "{{ netbird_dir }}/.env"
|
||||||
|
owner: root
|
||||||
|
group: root
|
||||||
|
mode: "0600"
|
||||||
|
no_log: true
|
||||||
|
when: not netbird_env.stat.exists
|
||||||
|
|
||||||
|
- name: Положить манифесты панели
|
||||||
|
ansible.builtin.copy:
|
||||||
|
src: "{{ playbook_dir }}/{{ item }}"
|
||||||
|
dest: "{{ netbird_dir }}/{{ item }}"
|
||||||
|
owner: root
|
||||||
|
group: root
|
||||||
|
mode: "0644"
|
||||||
|
loop:
|
||||||
|
- compose.yaml
|
||||||
|
- dashboard.env
|
||||||
|
|
||||||
|
- name: Собрать config.yaml
|
||||||
|
ansible.builtin.template:
|
||||||
|
src: config.yaml.j2
|
||||||
|
dest: "{{ netbird_dir }}/config.yaml"
|
||||||
|
owner: root
|
||||||
|
group: root
|
||||||
|
mode: "0600"
|
||||||
|
no_log: true
|
||||||
|
|
||||||
|
- name: Поднять панель
|
||||||
|
ansible.builtin.command: docker compose up -d
|
||||||
|
args:
|
||||||
|
chdir: "{{ netbird_dir }}"
|
||||||
|
register: compose_up
|
||||||
|
changed_when: "'Started' in compose_up.stderr or 'Created' in compose_up.stderr or 'Recreated' in compose_up.stderr"
|
||||||
|
|
||||||
|
- name: Показать состояние контейнеров
|
||||||
|
ansible.builtin.command: docker compose ps
|
||||||
|
args:
|
||||||
|
chdir: "{{ netbird_dir }}"
|
||||||
|
register: compose_ps
|
||||||
|
changed_when: false
|
||||||
|
|
||||||
|
- name: Итог установки
|
||||||
|
ansible.builtin.debug:
|
||||||
|
msg: "{{ compose_ps.stdout_lines + ['Первый вход: https://central.gunihome.ru/setup'] }}"
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
# Конфиг netbird-server. Собирает плейбук. Ключи берутся из фактов, не из git.
|
||||||
|
|
||||||
|
server:
|
||||||
|
listenAddress: ":80"
|
||||||
|
exposedAddress: "https://central.gunihome.ru:443"
|
||||||
|
stunPorts:
|
||||||
|
- 3478
|
||||||
|
metricsPort: 9090
|
||||||
|
healthcheckAddress: ":9000"
|
||||||
|
logLevel: "info"
|
||||||
|
logFile: "console"
|
||||||
|
|
||||||
|
authSecret: "{{ netbird_auth_secret }}"
|
||||||
|
dataDir: "/var/lib/netbird"
|
||||||
|
|
||||||
|
auth:
|
||||||
|
issuer: "https://central.gunihome.ru/oauth2"
|
||||||
|
signKeyRefreshEnabled: true
|
||||||
|
sessionCookieEncryptionKey: "{{ netbird_session_key }}"
|
||||||
|
dashboardRedirectURIs:
|
||||||
|
- "https://central.gunihome.ru/nb-auth"
|
||||||
|
- "https://central.gunihome.ru/nb-silent-auth"
|
||||||
|
cliRedirectURIs:
|
||||||
|
- "http://localhost:53000/"
|
||||||
|
|
||||||
|
reverseProxy:
|
||||||
|
trustedHTTPProxies:
|
||||||
|
- "172.30.0.10/32"
|
||||||
|
trustedPeers:
|
||||||
|
- "172.30.0.10/32"
|
||||||
|
|
||||||
|
store:
|
||||||
|
engine: "sqlite"
|
||||||
|
encryptionKey: "{{ netbird_datastore_key }}"
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
COMPOSE_PROJECT_NAME=netbird
|
||||||
|
NETBIRD_LETSENCRYPT_EMAIL={{ netbird_letsencrypt_email }}
|
||||||
|
NETBIRD_AUTH_SECRET={{ netbird_auth_secret }}
|
||||||
|
NETBIRD_DATASTORE_KEY={{ netbird_datastore_key }}
|
||||||
|
NETBIRD_SESSION_KEY={{ netbird_session_key }}
|
||||||
Reference in new issue
Block a user