rpm-ostree/docs
Jonathan Lebon 271954a41c app: Add rpm-ostree compose extensions
This adds support for a new `rpm-ostree compose extensions` command`
which takes a treefile, a new extensions YAML file, and an OSTree repo
and ref. It performs a depsolve and downloads the extensions to a
provided output directory.

This is intended to replace cosa's `download-extensions`:
https://github.com/coreos/coreos-assembler/blob/master/src/download-extensions

The input YAML schema matches the one accepted by that script.

Some differences from the script:
- We have a guaranteed depsolve match and thus can avoid silly issues
  we've hit in RHCOS (like downloading the wrong `libprotobuf` for
  `usbguard` -- rhbz#1889694).
- We seamlessly re-use the same repos defined in the treefile, whereas
  the cosa script uses `reposdir=$dir` which doesn't have the same
  semantics (repo enablement is in that case purely based on the
  `enabled` flag in those repos, which may be different than what the
  rpm-ostree compose ran with).
- We perform more sanity-checks against the requested extensions, such
  as whether the extension is already in the base.
- We support no-change detection via a state SHA512 file for better
  integration in cosa and pipelines.
- We support a `match-base-evr` key, which forces the extension to have
  the same EVR as the one from a base package: this is helpful in the
  case of extensions which complement a base package, esp. those which
  may not have strong enough reldeps to enforce matching EVRs by
  depsolve alone (`kernel-headers` is an example of this).
- We don't try to organize the RPMs into separate directories by
  extension because IMO it's not at the right level. Instead, we should
  work towards higher-level metadata to represent extensions (see
  https://github.com/openshift/os/issues/409 which is related to this).

Closes: #2055
2021-01-23 17:12:09 +01:00
..
_sass/color_schemes docs: Add Jekyll and theme config 2020-10-01 12:01:25 -04:00
_config.yml docs: Add Jekyll and theme config 2020-10-01 12:01:25 -04:00
administrator-handbook.md Rename livefs → apply-live in more places 2021-01-12 03:15:49 -05:00
background.md docs: Move and update Background page 2020-10-01 12:01:25 -04:00
compose-server.md docs: Update links to the OSTree documentation 2020-11-17 14:14:23 +01:00
CONTRIBUTING.md app: Add rpm-ostree compose extensions 2021-01-23 17:12:09 +01:00
countme.md countme: Add DNF Count Me support 2021-01-13 14:53:50 -05:00
extensions.md app: Add rpm-ostree compose extensions 2021-01-23 17:12:09 +01:00
favicon.ico docs: Add Jekyll and theme config 2020-10-01 12:01:25 -04:00
HACKING.md app: Add rpm-ostree compose extensions 2021-01-23 17:12:09 +01:00
index.md docs: Update links to the OSTree documentation 2020-11-17 14:14:23 +01:00
RELEASE.md app: Add rpm-ostree compose extensions 2021-01-23 17:12:09 +01:00
repo_structure.md app: Add rpm-ostree compose extensions 2021-01-23 17:12:09 +01:00
treefile.md Default to sqlite rpmdb backend on f34 2020-12-21 19:01:48 -05:00