DmitryandClaude Sonnet 5 05d8c748ab
lint / yamllint + ansible-lint + syntax-check (push) Canceled after 0s
feat: infrastructure dashboard (Homepage) generated from the service registry
playbooks/dashboard.yml deploys Homepage as a second compose stack on the
monitoring LXC (CT 155) next to Uptime Kuma and renders its config from
homelab_services: one tile per service, link to its UI, grouped by Proxmox
node. Adding a service to the registry is enough — no second service list.

- new registry consumer: playbooks/dashboard.yml + playbooks/templates/homepage-*.j2
- homelab_dashboard_* vars in group_vars/all/services.yml (top-level, like
  homelab_reverse_proxy_*); image pinned by digest, floating tag needs an
  explicit -e dashboard_allow_floating_tag=true
- bootstrap-dashboard-pve-token.yml: read-only homepage@pve!dashboard token
  (PVEAuditor) for the Proxmox widget, secret in the root .env as DASHBOARD_PVE_*
- Makefile: dashboard, dry-dashboard, bootstrap-dashboard-token
- container binds the LAN address only (192.168.1.30:8082), not published via Caddy
- docs: architecture.md Monitoring section, plan.md active task, consumer lists

Deployed to CT 155 on 2026-09-03: container healthy, http://192.168.1.30:8082/
returns 200, `make dashboard` idempotent, `make validate` and `make lint` green.
Pending operator steps: `make bootstrap-dashboard-token` (blocked in the agent
session as credential creation) and an Uptime Kuma status page with slug homelab.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KbuZrUoevfBgCpf5DCF4DG
2026-09-03 09:17:16 +03:00
2026-08-26 22:09:59 +03:00

HomeLab Infrastructure

Активная инфраструктура домашней лаборатории управляется через Ansible. Каноничные инструкции для людей и агентов — в AGENTS.md. Стабильный архитектурный контекст и риски — в docs/ai/.

Быстрый старт

Окружение собрано в Nix, venv не нужен:

nix develop                 # или один раз: direnv allow

# Один раз на клон
ansible-galaxy collection install -r ansible/requirements.yml -p ansible/collections

Всё управление — через make из ansible/:

cd ansible
make help                   # список целей, начинать отсюда
make check                  # связность и ожидаемые IP
make status                 # read-only сводка по всей инфраструктуре
make lint                   # ansible-lint + yamllint

Деплой и обновления:

make dry-gitea              # предпросмотр (--check --diff)
make deploy-gitea           # применить
make update-gitea           # бэкап -> обновление -> health-check

Секреты лежат в .env в корне репозитория.gitignore); его подхватывают и Ansible, и OpenTofu. Опасные цели требуют CONFIRM=1.

SSH руками

ansible/ssh_config — единый источник правды по SSH и для Ansible, и для терминала. Добавь в ~/.ssh/config, чтобы заработал ssh gitea:

Include /home/ada/Documents/Projects/HomeLab/infras/ansible/ssh_config

Структура

  • ansible/ — control plane: Makefile, inventory/, playbooks/, roles/, ssh_config
  • ansible/inventory/group_vars/all/services.yml — реестр сервисов (VMID, IP, порты, домены, образы)
  • flake.nix — dev-окружение
  • .gitea/workflows/lint.yml — CI: yamllint, ansible-lint, syntax-check
  • docs/ai/ — архитектура, stack, edge cases и legacy boundaries для агентов
  • archive/2026-07-proxmox-migration/ — исторические NixOS/Docker конфиги, только как справка

Grimmory MCP

tools/grimmory-mcp/ содержит read-only интеграцию с Grimmory API для OpenCode. Явно вызываемые sync tools записывают сгенерированные заметки и обложки в Obsidian.

npm install --prefix tools/grimmory-mcp
npm run configure --prefix tools/grimmory-mcp
npm test --prefix tools/grimmory-mcp

Глобальная регистрация MCP в OpenCode выполняется вне этого репозитория. После настройки используй /grimmory-sync для обновления заметок книг в 90 Library/Books и обложек в 99 System/Export/Grimmory/Covers.

S
Description
No description provided
Readme
1.7 MiB
Languages
HCL 25%
Jinja 24.4%
JavaScript 22.3%
Makefile 9.7%
Nix 6.7%
Other 11.9%