[devel] repoteka — быстрый HTTP/JSON API метаданных apt-rpm репозиториев ALT

[Anton Farygin <rider@basealt.ru>]

Привет, коллеги.

Развернут сервис для программного доступа к метаданным apt-rpm 
репозиториев ALT.


Что это. Сервер на OCaml 5, загружает pkglist, srclist, release из веток 
ALT в память и отдаёт JSON. Поддерживает Sisyphus, p11, p10, c10f2 (и
любые другие, если положить в config). Все поля RPM — NEVRA, deps 
(provides/requires/conflicts/obsoletes), files, changelog, summary, 
group, packager,
disttag и т.д.


Для чего полезен. - TAB-дополнение имён пакетов в shell-обёртках (zoryn 
и аналогах) — миллисекундная задержка, поддержка smartcase
(prefix=Ope → только OpenUSD, OpenComposite, не утопит lowercase). - 
Поиск по подстроке, по префиксу, по архитектуре, по компоненту. - Обзор
зависимостей и обратных зависимостей пакетов в разных ветках. - 
Получение changelog по source_rpm (с дедупликацией для бинарных
подпакетов). - Питание дашбордов, ботов, CI-скриптов — всё через 
application/json, без парсинга нативных форматов. - Сравнение состояния
пакетов между ветками.


Где API живёт.
https://rdb.altlinux.org/repoteka/

Полная OpenAPI 3.0.3 спека — GET /openapi.json.

Примеры запросов:
# здоровье + статус всех веток
curl https://rdb.altlinux.org/repoteka/health
curl https://rdb.altlinux.org/repoteka/status

# список веток
curl https://rdb.altlinux.org/repoteka/branches

# карточка пакета (все варианты по веткам и архитектурам)
curl https://rdb.altlinux.org/repoteka/packages/curl

# карточка пакета с changelog
curl 'https://rdb.altlinux.org/repoteka/packages/curl?changelog=true'

# то же, но только в одной ветке
curl https://rdb.altlinux.org/repoteka/branches/sisyphus/packages/curl

# поиск по префиксу (TAB completion) — smartcase
curl 
'https://rdb.altlinux.org/repoteka/names?prefix=Ope&kind=source&limit=20'
# → 
["OpenBoard","OpenComposite","OpenSP","OpenSceneGraph","OpenStego","OpenUSD"]

curl 
'https://rdb.altlinux.org/repoteka/names?prefix=ope&kind=source&limit=5'
# → ["open-forms","open-fprintd","open-iscsi","open-isns","open-vm-tools"]

# поиск пакетов по подстроке c фильтрами
curl 
'https://rdb.altlinux.org/repoteka/packages?q=ssl&kind=binary&arch=x86_64&limit=10'

Архитектура коротко. Параллельная XZ-декомпрессия через OCaml 5 
Domains, zero-copy парсинг RPM-заголовков, интернирование всех
повторяющихся строк (placements, dep names, file paths, changelog 
authors), отсортированные per-branch массивы имён для O(log N) 
prefix-поиска.
Полная перезагрузка ~60 сек на Sisyphus+p10+p11+c10f2; атомарная замена 
snapshot, нулевой downtime запросов во время reload.

Локальная установка / свой репозиторий.

Сервис лёгкий, ставится одним RPM:
apt-get install repoteka
systemctl enable --now repoteka

По умолчанию слушает 0.0.0.0:1337. Конфиг — /etc/repoteka.toml. Можно 
прописать любые apt-rpm репозитории, не только официальные ALT
— подойдёт локальное зеркало, внутренний корпоративный репозиторий, 
форк/деривативная сборка, тестовая ветка:
listen_addr = "127.0.0.1"
listen_port = 1337
reload_interval_sec = 600

[[branches]]
path = "/srv/mirror/sisyphus"

[[branches]]
name = "internal"path = "/srv/repos/our-internal-repo"

[[branches]]
name = "derivative"
path = "/var/ftp/pub/distros/example-altlike"



Структура веток ожидается стандартная apt-rpm: 
<path>/<arch>/base/pkglist.<component>.xz + release. Память — ~1.5 ГБ на 
4 крупные ветки
уровня Sisyphus; для одной локальной ветки в разы меньше. Перезагрузка — 
фоном по mtime, без рестарта.


Это удобно, если хочется иметь свой быстрый JSON API над своим 
репозиторием — для CI, dev-инструментов, дашбордов внутри организации,
проверки derivative-сборок, локальной разработки против Sisyphus без 
сетевых походов.


Исходники, баги, патчи.
https://altlinux.space/rider/repoteka

Лицензия GPL-2.0-or-later. Пакет в Sisyphus: repoteka.

Если у кого-то есть кейсы, которые сейчас неудобно решать apt-кешем — 
пишите в issues, добавлю endpoint.

Regards,

Anton