Martin André 0764fd7dea Allow changing base image

By changing the PREFIX variable in the .buildconf one is now able to
build docker images from different bases.

For example, add the following line to your .buildconf file to build
CentOS based images:

    PREFIX=centos-rdo-

Default base image is Fedora. For now only RH family is supported.

Additionally, changing the namespace either with the NAMESPACE variable
in .buildconf or via --namespace commandline option now changes the
source namespace as well from the default kollaglue one.

Implements: blueprint multi-baseos
Co-Authored-By: Steven Dake <stdake@cisco.com>
Change-Id: I3964cd2292789ea883a1f2d2738a5731a4fff49b

2015-03-02 14:08:06 +09:00

2.3 KiB

Raw Blame History

Image building

The tools/build-docker-image script in this repository is responsible for building docker images. It is symlinked as ./build inside each Docker image directory.

When creating new image directories, you can run the tools/update-build-links scripts to install the build symlink (this script will install the symlink anywhere it find a file named Dockerfile).

Workflow

In general, you will build images like this:

$ cd docker/keystone
$ ./build

By default, the above command would build kollaglue/fedora-rdo-keystone:CID, where CID is the current short commit ID. That is, given:

$ git rev-parse HEAD
76a16029006a2f5d3b79f1198d81acb6653110e9

The above command would generate kollaglue/fedora-rdo-keystone:76a1602. This tagging is meant to prevent developers from stepping on each other or on release images during the development process.

To push the image after building, add --push:

$ ./build --push

To use these images, you must specify the tag in your docker run commands:

$ docker run kollaglue/fedora-rdo-keystone:76a1602

Building releases

To build into the latest tag, add --release:

$ ./build --release

Or to build and push:

$ ./build --push --release

Build all images at once

The build-all-docker-images script in the tools directory is a wrapper for the build-docker-image that builds all images, as the name suggests, in the correct order. It responds to the same options as build-docker-image with the additional --from and --to options that allows building only images that have changed between the specified git revisions.

For example, to build all images contained in docker directory and push new release:

$ tools/build-all-docker-images --release --push

To build only images modified in test-branch along with their children:

$ tools/build-all-docker-images --from master --to test-branch

Configuration

The build-docker-image script will look for a file named .buildconf in the image directory and in the top level of the repository. You can use this to set defaults, such as:

NAMESPACE=larsks
PREFIX=centos-rdo-

This setting would cause images to be tagged into the larsks/ namespace and use CentOS as base image instead of the default Fedora.

2.3 KiB Raw Blame History