-> Note: The initial (current) version of this data source can reliably read only public images from the official Docker Hub Registry.

Reads the image metadata from a Docker Registry. Used in conjunction with the docker_image resource to keep an image up to date on the latest available version of the tag.

Example Usage

data "docker_registry_image" "ubuntu" {
    name = "ubuntu:precise"

resource "docker_image" "ubuntu" {
    name = "${}"
    pull_trigger = "${data.docker_registry_image.ubuntu.sha256_digest}"

Argument Reference

The following arguments are supported:

  • name - (Required, string) The name of the Docker image, including any tags. e.g. alpine:latest

Attributes Reference

The following attributes are exported in addition to the above configuration:

  • sha256_digest (string) - The content digest of the image, as stored on the registry.