From 37b3c7677e634f42691727db3fbcc0b840c5722c Mon Sep 17 00:00:00 2001 From: Colin Walters Date: Thu, 16 May 2024 12:00:35 -0400 Subject: [PATCH] docs: Describe offline updates with static deltas This one isn't immediately obvious that it's possible. Signed-off-by: Colin Walters --- docs/copying-deltas.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 docs/copying-deltas.md diff --git a/docs/copying-deltas.md b/docs/copying-deltas.md new file mode 100644 index 0000000000..60f02cdca3 --- /dev/null +++ b/docs/copying-deltas.md @@ -0,0 +1,32 @@ +--- +nav_order: 101 +--- + +# Static deltas for offline updates +{: .no_toc } + +1. TOC +{:toc} + + + +OSTree supports generating "self-contained" static delta files, via an +invocation similar to the following: + +``` +$ ostree --repo=/path/to/repo static-delta generate --min-fallback-size=0 --filename=delta-update-file --from= +``` + +Note the usage of `--min-fallback-size=0` to ensure that the delta is self-contained. + +Then, you can copy `delta-update-file` to a USB key or similar, and a target system can apply it via e.g.: + +``` +$ ostree --repo=/ostree/repo static-delta apply-offline /path/to/delta-update-file +``` + +The above invocation will merely apply the content into the repository. +To make it bootable, this will then need to be further followed up by e.g. `ostree admin deploy ` or +with a higher level tool such as `rpm-ostree`, via `rpm-ostree deploy :`. + +