Appendix A. Terminology and commands

This section provides the rpmostree terminology and commands.

A.1. OSTree and rpm-ostree terminology

Following are some helpful terms that are used in context to OSTree and rpm-ostree images.

Table A.1. OSTree and rpm-ostree terminology

Term	Definition
OSTree	A tool used for managing Linux-based operating system versions. The OSTree tree view is similar to Git and is based on similar concepts.
rpm-ostree	A hybrid image or system package that hosts operating system updates.
Commit	A release or image version of the operating system. Image Builder generates an ostree commit for RHEL for Edge images. You can use these images to install or update RHEL on Edge servers.
Refs	Represents a branch in Git. Refs always resolve to the latest commit. For example, `rhel/8/x86_64/edge`.
Revision (Rev)	SHA-1 for a specific commit.
Remote	The http or https endpoint that hosts the ostree content. This is analogous to the baseurl for a yum repository.
static-delta	Updates to ostree images are always delta updates. In case of RHEL for Edge images, the TCP overhead can be higher than expected due to the updates to number of files. To avoid TCP overhead, you can generate static-delta between specific commits, and send the update in a single connection. This optimization helps large deployments with constrained connectivity.

This section provides a few rpmostree commands that you can use when installing or managing rpmostree images.

Table A.2. rpmostree commands

ostree pull	`ostree pull-local --repo [path] src` `ostree pull-local <path> <rev> --repo=<repo-path>` `ostree pull <URL> <rev> --repo=<repo-path>`
ostree summary	`ostree summary -u --repo=<repo-path>`
Query packages	`rpm-ostree --repo=/home/gicmo/Code/src/osbuild-iot/build/repo/ db list <REV>`
View refs	`ostree refs --repo ~/Code/src/osbuild-iot/build/repo/ --list`
View commits in repo	`ostree log --repo=/home/gicmo/Code/src/osbuild-iot/build/repo/ <REV>`
Inspect a commit	`ostree show --repo build/repo <REV>`
List remotes of a repo	`ostree remote list --repo <repo-path>`
Resolve a REV	`ostree rev-parse --repo ~/Code/src/osbuild-iot/build/repo fedora/x86_64/osbuild-demo` `ostree rev-parse --repo ~/Code/src/osbuild-iot/build/repo b3a008eceeddd0cfd`
Create static-delta	`ostree static-delta generate --repo=[path] --from=REV --to=REV`
Sign in	`ostree gpg-sign --repo=<repo-path> --gpg-homedir <gpg_home> COMMIT KEY-ID…`