moby--moby/man
Ian Campbell 5894bc1abf Add `docker build --iidfile=FILE`
This is synonymous with `docker run --cidfile=FILE` and writes the digest of
the newly built image to the named file. This is intended to be used by build
systems which want to avoid tagging (perhaps because they are in CI or
otherwise want to avoid fixed names which can clash) by enabling e.g. Makefile
constructs like:

    image.id: Dockerfile
    	docker build --iidfile=image.id .

    do-some-more-stuff: image.id
    	do-stuff-with <image.id

Currently the only way to achieve this is to use `docker build -q` and capture
the stdout, but at the expense of losing the build output.

In non-silent mode (without `-q`) with API >= v1.29 the caller will now see a
`JSONMessage` with the `Aux` field containing a `types.BuildResult` in the
output stream for each image/layer produced during the build, with the final
one being the end product.  Having all of the intermediate images might be
interesting in some cases.

In silent mode (with `-q`) there is no change, on success the only output will
be the resulting image digest as it was previosuly.

There was no wrapper to just output an Aux section without enclosing it in a
Progress, so add one here.

Added some tests to integration cli tests.

Signed-off-by: Ian Campbell <ian.campbell@docker.com>
2017-05-05 16:35:54 +01:00
..
src Minor fixups for history CLI reference 2017-04-16 12:51:29 -05:00
Dockerfile
Dockerfile.5.md
Dockerfile.aarch64
Dockerfile.armhf
Dockerfile.ppc64le
Dockerfile.s390x
README.md
docker-build.1.md Add `docker build --iidfile=FILE` 2017-05-05 16:35:54 +01:00
docker-config-json.5.md
docker-run.1.md remove --init-path from client 2017-04-10 16:49:43 +02:00
docker.1.md
dockerd.8.md Merge pull request #31104 from cpuguy83/dm_lvmsetup 2017-05-05 07:35:24 -04:00
generate.go
generate.sh
glide.lock
glide.yaml
md2man-all.sh

README.md

Docker Documentation

This directory contains scripts for generating the man pages. Many of the man pages are generated directly from the spf13/cobra Command definition. Some legacy pages are still generated from the markdown files in this directory. Do not edit the man pages in the man1 directory. Instead, update the Cobra command or amend the Markdown files for legacy pages.

Generate the man pages

From within the project root directory run:

make manpages