Cоздание и обновление OSTree-репозитория NiceOS

.repo-файлы описывают источники RPM-пакетов для DNF. Во время сборки их читает rpm-ostree (через dnf/libdnf) и на их основе загружает нужные пакеты, перечисленные в treefile.

[niceos]
name=NiceOS $releasever ($basearch)
baseurl=https://p3.niceos.ru/niceos/$releasever/core
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-NICEOS

[niceos-updates]
name=NiceOS Updates $releasever ($basearch)
baseurl=https://p3.niceos.ru/niceos/$releasever/updates
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-NICEOS

Ref — это «ветка» в OSTree, по которой клиенты обращаются к нужному дереву (снимку системы). Именование обычно следует схеме:

osname/releasever/arch/profile
# пример:
niceos/5.2/x86_64/minimal

• Как клиенту выбрать ветку? Клиент знает свой arch, выбирает нужный releasever и желаемый profile (например, minimal или workstation), и подписывается на соответствующий ref.
• Один репозиторий может содержать много рефов для разных редакций и архитектур.

Каждый запуск сборки создаёт новый коммит — зафиксированное состояние файловой системы. Клиенты получают обновления, когда в репозитории появляется новый коммит по их ref.

# обновить summary
ostree summary --repo=/path/to/repo --update

# показать подробности summary
ostree summary -v --repo=/path/to/repo

Скрипт создаёт рабочую структуру и нормализует пути. Это гарантирует повторяемость и чистоту окружения.

• REPOPATH — корень рабочей области.
• REPODATAPATH = REPOPATH/repo — сам OSTree-репозиторий.
• CACHEDATAPATH = REPOPATH/cache — кэш сборки.
• REPOSDIR — каталог с .repo (автодетект или явно).

/srv/niceos/repos.d/
├─ repo/    # объекты OSTree, refs, summary
├─ cache/   # кэш rpm-ostree compose
└─ *.repo   # при автогенерации или если вы положили их сюда сами

Перед сборкой требуется наличие rpm-ostree и ostree. Опционально — tdnf для автоматической установки (если включено соответствующим флагом).

rpm-ostree --version
ostree --version
# при использовании автоустановки:
# mkostreerepo --repopath=... --auto-install

Если .repo не найдены, скрипт создаст дефолтные файлы с ID niceos, niceos-updates, niceos-extras. Эти ID должны совпадать с именами в repos внутри treefile.

[niceos]
name=NiceOS $releasever ($basearch)
baseurl=https://p3.niceos.ru/niceos/$releasever/core
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-NICEOS

[niceos-updates]
name=NiceOS Updates $releasever ($basearch)
baseurl=https://p3.niceos.ru/niceos/$releasever/updates
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-NICEOS

Если вы не указали свой JSON, скрипт сгенерирует минимальный treefile с базовыми пакетами, рефом и привязкой к вашим .repo.

{
  "osname": "niceos",
  "releasever": "5.2",
  "ref": "niceos/5.2/x86_64/minimal",
  "repos": ["niceos", "niceos-updates", "niceos-extras"],
  "packages": ["bash", "systemd", "linux"]
}

При первом запуске скрипт создаёт новый репозиторий в режиме archive-z2 (оптимально для публикации по HTTP/HTTPS).

# выполняется автоматически при отсутствии refs
ostree --repo=/srv/niceos/repos.d/repo init --mode=archive-z2

Главный шаг: rpm-ostree compose tree читает ваш treefile и .repo, собирает rootfs, а затем записывает новый коммит в репозиторий.

rpm-ostree compose tree --unified-core \
  --cachedir=/srv/niceos/repos.d/cache \
  --repo=/srv/niceos/repos.d/repo \
  /srv/niceos/repos.d/niceos-base.json

• По завершении появляется новый коммит по вашему ref.
• Повторный запуск → следующий коммит (история изменений сохраняется).

После каждого коммита скрипт обновляет индекс summary — он нужен клиентам, чтобы быстро увидеть новые версии и доступные рефы.

ostree summary --repo=/srv/niceos/repos.d/repo --update
ostree summary -v --repo=/srv/niceos/repos.d/repo

В конце скрипт сообщает, какой REF использован, какой получен commit SHA, и где лежит репозиторий. Это удобно для логов и CI.

# узнать последний коммит по ref вручную
ostree --repo=/srv/niceos/repos.d/repo rev-parse niceos/5.2/x86_64/minimal
# пример вывода:
# 1a2b3c4d5e6f7... (укорочено)

Это нормальное сообщение при первой сборке: репозиторий только создаётся, родительского коммита ещё нет.

• Убедитесь, что перед сборкой репозиторий инициализирован: ostree init --mode=archive-z2 (скрипт делает это сам).
• После успешного compose появится первый коммит: проверьте его ostree --repo=... log <ref>.

ostree --repo=/srv/niceos/repos.d/repo log niceos/5.2/x86_64/minimal

Утилита ostree не установлена или не в PATH.

command -v ostree || echo "ostree отсутствует"
ostree --version

Утилита rpm-ostree не установлена. Без неё сборка невозможна.

command -v rpm-ostree || echo "rpm-ostree отсутствует"
rpm-ostree --version

# пример с автоустановкой
mkostreerepo --repopath=/srv/niceos/repos.d --auto-install --verbose