2.0 KiB
2.0 KiB
homelab-infra
Инфраструктура как код для личной сети: домашний homelab, внешние VPS и overlay-сеть на базе NetBird.
Идея
Репозиторий — единственный источник правды о состоянии инфраструктуры. Правки на хостах вручную по SSH не вносятся: изменения коммитятся сюда, доставка — через Gitea Actions (GitOps).
Принцип: сервисы первичны, хосты — заменяемы. Конфигурация сервисов не привязана к конкретным машинам. Хосты и группы сервисов на них будут меняться — структура каталогов это учитывает.
Структура
homelab-infra/
├── AGENTS.md # правила для AI-агентов, работающих в этом репозитории
├── INVENTORY.md # карта инфраструктуры (хосты, IP, роли, статусы)
├── docs/
│ └── netbird/ # архитектура overlay-сети NetBird
├── services/
│ └── netbird/ # манифесты NetBird (management, signal, relay)
├── hosts/ # описания хостов (по одному каталогу на узел)
└── .gitea/
└── workflows/ # пайплайны Gitea Actions
Текущий фокус
Этап 0: проектирование и подготовка к развёртыванию NetBird management на новом арендованном VPS. См. docs/netbird/design.md.
Связанные ресурсы
- Вики и разборы: Trilium → «Хоумлаб» (человекочитаемая документация)
- Git:
https://gitea.gunihome.ru/karpenok/homelab-infra