No description
Find a file
Ondřej Budai 3acc0d1d2e ci: fix the gitlab trigger
There were two issues:

- ${{ }} converts the expression to a string and strings are apparently always truthy
  https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idif
- There was a typo in pr_data

Therefore, the check didn't work properly.

Signed-off-by: Ondřej Budai <ondrej@budai.cz>
2023-07-21 12:12:44 +02:00
.devcontainer Devcontainer update to Fedora 36. 2022-05-04 10:44:21 +02:00
.github ci: fix the gitlab trigger 2023-07-21 12:12:44 +02:00
cmd Remove test that depends on removed code from images 2023-07-21 12:05:00 +02:00
containers containers/osbuild-composer: add prometheus port parameter 2023-06-29 14:34:15 +02:00
distribution containers/osbuild-composer: add prometheus port parameter 2023-06-29 14:34:15 +02:00
docs Doc: remove unused doc/news directory 2021-11-24 14:55:47 +01:00
image-types image-types: Add research document for GCE image type 2022-04-14 19:07:31 +01:00
internal cloudapi: add live-installer 2023-07-20 18:53:28 +02:00
pkg/jobqueue dbjobqueue: put all SQL queries in dequeueMaybe into a transaction 2023-04-14 16:37:04 +02:00
repositories repositories/fedora-39: make a forgotten s/f38/f39 2023-06-06 13:04:10 +02:00
schutzbot Fix for possibly undefined variable in CI script 2023-07-10 15:27:24 +02:00
templates templates/dashboards: rework composer dashboard 2023-06-30 11:06:51 +02:00
test Start collecting logs from virt-install 2023-07-21 12:11:02 +02:00
tools Start collecting logs from virt-install 2023-07-21 12:11:02 +02:00
vendor deps: update osbuild/images to 246b718310ea 2023-07-21 12:05:00 +02:00
.env docker-compose: integrate dev container 2022-02-27 20:55:03 +00:00
.gitignore Add IntelliJ IDEA/GoLand to .gitignore 2022-09-09 16:27:38 +02:00
.gitlab-ci.yml Remove test that depends on removed code from images 2023-07-21 12:05:00 +02:00
.gitleaks.toml gitleaks: add allow list for test passwords and keys 2021-10-01 16:56:26 +02:00
.golangci.yml lint: Enable check for replace in go.mod 2023-07-20 15:07:20 +02:00
.packit.yaml packit: remove epel builds 2023-06-27 15:07:04 +03:00
.pylintrc github/workflows: check dnf-json with pylint 2022-03-08 12:42:12 +01:00
codecov.yml codevoc: fix threshold 2020-05-17 10:12:06 +02:00
CONTRIBUTING.md Improve contributing.md 2021-11-23 08:25:07 +01:00
DEPLOYING.md Add DEPLOYING.md 2020-10-20 15:43:30 +02:00
dnf-json dnf-json: disable pylint warnings 2023-02-01 10:27:58 +01:00
docker-compose.yml docker-compose: remove unavailable --dnf-json 2022-11-09 11:28:56 +01:00
go.mod deps: update osbuild/images to 246b718310ea 2023-07-21 12:05:00 +02:00
go.sum deps: update osbuild/images to 246b718310ea 2023-07-21 12:05:00 +02:00
HACKING.md docker-compose: integrate dev container 2022-02-27 20:55:03 +00:00
krb5.conf upload/koji: add support for GSSAPI/Kerberos auth 2020-08-27 17:29:57 +01:00
LICENSE Revert "Fill in the license template" 2019-11-15 15:26:51 +01:00
Makefile Remove test that depends on removed code from images 2023-07-21 12:05:00 +02:00
osbuild-composer.spec Remove test that depends on removed code from images 2023-07-21 12:05:00 +02:00
README.md go.mod: update to Go 1.18 2023-01-09 14:03:18 +01:00
Schutzfile schutzfile: Update snapshots to 20230701 2023-07-03 17:18:34 +02:00

OSBuild Composer

Operating System Image Composition Services

The composer project is a set of HTTP services for composing operating system images. It builds on the pipeline execution engine of osbuild and defines its own class of images that it supports building.

Multiple APIs are available to access a composer service. This includes support for the lorax-composer API, and as such can serve as drop-in replacement for lorax-composer.

You can control a composer instance either directly via the provided APIs, or through higher-level user-interfaces from external projects. This, for instance, includes a Cockpit Module or using the composer-cli command-line tool.

Project

Contributing

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

About

Composer is a middleman between the workhorses from osbuild and the user-interfaces like cockpit-composer, composer-cli, or others. It defines a set of high-level image compositions that it supports building. Builds of these compositions can be requested via the different APIs of Composer, which will then translate the requests into pipeline-descriptions for osbuild. The pipeline output is then either provided back to the user, or uploaded to a user specified target.

The following image visualizes the overall architecture of the OSBuild infrastructure and the place that Composer takes:

overview

Consult the osbuild-composer(7) man-page for an introduction into composer, information on running your own composer instance, as well as details on the provided infrastructure and services.

Requirements

The requirements for this project are:

  • osbuild >= 26
  • systemd >= 244

At build-time, the following software is required:

  • go >= 1.18
  • python-docutils >= 0.13
  • krb5-devel for fedora/rhel or libkrb5-dev for debian/ubuntu`

Build

The standard go package system is used. Consult upstream documentation for detailed help. In most situations the following commands are sufficient to build and install from source:

make build

The man-pages require python-docutils and can be built via:

make man

Repository:

Pull request gating

Each pull request against osbuild-composer starts a series of automated tests. Tests run via GitHub Actions and Jenkins. Each push to the pull request will launch theses tests automatically.

Jenkins only tests pull requests from members of the osbuild organization in GitHub. A member of the osbuild organization must say ok to test in a pull request comment to approve testing. Anyone can ask for testing to run by saying the bot's favorite word, schutzbot, in a pull request comment. Testing will begin shortly after the comment is posted.

Test results in Jenkins are available by clicking the Details link on the right side of the Schutzbot check in the pull request page.

License:

  • Apache-2.0
  • See LICENSE file for details.