Files
skopeo/docs/buildah-from.md
Nalin Dahyabhai 12e582ee1a Report pull/commit progress by default
Have 'from', 'commit', and 'build-using-dockerfile' report progress via
stderr (so that capturing output from 'from' and 'commit' still works as
expected) unless --quiet is used to suppress the reporting.

Closes #94.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>

Closes: #98
Approved by: rhatdan
2017-05-10 12:53:25 +00:00

1.6 KiB

buildah-from "1" "March 2017" "buildah"

NAME

buildah from - Creates a new working container, either from scratch or using a specified image as a starting point.

SYNOPSIS

buildah from [options [...]] imageName

DESCRIPTION

Creates a working container based upon the specified image name. If the supplied image name is "scratch" a new empty container is created.

RETURN VALUE

The container ID of the container that was created. On error, -1 is returned and errno is returned.

OPTIONS

--name name

A name for the working container

--pull

Pull the image if it is not present. If this flag is disabled (with --pull=false) and the image is not present, the image will not be pulled. Defaults to true.

--pull-always

Pull the image even if a version of the image is already present.

--registry registry

A prefix to prepend to the image name in order to pull the image. Default value is "docker://"

--signature-policy signaturepolicy

Pathname of a signature policy file to use. It is not recommended that this option be used, as the default behavior of using the system-wide default policy (frequently /etc/containers/policy.json) is most often preferred.

--quiet

If an image needs to be pulled from the registry, suppress progress output.

EXAMPLE

buildah from imagename --pull --registry "myregistry://"

buildah from myregistry://imagename --pull

buildah from imagename --signature-policy /etc/containers/policy.json

buildah from imagename --pull-always --registry "myregistry://" --name "mycontainer"

SEE ALSO

buildah(1)