Co-authored-by: Cursor <cursoragent@cursor.com>
homelab-infra
Инфраструктура как код для новой личной сети. Репозиторий описывает то, что мы разворачиваем с этого момента. Прежний homelab и текущие VPS сюда не переносятся.
Идея
Репозиторий — единственный источник правды. Изменение коммитится сюда и доставляется через Gitea Actions. Правки на хостах вручную по SSH не являются способом ведения инфраструктуры.
Сервисы первичны, хосты заменяемы. Каталог сервиса не называется именем машины. Хост, на котором сервис окажется, и состав группы на этом хосте могут смениться без перестройки репозитория.
Первый сервис — overlay-сеть NetBird. Новый хост сначала входит в неё, потом получает роль.
Структура
homelab-infra/
├── inventories/prod/ # машины, группы площадок и сервисов
├── roles/host/ # подготовка любой машины
├── roles/netbird/ # панель NetBird
├── playbooks/ # host.yml, netbird.yml, site.yml
├── docs/netbird/
└── .gitea/workflows/
Новая машина — строка в inventories/prod/hosts.yml. Новый сервис — роль roles/<имя>/ и плейбук playbooks/<имя>.yml. Адрес подключения и домен в роли не пишутся.
Сейчас
Панель NetBird — роль roles/netbird. Куда её ставить, написано в inventories/prod/hosts.yml, группа netbird. Запуск — .gitea/workflows/netbird-install.yml. Состав сервиса — в docs/netbird/design.md.
Ресурсы
- Git:
https://gitea.gunihome.ru/karpenok/homelab-infra