A local OSBS development environment
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
base
client
hub
koji-builder
koji-db
shared-data
skopeo-lite
.gitignore
LICENSE
README.md
base-ssl.cnf
docker-compose.yml
generate-certs
osbs-box.py

README.md

OSBS Box

A set of containers that emulate a OSBS deployment.

Getting Started

osbs-box assumes you have your system configured to run oc cluster up.

  • Follow instructions for your platform.
  • osbs-box assumes a Docker bridge network container subnet of 172.17.0.0/16 and it having set gateway(this is not true on Fedora 26 and older, out of the box docker installations)
  • You will need docker-compose in addition to docker itself.
# Start osbs-box
python ./osbs-box.py up

# Check status
python ./osbs-box.py status

# Destroy osbs-box box
python ./osbs-box down

# Rebuild existing container images with updates enabled
python ./osbs-box up --force-rebuild --updates

# Build a RHEL7-based images
python ./osbs-box up --distro rhel7 --repo-url=...

Submitting Builds

# On client container
koji container-build candidate \
    git://github.com/lcarva/docker-hello-world#origin/osbs-box-demo \
    --git-branch osbs-box-demo

# Or from the host (useful for retaining bash history between runs)
docker exec -it osbsbox_koji-client_1 koji container-build candidate \
    git://github.com/lcarva/docker-hello-world#origin/osbs-box-demo \
    --git-branch osbs-box-demo

Containers

Koji Hub

https://docs.pagure.org/koji/server_howto/#koji-hub

Additional components:

  • web interface
  • koji-containerbuild plugin

Ports 80 and 443 are mapped to workstation. Access console via https://localhost/koji

Koji Builder

https://docs.pagure.org/koji/server_howto/#koji-daemon-builder

Additional components:

  • koji-containerbuild plugin

Koji DB

https://docs.pagure.org/koji/server_howto/#postgresql-server

Openshift

A working OpenShift cluster is needed for full functionality. It's recommended to set one up via oc cluster up

See Getting Started section below for commands.

Once configured, console can be accessed via https://localhost:8443 Username: osbs Password: osbs Namespace: osbs

Shared Data

A data volume container used to store shared data between the containers:

  • Certificates used by koji
  • Koji client configuration files

Client

Combination of client tools used to interact with other services

  • osbs-client
  • koji-cli
  • koji-containerbuild-cli

Using Koji CLI

# On client container
koji hello

Koji Web Interface

Inspect koji-hub container logs to view link for accessing web interface:

docker-compose logs koji-hub

Example:

koji-hub_1      | + '[' '!' -e /docker-init ']'
koji-hub_1      | + mkdir -p /root/.koji
koji-hub_1      | + ln -fs /opt/koji-clients/kojiadmin/config /root/.koji/config
koji-hub_1      | + touch /docker-init
koji-hub_1      | ++ hostname -I
koji-hub_1      | + for ip in '`hostname -I`'
koji-hub_1      | + echo http://172.19.0.6/koji
koji-hub_1      | + echo http://172.19.0.6/kojifiles
koji-hub_1      | + exec httpd -D FOREGROUND
koji-hub_1      | [Thu Oct 06 15:18:37.651360 2016] [so:warn] [pid 1] AH01574: module ssl_module is already loaded, skipping

In this case, accessing http://172.19.0.6/koji from your browser shows koji's web interface. http://172.19.0.6/kojifiles displays a directly listing of /mnt/koji

Common Questions/Known Issues

Unable to look up hostnames

OpenShift build may fail with an error like this:

fatal: Unable to look up github.com (port 9418) (Name or service not known)

This seems to be due to docker not watching for iptables changes, to resolve:

sudo systemctl stop docker
sudo iptables -F
sudo iptables -t nat -F
sudo systemctl start docker