Supported builder engines

Contents

• Supported builder engines
  • Docker builder
  • OSBS builder
  • Buildah builder
  • Podman builder

CEKit supports following builder engines:

• Docker builder – builds the container image using Docker
• OSBS builder – builds the container image using OSBS service
• Buildah builder – builds the container image using Buildah
• Podman builder – builds the container image using Podman

Docker builder

This builder uses Docker daemon as the build engine. Interaction with Docker daemon is done via Python binding.

Input format

Dockerfile

Parameters

• --pull – ask a builder engine to check and fetch latest base image
• --tag – an image tag used to build image (can be specified multiple times)
• --no-squash – do not squash the image after build is done.

Example

Building Docker image

$ cekit build docker

OSBS builder

This build engine is using rhpkg or fedpkg tool to build the image using OSBS service. By default it performs scratch build. If you need a proper build you need to specify --release parameter.

Input format

Dockerfile

Parameters

• --release – perform an OSBS release build
• --tech-preview – updates image descriptor name key to contain --tech-preview suffix in family part of the image name
• --user – alternative user passed to build task
• --nowait – do not wait for the task to finish
• --stage – use stage environment
• --koji-target – overrides the default koji target
• --commit-msg – custom commit message for dist-git

Example

Performing scratch build

$ cekit build osbs

Performing release build

$ cekit build osbs --release

Buildah builder

This build engine is using Buildah.

Note

If you need to use any non default registry, please update /etc/containers/registry.conf file.

Input format

Dockerfile

Parameters

• --pull – ask a builder engine to check and fetch latest base image
• --tag – an image tag used to build image (can be specified multiple times)

Example

Build image using Buildah

$ cekit build buildah

Build image using Buildah and tag it as example/image:1.0

$ cekit build buildah --tag example/image:1.0

Podman builder

This build engine is using Podman. Podman will perform non-privileged builds so no special configuration is required.

Input format

Dockerfile

Parameters

• --pull – ask a builder engine to check and fetch latest base image
• --tag – an image tag used to build image (can be specified multiple times)

Example

Build image using Podman

$ cekit build podman

Build image using Podman

$ cekit build podman --pull