|
Packit Service |
863627 |
OSBuild
|
|
Packit Service |
863627 |
=======
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
Build-Pipelines for Operating System Artifacts
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
OSBuild is a pipeline-based build system for operating system artifacts. It
|
|
Packit Service |
863627 |
defines a universal pipeline description and a build system to execute them,
|
|
Packit Service |
863627 |
producing artifacts like operating system images, working towards an image
|
|
Packit Service |
863627 |
build pipeline that is more comprehensible, reproducible, and extendable.
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
See the `osbuild(1)` man-page for details on how to run osbuild, the definition
|
|
Packit Service |
863627 |
of the pipeline description, and more.
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
### Project
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
* **Website**: <https://www.osbuild.org>
|
|
Packit Service |
863627 |
* **Bug Tracker**: <https://github.com/osbuild/osbuild/issues>
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
### Requirements
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
The requirements for this project are:
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
* `python >= 3.7`
|
|
Packit Service |
863627 |
* `systemd-nspawn >= 244`
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
Additionally, the built-in stages require:
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
* `bash >= 5.0`
|
|
Packit Service |
863627 |
* `coreutils >= 8.31`
|
|
Packit Service |
863627 |
* `curl >= 7.68`
|
|
Packit Service |
863627 |
* `qemu-img >= 4.2.0`
|
|
Packit Service |
863627 |
* `rpm >= 4.15`
|
|
Packit Service |
863627 |
* `tar >= 1.32`
|
|
Packit Service |
863627 |
* `util-linux >= 235`
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
At build-time, the following software is required:
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
* `python-docutils >= 0.13`
|
|
Packit Service |
863627 |
* `pkg-config >= 0.29`
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
### Build
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
The standard python package system is used. Consult upstream documentation for
|
|
Packit Service |
863627 |
detailed help. In most situations the following commands are sufficient to
|
|
Packit Service |
863627 |
build and install from source:
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
```sh
|
|
Packit Service |
863627 |
python setup.py build
|
|
Packit Service |
863627 |
python setup.py install --skip-build --root=/
|
|
Packit Service |
863627 |
```
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
The man-pages require `python-docutils` and can be built via:
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
```sh
|
|
Packit Service |
863627 |
rst2man docs/<input-file>.rst <output-file>
|
|
Packit Service |
863627 |
```
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
### Repository:
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
- **web**: <https://github.com/osbuild/osbuild>
|
|
Packit Service |
863627 |
- **https**: `https://github.com/osbuild/osbuild.git`
|
|
Packit Service |
863627 |
- **ssh**: `git@github.com:osbuild/osbuild.git`
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
### License:
|
|
Packit Service |
863627 |
|
|
Packit Service |
863627 |
- **Apache-2.0**
|
|
Packit Service |
863627 |
- See LICENSE file for details.
|