BCI build recipe generator

This repository contains the scripts to generate the build recipes (Dockerfiles or kiwi build descriptions) to build the BCI development project in the Open Build Service.

Find the latest fully rendered documentation here.

Prerequisites

You will need the following tools:

• Python 3.10 or later
• poetry
• osc installed and configured to reach OBS by default.
• python-dnf installed via your system's package manager (if you want to touch the .Net images)

To get started, clone this repository and run poetry install in its root directory.

Overview

This repository contains two major components:

1. templating logic to autogenerate the Dockerfile and kiwi build descriptions for SLE BCI (see :pybci_build) including an updater for our .Net images (see :pydotnet).
2. Github automation to render the templates into separate branches and synchronize them to the Open Build Service (see :pystaging).

Contributing

To contribute a new container or modify an existing one, please check the chapter adding-and-modifying-container-images.

Before submitting your changes, please format your source code with ruff:

poetry run ruff format
# reorder imports:
poetry run ruff check --fix

Additionally, run the unit tests and check whether the documentation builds (additional points if you update it):

# tests
poetry run pytest -vv
# docs
poetry run sphinx-build -M html source build -W

Entrypoints

The projects currently provides two entry points. The first is the package build description "dumper" called package. It writes the build description of a single container image into a specified directory:

poetry run package postgres-12-sp4 ~/tmp/postgres/

The first argument is the name of the container image, this is the concatenation of the image name (:py~bci_build.package.BaseContainerImage.name) and the operating system version (:py~bci_build.package.BaseContainerImage.os_version).

The second entry point is the github automation bot, which is not intended for end user usage. You can find some details in the chapter staging-bot.