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 описана в services/netbird/ и ставится сценарием .gitea/workflows/netbird-install.yml на central.gunihome.ru. Состав и решения — в docs/netbird/design.md.

Ресурсы

  • Git: https://gitea.gunihome.ru/karpenok/homelab-infra
S
Description
Инфраструктура как код: homelab, VPS, overlay-сеть NetBird
Readme
1.6 MiB
0 Stars 1 Watchers 0 Forks
Languages
Python 47.3%
Jinja 33.5%
Shell 9.4%
HCL 5%
HTML 4.1%
Other 0.7%