# 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`