No description
Find a file
Javier Martinez Canillas 2bc0088767 README: improve Build section
The current Build section is misleading, since running the commands that
are mentioned there will lead to only the osbuild module and osbuild-mpp
tool to be installed.

But none of the other required artifacts (sources, stages, schemas, etc)
will, causing the installed osbuild to not work at all. Instead, have an
Install section that explains how osbuild can be installed from RPMs.
2021-07-14 14:37:03 +02:00
.devcontainer devcontainer: add pyyaml dependency 2021-07-01 23:29:03 +02:00
.github samples: replace with symlink to test data 2021-07-12 18:44:50 +02:00
assemblers assemblers/ostree: fix copying of var 2021-06-22 10:07:07 +02:00
devices devices/loopback: since file on close 2021-07-07 17:24:58 +01:00
docs docs: add --export option to the osbuild man page 2021-07-14 14:35:30 +02:00
inputs inputs/files: support for pipeline origins 2021-06-09 18:37:47 +01:00
mounts mounts/btrfs: mount support for btrfs 2021-06-09 18:37:47 +01:00
osbuild utils/ostree: deployment path helper 2021-07-12 18:21:05 +02:00
runners aarch64: use single qemu-img thread 2021-06-09 11:57:26 +02:00
schemas osbuild: introduce mount host service 2021-06-09 18:37:47 +01:00
schutzbot ci: upload rpms built in RHEL 8 CDN buildroot into rhel-8-cdn directory 2021-07-12 19:02:21 +02:00
selinux selinux: allow nnp and nosuid transitions 2020-08-10 14:05:24 +02:00
sources sources/inline: fix schema 2021-06-30 12:06:30 +02:00
stages stages/fstab: add support for OSTree 2021-07-12 18:21:05 +02:00
test test/data: remove users from ostree-image 2021-07-12 18:21:05 +02:00
tools tools/mpp: support multiple image definitions 2021-07-09 19:50:38 +01:00
.editorconfig editorconfig: include markdown specifications 2020-10-23 16:29:50 +02:00
.gitignore test: add coverity targets to the Makefile 2020-06-24 10:01:24 +02:00
.gitlab-ci.yml ci: Start building on 8.5 aarch64 2021-07-05 16:43:35 +02:00
.packit.yaml packit: use custom command to get the current version 2021-06-22 18:28:04 +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 tools/mpp: rename mpp.py to osbuild-mpp 2021-07-02 11:28:43 +02:00
NEWS.md NEWS: update for osbuild release 29 2021-06-16 21:43:58 +02:00
osbuild.spec spec: ship osbuild-mpp in new -tools 2021-07-02 11:28:43 +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 setup: install osbuild-mpp 2021-07-02 11:28:43 +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.