34 lines
2.1 KiB
Markdown
34 lines
2.1 KiB
Markdown
# 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`
|