No description
Find a file
Christian Kellner 03411015a2 docs: document osbuild and selinux integration
Add a first outline of the integration points of osbuild and
selinux, from two perspectives: how osbuild interacts with
the host and how osbuild labels the target artefact and the
resulting peculiarties.
2021-10-01 11:02:32 +02:00
.devcontainer devcontainer: include packit, boto3 & more tools 2021-08-17 10:42:03 +02:00
.github ci: trigger gitlab from checks not tests 2021-09-29 20:07:59 +02:00
assemblers assembler/ostree.commit: fix copying of links 2021-07-16 10:32:12 +02:00
devices devices/loopback: it is flush_buf not flushbuf 2021-08-14 13:25:19 +02:00
docs docs: add --export option to the osbuild man page 2021-07-14 14:35:30 +02:00
inputs inputs/ostree.checkout: don't overwrite refs 2021-08-24 01:21:03 +02:00
mounts mounts: add org.osbuild.noop 2021-07-21 13:28:22 +02:00
osbuild host: check reply_fds before sending them 2021-09-24 12:14:04 +01:00
runners runners: add Fedora 36 runner 2021-08-20 23:02:36 +02:00
schemas device: add support for parent devices 2021-08-13 12:20:54 +02:00
schutzbot schutzbot: Update terraform sha 2021-09-21 16:00:08 +02:00
selinux docs: document osbuild and selinux integration 2021-10-01 11:02:32 +02:00
sources sources: port to host services 2021-09-22 00:00:20 +02:00
stages stages/qemu: fix 'compat' option 2021-09-23 11:00:47 +02:00
test test/host: checks for invalid fd handling 2021-09-24 12:14:04 +01:00
tools Copy the local_vars dictionary to avoid eval modifying it 2021-09-24 13:32:51 +02:00
.editorconfig editorconfig: include markdown specifications 2020-10-23 16:29:50 +02:00
.gitignore gitignore: ignore macos metadata file 2021-08-13 12:20:54 +02:00
.gitlab-ci.yml mockbuild: add rhel 9 2021-07-22 17:58:41 +02:00
.packit.yaml packit: Propose PRs to all Fedoras 2021-09-20 10:51:46 +02:00
.travis.yml ci: move test_boot to github-actions 2020-05-13 22:00:27 +02:00
LICENSE Revert "Fill in the license template" 2019-11-18 12:23:10 +01:00
Makefile test/data: add version agnostic build manifest 2021-08-17 10:42:03 +02:00
NEWS.md 38 2021-09-24 17:20:15 +02:00
osbuild.spec 38 2021-09-24 17:20:15 +02:00
README.md README: improve Build section 2021-07-14 14:37:03 +02:00
requirements.txt Makefile: use pytest for nicer output 2020-12-04 18:24:48 +01:00
samples samples: replace with symlink to test data 2021-07-12 18:44:50 +02:00
setup.cfg setup.cfg: set max line length in pycodestyle 2021-05-12 14:26:16 +02:00
setup.py 38 2021-09-24 17:20:15 +02:00

OSBuild

Build-Pipelines for Operating System Artifacts

OSBuild is a pipeline-based build system for operating system artifacts. It defines a universal pipeline description and a build system to execute them, producing artifacts like operating system images, working towards an image build pipeline that is more comprehensible, reproducible, and extendable.

See the osbuild(1) man-page for details on how to run osbuild, the definition of the pipeline description, and more.

Project

Requirements

The requirements for this project are:

  • bubblewrap >= 0.4.0
  • python >= 3.7

Additionally, the built-in stages require:

  • bash >= 5.0
  • coreutils >= 8.31
  • curl >= 7.68
  • qemu-img >= 4.2.0
  • rpm >= 4.15
  • tar >= 1.32
  • util-linux >= 235

At build-time, the following software is required:

  • python-docutils >= 0.13
  • pkg-config >= 0.29

Testing requires additional software:

  • pytest

Install

Installing osbuild requires to not only install the osbuild module, but also additional artifacts such as tools (i.e: osbuild-mpp) sources, stages, schemas and SELinux policies.

For this reason, doing an installation from source is not trivial and the easier way to install it is to create the set of RPMs that contain all these components.

This can be done with the rpm make target, i.e:

make rpm

A set of RPMs will be created in the ./rpmbuild/RPMS/noarch/ directory and can be installed in the system using the distribution package manager, i.e:

sudo dnf install ./rpmbuild/RPMS/noarch/*.rpm

Repository:

License:

  • Apache-2.0
  • See LICENSE file for details.