say-paul / images

Image builder image definition library

Images

Project

• Website: https://www.osbuild.org
• Bug Tracker: https://github.com/osbuild/images/issues
• Matrix (chat): Image Builder channel on Fedora Chat
• Changelog: https://github.com/osbuild/images/releases

Principles

1. The image definitions API is internal and can therefore be broken. The blueprint API is the stable API.
2. Nonsensical manifests should not compile (at the Golang level).
3. OSBuild units (stages, sources, inputs, mounts, devices) should be directly mapped into Go objects.
4. Image definitions don’t test distributions that are end-of-life. Respective code-paths should be dropped.
5. Image definitions need to support the oldest supported target distribution.

Contributing

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

The build-requirements for Fedora and rpm-based distributions are:

• gpgme-devel, btrfs-progs-devel, device-mapper-devel

Repository:

• web: https://github.com/osbuild/images
• https: https://github.com/osbuild/images.git
• ssh: [email protected]:osbuild/images.git

Pull request gating

Each pull request against images starts a series of automated tests. Tests run via GitHub Actions and GitLab CI. Each push to the pull request will launch theses tests automatically.

License:

• Apache-2.0
• See LICENSE file for details.