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 management на новом арендованном VPS. Решения и состав компонентов — в docs/netbird/design.md. Манифесты появятся в services/netbird/ после аренды VPS.
Ресурсы
- Git:
https://gitea.gunihome.ru/karpenok/homelab-infra