Co-authored-by: Cursor <cursoragent@cursor.com>
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