OpenShift Build Service

OSBS is a collection of tools, workflows and integration points that build and release layered container images.

OSBS hooks into Koji with the help of the koji-containerbuild plugin, and uses OpenShift builds as Content Generators to produce layered images.

One can start an image build with fedpkg, using the container-build subcommand:

$ fedpkg container-build

Table of Contents

• Administration and Maintenance
  • Understanding build parameters
  • Configuring osbs-client
    • can_orchestrate
    • reactor_config_map
    • client_config_secret
    • token_secrets
    • Node selector
    • Platform description
    • build_from
  • Deploy OSBS on OpenShift
    • Authentication
    • Server-side Configuration for atomic-reactor
  • Setting up koji for container image builds
    • Example configuration file: Koji builder
    • Example configuration file: inside builder image
    • Including OpenShift build annotations in Koji task output
  • Priority of Container Image Builds
    • Worker Builds Node Selectors
    • Orchestrator Builds Allocation
    • Koji Builder Capacity
  • Operator manifests
    • Supporting Operator Manifests extraction
    • Enabling Operator Manifests digest pinning (and other replacements)
    • Enabling operator CSV modifications
    • Enabling integration with OMPS service
  • Cachito integration
    • Configuring your cachito instance
    • Allowing multiple remote sources
    • Configuring koji
  • Troubleshooting
    • Obtaining Atomic Reactor stack trace
• Building Container Images
  • Building images using fedpkg
  • Building images using koji
    • Streamed build logs
    • Koji Build Results
  • Building images using osbs-client
  • Accessing built images
    • Docker
    • Podman
  • Writing a Dockerfile
  • Image configuration
    • platforms
    • go
    • compose
    • flatpak
    • tags
    • version
    • set_release_env
    • autorebuild
    • Automatic Rebuilds
    • image_build_method
    • Fetching source code from external source using cachito
    • remote_source
    • remote_sources
    • Replacing project dependencies with cachito
  • Content Sets
  • Using Artifacts from Koji or Project Newcastle(aka PNC)
    • fetch-artifacts-koji.yaml
    • fetch-artifacts-pnc.yaml
    • fetch-artifacts-url.yaml
    • Koji Build Metadata Integration
  • Image tags
  • Override Parent Image
  • Koji NVR
    • Digests verification
  • Isolated Builds
    • Operator bundle isolated builds
  • Yum repositories
    • ODCS compose
    • RHEL subscription
    • Yum repository URL
    • Koji tag
    • Inherited yum repository and ODCS compose
  • Signing intent
  • Base image builds
  • Multistage builds
  • Operator manifests
    • Operator manifest bundle builds
    • Operator manifest appregistry builds
• Inspecting built image components
  • Dockerfiles
  • Image Content Manifests
    • Content Sets
    • Extra contents
• Building Source Container Images
  • Signing intent resolution
  • Koji integration
    • Koji Build Metadata Integration
  • Building source container images using koji
  • Building source container images using osbs-client
• Understanding the Build Process
  • Arrangement Version 6 (reactor_config_map)
    • Orchestrator
    • Worker
  • Logging
    • Multiplexing
    • Encoding issues
    • Example
  • Metadata Fragment Storage
  • Autorebuilds
• Build Parameters
  • Environment vs User Parameters
  • Reactor Configuration
  • Atomic Reactor Plugins and Arrangement Version 6
  • Creating Builds
  • Rendering Plugins
  • Secrets
  • Site Customization
• Contributing to OSBS
  • Setting up a (local) development environment
    • OSBS-Box environment
  • Contribution guidelines
    • Submitting changes
    • Licensing
    • Code policies
• Documentation of the OSBS tools
  • Koji Containerbuild
  • Atomic Reactor
  • OSBS Client
  • Ansible Playbook
  • Deploying and Running OSBS

Indices and tables

• Index

• Search Page