2017-12-20 22:54:13 +00:00
|
|
|
% podman(1) podman-build - Simple tool to build a container image
|
|
|
|
% Tom Sweeney
|
|
|
|
# podman-build "7" "December 2017" "podman"
|
|
|
|
|
|
|
|
## NAME
|
|
|
|
podman-build - Build a container image using a Dockerfile.
|
|
|
|
|
|
|
|
## SYNOPSIS
|
|
|
|
**podman** **build** [*options* [...]] [**context**]
|
|
|
|
|
|
|
|
## DESCRIPTION
|
|
|
|
**podman build** Builds an image using instructions from one or more Dockerfiles and a specified
|
|
|
|
build context directory. The build context directory can be specified as the
|
|
|
|
**http** or **https** URL of an archive which will be retrieved and extracted
|
|
|
|
to a temporary location. This command passes the parameters entered in by the user to the
|
|
|
|
**buildah bud** command https://github.com/projectatomic/buildah/blob/master/docs/buildah-bud.md
|
|
|
|
to do the actual building.
|
|
|
|
|
|
|
|
**podman [GLOBAL OPTIONS]**
|
|
|
|
|
|
|
|
**podman build [GLOBAL OPTIONS]**
|
|
|
|
|
|
|
|
**podman build [OPTIONS] NAME[:TAG|@DIGEST]**
|
|
|
|
|
|
|
|
## OPTIONS
|
|
|
|
|
|
|
|
**--build-arg** *arg=value*
|
|
|
|
|
|
|
|
Specifies a build argument and its value, which will be interpolated in
|
|
|
|
instructions read from the Dockerfiles in the same way that environment
|
|
|
|
variables are, but which will not be added to environment variable list in the
|
|
|
|
resulting image's configuration.
|
|
|
|
|
|
|
|
**-f, --file** *Dockerfile*
|
|
|
|
|
|
|
|
Specifies a Dockerfile which contains instructions for building the image,
|
|
|
|
either a local file or an **http** or **https** URL. If more than one
|
|
|
|
Dockerfile is specified, *FROM* instructions will only be accepted from the
|
|
|
|
first specified file.
|
|
|
|
|
|
|
|
If a build context is not specified, and at least one Dockerfile is a
|
|
|
|
local file, the directory in which it resides will be used as the build
|
|
|
|
context.
|
|
|
|
|
|
|
|
**--format**
|
|
|
|
|
|
|
|
Control the format for the built image's manifest and configuration data.
|
|
|
|
Recognized formats include *oci* (OCI image-spec v1.0, the default) and
|
|
|
|
*docker* (version 2, using schema format 2 for the manifest).
|
|
|
|
|
|
|
|
**--pull-always**
|
|
|
|
|
|
|
|
Pull the image even if a version of the image is already present.
|
|
|
|
|
2018-01-19 21:32:34 +00:00
|
|
|
**-q, --quiet**
|
2017-12-20 22:54:13 +00:00
|
|
|
|
|
|
|
Suppress output messages which indicate which instruction is being processed,
|
|
|
|
and of progress when pulling images from a registry, and when writing the
|
|
|
|
output image.
|
|
|
|
|
|
|
|
**--runtime** *path*
|
|
|
|
|
|
|
|
The *path* to an alternate OCI-compatible runtime, which will be used to run
|
|
|
|
commands specified by the **RUN** instruction.
|
|
|
|
|
|
|
|
**--runtime-flag** *flag*
|
|
|
|
|
2018-01-29 12:30:53 +00:00
|
|
|
Adds global flags for the container runtime.
|
2017-12-20 22:54:13 +00:00
|
|
|
|
2018-01-29 12:30:53 +00:00
|
|
|
**--signature-policy** *signature-policy-file*
|
2017-12-20 22:54:13 +00:00
|
|
|
|
2018-01-29 12:30:53 +00:00
|
|
|
Path name of a signature policy file to use. It is not recommended that this
|
2017-12-20 22:54:13 +00:00
|
|
|
option be used, as the default behavior of using the system-wide default policy
|
|
|
|
(frequently */etc/containers/policy.json*) is most often preferred.
|
|
|
|
|
|
|
|
**-t, --tag** *imageName*
|
|
|
|
|
|
|
|
Specifies the name which will be assigned to the resulting image if the build
|
|
|
|
process completes successfully.
|
|
|
|
|
|
|
|
**--tls-verify** *bool-value*
|
|
|
|
|
|
|
|
Require HTTPS and verify certificates when talking to container registries (defaults to true)
|
|
|
|
|
|
|
|
## EXAMPLES
|
|
|
|
|
|
|
|
podman build .
|
|
|
|
|
|
|
|
podman build -f Dockerfile.simple .
|
|
|
|
|
|
|
|
podman build -f Dockerfile.simple -f Dockerfile.notsosimple
|
|
|
|
|
|
|
|
podman build -t imageName .
|
|
|
|
|
|
|
|
podman build --tls-verify=true -t imageName -f Dockerfile.simple
|
|
|
|
|
|
|
|
podman build --tls-verify=false -t imageName .
|
|
|
|
|
|
|
|
## SEE ALSO
|
|
|
|
podman(1), buildah(1)
|
|
|
|
|
|
|
|
## HISTORY
|
|
|
|
December 2017, Originally compiled by Tom Sweeney <tsweeney@redhat.com>
|