Инициализация канона общих ролей с ролью eget

2026-07-16 21:03:25 +03:00
commit aca0d03772
7 changed files with 265 additions and 0 deletions
@@ -0,0 +1,88 @@
+# eget
+
+Устанавливает утилиту [eget](https://github.com/zyedidia/eget) и через неё —
+пиновые бинарники релизов с GitHub (restic, rclone, btop, zellij и т.п.).
+
+Роль общая для всех серверных репозиториев; канон живёт в `ansible-roles`,
+копии вендорятся через `inv roles-pull`.
+
+## Что делает
+
+1. **Bootstrap eget.** Если нужной версии `eget` нет — качает архив релиза с
+   GitHub напрямую (сам себя eget обновить не может — chicken-and-egg),
+   распаковывает во временную директорию, ставит бинарник и убирает мусор.
+   Идемпотентно: сверяет `eget --version` с `eget_version`.
+2. **Установка пакетов.** Идёт по декларативному списку `eget_packages` и для
+   каждого вызывает `eget <repo> --tag <tag> --upgrade-only …`.
+
+## Идемпотентность и статус изменений
+
+`--upgrade-only` заставляет eget скачивать бинарник, только если релиз новее
+установленного файла (сравнение по mtime). Когда обновление не нужно, eget
+пишет в stderr `… requested release is not more recent than current version`
+и выходит с кодом 0.
+
+Роль **не** глушит вывод (`--quiet` убран намеренно) и по наличию этой
+подстроки (`eget_no_upgrade_marker`) выставляет `changed_when`: реальная
+установка → `changed`, пропуск → `ok`. Ненулевой код выхода eget (реальная
+ошибка) роняет таск штатно.
+
+> Ограничения `--upgrade-only` (сравнение по дате релиза vs mtime бинарника, а
+> не по версии — поэтому это **не** строгий пиннинг тега):
+>
+> - Бамп тега на релиз, опубликованный раньше текущей установки, и любой
+>   **даунгрейд** eget сочтёт «не новее» и не поставит (роль покажет `ok`).
+>   На практике теги двигают только вперёд на свежие релизы; откат версии —
+>   вручную (удалить бинарник, затем прогнать роль).
+> - Если имя бинарника не совпадает с последним сегментом `repo` (напр.
+>   `BurntSushi/ripgrep` → `rg`), eget не находит установленный файл, и роль
+>   будет **переустанавливать пакет каждый прогон** (рапортуя `changed`). Все
+>   текущие пакеты этим не задеты; для таких репозиториев ставь бинарник в
+>   отдельную директорию либо не полагайся на статус `changed`.
+
+## Переменные
+
+Полный список и значения по умолчанию — в `defaults/main.yml`.
+
+| Переменная | По умолчанию | Назначение |
+|------------|--------------|------------|
+| `eget_version` | `1.3.4` | Версия самой утилиты eget. |
+| `eget_install_path` | `/usr/bin/eget` | Куда ставить бинарник eget. |
+| `eget_download_url` | ссылка на релиз | URL архива eget (собирается из версии). |
+| `eget_download_checksum` | `""` | Необязательная проверка архива eget (формат `get_url.checksum`). |
+| `eget_packages_to` | `/usr/local/bin` | Директория для бинарников пакетов по умолчанию. |
+| `eget_packages` | `[]` | Декларативный список пакетов (см. ниже). |
+
+### Схема элемента `eget_packages`
+
+| Ключ | Обяз. | Назначение |
+|------|:----:|------------|
+| `repo` | да | `owner/repo` на GitHub, напр. `restic/restic`. |
+| `tag` | да | Пиновка версии, напр. `v0.18.1`. |
+| `to` | нет | Целевая директория; по умолчанию `eget_packages_to`. |
+| `asset` | нет | Один фильтр ассета, напр. `zip` или `^musl` (`^` — анти-матч). |
+| `assets` | нет | Список фильтров (каждый → свой `--asset`); приоритетнее `asset`. |
+| `file` | нет | `--file` glob для выбора файла из архива. |
+
+## Пример
+
+```yaml
+- name: "Install eget and pinned binaries"
+  hosts: all
+  tasks:
+    - name: "Install eget and tools"
+      ansible.builtin.import_role:
+        name: eget
+      vars:
+        eget_install_path: "/usr/local/bin/eget"
+        eget_packages_to: "/usr/local/bin"
+        eget_packages:
+          - {repo: "restic/restic", tag: "v0.18.1"}
+          - {repo: "rclone/rclone", tag: "v1.73.4", asset: "zip"}
+          - {repo: "bootandy/dust", tag: "v1.2.4", asset: "gnu"}
+          - {repo: "creativeprojects/resticprofile", tag: "v0.32.0", asset: "^no_self_update"}
+```
+
+## License
+
+MIT