up
This commit is contained in:
1 parent
e5f1ca24e5
commit
4a23e17290
6 files changed
+62
-137
No files matched your search
@@ -1,33 +1,34 @@
|
||||
# homelab-infra
|
||||
|
||||
Инфраструктура как код для личной сети: домашний homelab, внешние VPS и overlay-сеть на базе NetBird.
|
||||
Инфраструктура как код для новой личной сети. Репозиторий описывает то, что мы разворачиваем с этого момента. Прежний homelab и текущие VPS сюда не переносятся.
|
||||
|
||||
## Идея
|
||||
|
||||
Репозиторий — единственный источник правды о состоянии инфраструктуры. Правки на хостах вручную по SSH не вносятся: изменения коммитятся сюда, доставка — через Gitea Actions (GitOps).
|
||||
Репозиторий — единственный источник правды. Изменение коммитится сюда и доставляется через Gitea Actions. Правки на хостах вручную по SSH не являются способом ведения инфраструктуры.
|
||||
|
||||
**Принцип: сервисы первичны, хосты — заменяемы.** Конфигурация сервисов не привязана к конкретным машинам. Хосты и группы сервисов на них будут меняться — структура каталогов это учитывает.
|
||||
**Сервисы первичны, хосты заменяемы.** Каталог сервиса не называется именем машины. Хост, на котором сервис окажется, и состав группы на этом хосте могут смениться без перестройки репозитория.
|
||||
|
||||
Первый сервис — overlay-сеть **NetBird**. Новый хост сначала входит в неё, потом получает роль.
|
||||
|
||||
## Структура
|
||||
|
||||
```
|
||||
homelab-infra/
|
||||
├── AGENTS.md # правила для AI-агентов, работающих в этом репозитории
|
||||
├── INVENTORY.md # карта инфраструктуры (хосты, IP, роли, статусы)
|
||||
├── AGENTS.md # правила для AI-агентов
|
||||
├── docs/
|
||||
│ └── netbird/ # архитектура overlay-сети NetBird
|
||||
│ └── netbird/ # архитектура NetBird
|
||||
├── services/
|
||||
│ └── netbird/ # манифесты NetBird (management, signal, relay)
|
||||
├── hosts/ # описания хостов (по одному каталогу на узел)
|
||||
│ └── netbird/ # манифесты management, signal, relay, dashboard
|
||||
└── .gitea/
|
||||
└── workflows/ # пайплайны Gitea Actions
|
||||
```
|
||||
|
||||
## Текущий фокус
|
||||
Новый сервис — это каталог `services/<имя>/` и, когда решение уже принято, страница в `docs/<имя>/`. Привязка к конкретному хосту появляется в манифесте только там, где без неё нельзя доставить сервис.
|
||||
|
||||
Этап 0: проектирование и подготовка к развёртыванию **NetBird management** на новом арендованном VPS. См. `docs/netbird/design.md`.
|
||||
## Сейчас
|
||||
|
||||
## Связанные ресурсы
|
||||
Проектируем **NetBird management** на новом арендованном VPS. Решения и состав компонентов — в `docs/netbird/design.md`. Манифесты появятся в `services/netbird/` после аренды VPS.
|
||||
|
||||
## Ресурсы
|
||||
|
||||
- Вики и разборы: Trilium → «Хоумлаб» (человекочитаемая документация)
|
||||
- Git: `https://gitea.gunihome.ru/karpenok/homelab-infra`
|
||||
Reference in new issue
Block a user