refactor(ansible): разложить репозиторий по схеме Ansible
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
a23232ac1c
commit
27f15e7bc7
23 files changed
+277
-242
No files matched your search
@@ -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.
|
||||
|
||||
## Технические стандарты
|
||||
|
||||
|
||||
Reference in new issue
Block a user