aboutsummaryrefslogtreecommitdiff
path: root/docs/image-building.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/image-building.md')
-rw-r--r--docs/image-building.md77
1 files changed, 0 insertions, 77 deletions
diff --git a/docs/image-building.md b/docs/image-building.md
deleted file mode 100644
index a67f3da08..000000000
--- a/docs/image-building.md
+++ /dev/null
@@ -1,77 +0,0 @@
-# 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.
-