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
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%