35 lines
2.2 KiB
Markdown
35 lines
2.2 KiB
Markdown
# homelab-infra
|
|
|
|
Инфраструктура как код для новой личной сети. Репозиторий описывает то, что мы разворачиваем с этого момента. Прежний homelab и текущие VPS сюда не переносятся.
|
|
|
|
## Идея
|
|
|
|
Репозиторий — единственный источник правды. Изменение коммитится сюда и доставляется через Gitea Actions. Правки на хостах вручную по SSH не являются способом ведения инфраструктуры.
|
|
|
|
**Сервисы первичны, хосты заменяемы.** Каталог сервиса не называется именем машины. Хост, на котором сервис окажется, и состав группы на этом хосте могут смениться без перестройки репозитория.
|
|
|
|
Первый сервис — overlay-сеть **NetBird**. Новый хост сначала входит в неё, потом получает роль.
|
|
|
|
## Структура
|
|
|
|
```
|
|
homelab-infra/
|
|
├── AGENTS.md # правила для AI-агентов
|
|
├── docs/
|
|
│ └── netbird/ # архитектура NetBird
|
|
├── services/
|
|
│ └── netbird/ # манифесты management, signal, relay, dashboard
|
|
└── .gitea/
|
|
└── workflows/ # пайплайны Gitea Actions
|
|
```
|
|
|
|
Новый сервис — это каталог `services/<имя>/` и, когда решение уже принято, страница в `docs/<имя>/`. Привязка к конкретному хосту появляется в манифесте только там, где без неё нельзя доставить сервис.
|
|
|
|
## Сейчас
|
|
|
|
Панель NetBird описана в `services/netbird/` и ставится сценарием `.gitea/workflows/netbird-install.yml` на `central.gunihome.ru`. Состав и решения — в `docs/netbird/design.md`.
|
|
|
|
## Ресурсы
|
|
|
|
- Git: `https://gitea.gunihome.ru/karpenok/homelab-infra`
|