docs: AI project context (docs/ai) and repository documentation refresh
- docs/ai/: stable, repo-verified context - README, architecture, tech-stack, edge-cases, plan (confirmed active work only), migration-tofu (the blue-green OpenTofu migration runbook and per-service findings), legacy-warning, links. - AGENTS.md: slimmed to a working contract that points at docs/ai instead of restating it; CLAUDE.md is an adapter that @-includes it. - README.md, ansible/README.md, ansible/roles/README.md, roles/lxc_docker_host/README.md: bring wording in line with the current control plane (Makefile entry point, registry, tofu, memoir-bot gone). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012uoq5AVK8mkBgg83Mq6o5V
This commit is contained in:
co-authored by
Claude Sonnet 5
parent
5e27ba2513
commit
d2e1e6876a
+14
-3
@@ -36,12 +36,23 @@ systemd-юнит `Type=oneshot` с `docker compose up -d --remove-orphans`,
|
||||
Подробности и пример плейбука Gitea на новых ролях:
|
||||
[`compose_service/README.md`](compose_service/README.md).
|
||||
|
||||
**Статус:** роли созданы и проверены синтаксически, но пока не подключены ни
|
||||
к одному живому сервису. Перевод `pve-*.yml` на них — отдельный этап.
|
||||
**Статус:** `compose_service` подключён в `playbooks/ru-vps-base.yml` (стек
|
||||
Caddy на ru-vps) — это его первый и пока единственный потребитель.
|
||||
`lxc_docker_host` не подключён нигде. Перевод `pve-*.yml` на обе роли —
|
||||
отдельный этап.
|
||||
|
||||
## Источник данных
|
||||
|
||||
Факты о сервисах (vmid, узел, адрес, порты, домен, образы с digest, ресурсы,
|
||||
бэкап, мониторинг, порядок автозапуска) собраны в реестре
|
||||
`ansible/inventory/group_vars/all/services.yml` (`homelab_services`).
|
||||
Его уже потребляет `playbooks/reverse-proxy.yml`.
|
||||
Программные потребители реестра:
|
||||
|
||||
- `playbooks/reverse-proxy.yml` — сборка Caddyfile;
|
||||
- `playbooks/ru-vps-base.yml` — стек Caddy и его закреплённый образ;
|
||||
- `playbooks/pve-backup-jobs.yml` — списки VMID заданий PBS (поле `backup.job`);
|
||||
- `roles/backup_audit` — VMID для аудита (флаг `monitoring.backup_audit_vmid`);
|
||||
- `playbooks/validate.yml` — сверка реестра с фактическим состоянием Proxmox.
|
||||
|
||||
Остальное (`pve-*.yml`, `status.yml`, monitoring, SSH config) по-прежнему
|
||||
дублирует значения и должно меняться согласованно.
|
||||
|
||||
@@ -5,8 +5,8 @@ Docker»: пакеты, проверка `/dev/fuse`, `storage-driver: fuse-over
|
||||
запуск демона и базовый UFW.
|
||||
|
||||
Роль вынесена из повторяющихся блоков `playbooks/pve-*.yml`
|
||||
(gitea, vaultwarden, mihomo, adguard, memoir-bot, docker-test, grimmory,
|
||||
hermes-ai) — суммарно около 350 строк копипасты.
|
||||
(gitea, vaultwarden, mihomo, adguard, docker-test, grimmory, hermes-ai) —
|
||||
суммарно около 350 строк копипасты.
|
||||
|
||||
## Что делает
|
||||
|
||||
|
||||
Reference in New Issue
Block a user