particle-os/debian-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2025 commits 2 branches 0 tags 60 MiB
Find a file
David Rheinsberg 2c1f61f9f2 docs: update osbuild(1) 
Update osbuild(1) to reflect changes of the last year. In particular,
we want to document behavior of the v2-manifest and only silently
continue to support v1-manifests.

Lets also introduce new chapters on output control, caching support,
and monitoring.

Signed-off-by: David Rheinsberg <david.rheinsberg@gmail.com>
2022-07-08 16:42:51 +02:00
.devcontainer devcontainer: include packit, boto3 & more tools 2021-08-17 10:42:03 +02:00
.github ci: push tags to gitlab 2022-06-30 10:50:10 +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: update osbuild(1) 2022-07-08 16:42:51 +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 osbuild: align --help output 2022-07-08 16:42:51 +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 rpmbuild: add fedora-36 2022-06-23 10:41:16 +02:00
selinux docs: document osbuild and selinux integration 2021-10-01 11:02:32 +02:00
sources sources: support calling curl with --insecure 2022-06-14 22:13:39 +02:00
stages oscap: image build remediation 2022-07-06 09:59:00 +02:00
test test/data: update oscap.remediation tests 2022-07-06 09:59:00 +02:00
tools osbuild-mpp: small python cleanups 2022-06-27 10:22:25 +02:00
.editorconfig editorconfig: include markdown specifications 2020-10-23 16:29:50 +02:00
.gitignore git: ignore common virtual env locations 2022-06-30 10:34:27 +02:00
.gitlab-ci.yml rpmbuild: add fedora-36 2022-06-23 10:41:16 +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 main: add a --version argument 2022-07-06 09:57:24 +02:00
osbuild.spec Post release version bump 2022-07-06 08:26:42 +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 rpmbuild: add fedora-36 2022-06-23 10:41:16 +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-07-06 08:26:42 +00:00

README.md

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.