Docker Image Resource

Tracks and builds Docker images.

Source Configuration

repository: Required. The name of the repository, e.g. concourse/docker-image-resource.
tag: Optional. The tag to track. Defaults to latest.
username: Optional. The username to authenticate with when pushing.
password: Optional. The password to use when authenticating.
email: Optional. The email to use when authenticating.
server_args: Optional. Additional arguments to be passed during Docker daemon start.

Behavior

`check`: Check for new images.

The current image ID is fetched from the registry for the given tag of the repository. If it's different from the current version, it is returned.

`in`: Fetch the image from the registry.

Pulls down the repository from the registry. Note that there's no way to fetch an image by ID from the Docker registry, which makes the version requested irrelevant. Instead, in returns the ID of the image that it ended up fetching as the version.

The following files will be placed in the destination:

/image: The docker saved image.
/repository: The name of the repository that was fetched.
/tag: The tag of the repository that was fetched.
/image-id: The fetched image ID.
/rootfs.tar: If rootfs is true, the contents of the image will be provided here.

Parameters

rootfs: Optional. Place a .tar file of the image in the destination.
skip_download: Optional. Skip docker pull of image. Only /image-id, /repo sitory, and /tag will be populated. /image and /rootfs.tar will not be present.

`out`: Push an image, or build and push a `Dockerfile`.

Push a Docker image to the source's repository and tag. The resulting version is the image's ID.

Parameters

push: Optional. Default true. Push the image to the Docker index.
rootfs: Optional. Default false. Place a .tar file of the image in the destination.
build: Optional. The path of a directory containing a Dockerfile to build.
cache: Optional. Default false. When the build parameter is set, first pull image:tag from the Docker registry (so as to use cached intermediate images when building).
load_file: Optional. A path to a file to docker load and then push.
import_file: Optional. A path to a file to docker import and then push.
pull_repository: Optional. A path to a repository to pull down, and then push to this resource.
tag: Optional. The value should be a path to a file containing the name of the tag.
tag_prefix: Optional. If specified, the tag read from the file will be prepended with this string. This is useful for adding v in front of version numbers.

robday-reynolds / docker-image-resource Goto Github PK