Files
homelab-infra/README.md
T

2.1 KiB

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