refactor(ansible): разложить репозиторий по схеме Ansible

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
karpenokandCursor committed 2026-11-08 01:13:36 +07:00
1 parent a23232ac1c
commit 27f15e7bc7
23 files changed
+277 -242

No files matched your search

+17 -7
View File
@@ -19,15 +19,25 @@
## Как устроена доставка
Три слоя, и у каждого своё место. Не смешивать их в одном файле.
Схема из документации Ansible. Другую не выдумывать.
1. **Хост один на всех.** Плейбук `playbooks/host.yml` готовит любую машину: Docker, базовый firewall, каталоги. Новый VPS попадает в inventory и получает этот плейбук. Задачи хоста не копируются внутрь сервиса.
2. **Сервис один на всех хостов, где он нужен.** Каталог `services/<имя>/` хранит Compose и шаблоны. Плейбук `playbooks/<имя>.yml` только доставляет этот сервис и в начале подключает плейбук хоста. Сотня сервисов — сотня таких пар, не сотня описаний машин.
3. **Кто где стоит — только inventory.** Имя хоста, группа и публичный домен сервиса лежат в `inventory/` и `group_vars/`. Compose, шаблоны и workflow получают их переменными. Не хардкодить адрес и домен в манифесте.
```
inventories/prod/hosts.yml # машины и группы: home, vps и группа сервиса
inventories/prod/group_vars/ # значения группы. Домен сервиса лежит здесь
inventories/prod/host_vars/ # исключение одной машины, если оно нужно
roles/host/ # подготовка любой машины
roles/<сервис>/ # доставка одного сервиса
playbooks/host.yml
playbooks/<сервис>.yml
playbooks/site.yml # сначала все машины, затем сервисы на свои группы
```
Gitea Actions запускает `ansible-playbook`. Сценарий не ставит пакеты, не правит firewall и не описывает контейнеры. Shell-скрипт не заменяет плейбук.
Шаблоны Ansible — `*.j2`. Секреты по-прежнему не в git: только `${VAR}` в Compose и плейсхолдеры в шаблонах.
- `ansible_host` в `hosts.yml` — адрес подключения. Не DNS-имя: домашний DNS может подменить имя.
- Роль `host` не копировать в сервис. `site.yml` запускает её до сервисов.
- В роли `host` только общее: Docker и SSH. Порты сервиса и Compose — в роли сервиса.
- Gitea Actions выполняет `ansible-playbook playbooks/site.yml -i inventories/prod/hosts.yml --limit <группа>`. В сценарии нет адресов и имён машин.
- Новая машина — строка в `hosts.yml`. Новый сервис — роль и группа. Не описание машины.
- Шаблоны Ansible — `*.j2`. Секреты не в git.
## Технические стандарты