No description
Find a file
Christian Kellner 99abc1373d inputs: support array of objects references
This extends the possible ways of passing references to inputs. The
current ways possible are:
 1) "plain references", an array of strings:
    ["ref1", "ref2", ...]
 2) "object references", a mapping of keys to objects:
    {"ref1": { <options> }, "ref2": { <options> }, ...}

This patch adds a new way:
  3) "array of object references":
    [{"id": "ref1", "options": { ... }}, {"id": ... }, ]

While osbuild promises to preserves the order for "object references"
not all JSON serialization libraries preserve the order since the
JSON specification does leave this up to the implementation.

The new "array of object references" thus allows for specifying the
references together with reference specific options and this in a
specific order.

Additionally this paves the way for specifying the same input twice,
e.g. in the case of the `org.osbuild.files` input where a pipeline
could then be specified twice with different files. This needs core
rework though, since internally we use dictionaries right now.
2022-04-21 16:39:58 +02:00
.devcontainer devcontainer: include packit, boto3 & more tools 2021-08-17 10:42:03 +02:00
.github workflows/trigger-gitlab: run Gitlab CI in new image-builder project 2022-04-14 14:42:50 +02:00
assemblers Support VMDK subformat in qemu assembler 2022-04-07 15:51:44 +02:00
data devices: add custom udev rule inhibitor mechanism 2021-12-09 00:44:21 +00:00
devices devices/lvm2.lv: separate stdout and stderr 2022-03-04 08:42:35 +01:00
docs docs: add --export option to the osbuild man page 2021-07-14 14:35:30 +02:00
inputs inputs: support array of objects references 2022-04-21 16:39:58 +02:00
mounts mounts/ostree.deployment: initialize fields 2021-12-03 17:09:33 +00:00
osbuild inputs: support array of objects references 2022-04-21 16:39:58 +02:00
runners runners: add org.osbuild.fedora37 2022-03-03 10:40:47 +01:00
schemas inputs: support array of objects references 2022-04-21 16:39:58 +02:00
schutzbot ci: run ci-details.sh 2022-04-13 14:57:27 +02:00
selinux docs: document osbuild and selinux integration 2021-10-01 11:02:32 +02:00
sources sources/curl: don't limit total download time 2022-03-16 14:48:03 +01:00
stages Support specifying multiple devices in all mkfs versions (like xfs) 2022-04-19 18:00:15 +02:00
test inputs: support array of objects references 2022-04-21 16:39:58 +02:00
tools tools: add set-env-variables.sh 2022-04-13 14:57:27 +02:00
.editorconfig editorconfig: include markdown specifications 2020-10-23 16:29:50 +02:00
.gitignore gitignore: Ignore generated man pages 2021-11-26 19:39:42 +00:00
.gitlab-ci.yml ci: run ci-details.sh 2022-04-13 14:57:27 +02:00
.packit.yaml Packit: build SRPMs in Copr 2022-03-09 13:38:29 +00: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 make: require clean git for make make 2021-12-08 14:22:12 +01:00
osbuild.spec Post release version bump 2022-04-13 13:23:19 +00:00
README.md Add support for installing containers in images 2022-02-10 14:43:17 +01: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
Schutzfile Schutzfile: add Schutzfile 2022-04-13 14:57:27 +02:00
setup.cfg setup: disable new pylint warnings 2021-11-19 00:19:05 +00:00
setup.py Post release version bump 2022-04-13 13:23:19 +00: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

Contributing

Please refer to the developer guide to learn about our workflow, code style and more.

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
  • skopeo

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.