abed334dbe
Previously, Fedora was set as the default image prefix. Since our reference architecture focuses on CentOS, the default image prefix has been changed accordingly. Change-Id: I794ac1aa035d793204fa315752ae8188ce872a3e
78 lines
2.3 KiB
Markdown
78 lines
2.3 KiB
Markdown
# 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/centos-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/centos-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/centos-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=fedora-rdo-
|
|
|
|
This setting would cause images to be tagged into the `larsks/`
|
|
namespace and use Fedora as base image instead of the default CentOS.
|
|
|