Building containers in Fedora

Building a container image

There are two ways to build a Docker container image in Fedora infrastructure:

  1. In production environment – the process starts by initiating a review request, as specified in Container:Review_Process.
  2. In staging environment – this is where we can bypass the review process and iterate more quickly; In order to use staging environment, we should request creation of dist-git repo and pkgdb entry via Fedora Infra tracker.

Builds in production

If you want to clone your dist-git repository using fedpkg, you need to select correct namespace:

$ fedpkg clone docker/$COMPONENT


$ fedpkg clone modules/memcached

Builds in staging

Install fedpkg-stage which will add fedpkg-stage executable to your system:

$ dnf install -y fedpkg-stage

If fedpkg-stage is not able to talk to Fedora infrastructure, it’s possible that you’ve hit this issue.

Make sure that you have kerberos ticket in stage (you may need to create a Fedora infra ticket to get your production credentials copied to stage):


Once you are ready to submit a build, you need to push changes to a remote and initiate a build:

$ git push
$ fedpkg-stage container-build

This is how staging dist-git remote looks like:

git clone git+ssh://git@pkgs.stg.fedoraproject.org/$NAMESPACE/$COMPONENT

Inspecting registry

At the time of writing this (Feb 2017), Fedora docker image registry doesn’t have any frontend. You can access API of registry to get a list of available images:

$ curl -s https://registry.fedoraproject.org/v2/_catalog | python -m json.tool
    "repositories": [

Thank you to Adam Miller for providing info about using Docker Layered Image Build System.