No description
Find a file
Thomas Lavocat 1de74ce2c9 sources: generalizing download method
Before, the download method was defined in the inherited class of each
program. With the same kind of workflow redefined every time. This
contribution aims at making the workflow more clear and to generalize
what can be in the SourceService class.

The download worklow is as follow:
Setup -> Filter -> Prepare -> Download

The setup mainly step sets up caches. Where the download data will be
stored in the end.

The filter step is used to discard some of the items to download based
on some criterion. By default, it is used to verify if an item is
already in the cache using the item's checksum.

The Prepare step goes from each element and let the overloading step the
ability to alter each item before downloading it. This is used mainly
for the curl command which for rhel must generate the subscriptions.

Then the download step will call fetch_one for each item. Here the
download can be performed sequentially or in parallel depending on the
number of workers selected.
2022-05-11 04:32:42 -05: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 pipeline: drop CAP_MAC_ADMIN by default 2022-04-27 23:05:11 +01:00
data devices: add custom udev rule inhibitor mechanism 2021-12-09 00:44:21 +00:00
devices devices/lvm2.lv: add support for lvm devices files 2022-04-25 20:38:02 +02: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 sources: generalizing download method 2022-05-11 04:32:42 -05: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: generalizing download method 2022-05-11 04:32:42 -05:00
stages stages: add new org.osbuild.udev.rules stage 2022-05-06 12:46:03 +02:00
test test/monitor: properly initialize output 2022-05-06 17:33:23 +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: Enable Koji build integration 2022-05-10 16:32:11 +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 make: require clean git for make make 2021-12-08 14:22:12 +01:00
osbuild.spec Post release version bump 2022-04-27 13:30:13 +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.cfg: enable attribute-defined-outside-init 2022-05-06 17:33:23 +02:00
setup.py Post release version bump 2022-04-27 13:30:13 +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.