mirror of https://github.com/kreuzwerker/terraform-provider-docker.git synced 2026-01-30 02:09:30 -05:00

George Christou f45feac72c website/docs: Run terraform fmt on code examples (#12075 )

* docs/vsphere: Fix code block

* docs: Convert `...` to `# ...` to allow `terraform fmt`ing

* docs: Trim trailing whitespace

* docs: First-pass run of `terraform fmt` on code examples

2017-02-19 00:48:50 +02:00

1.9 KiB

Raw Blame History

layout	page_title	sidebar_current	description
docker	Docker: docker_image	docs-docker-resource-image	Pulls a Docker image to a given Docker host.

docker_image

-> Note: The initial (current) version of this resource can only pull public images from the official Docker Hub Registry.

Pulls a Docker image to a given Docker host from a Docker Registry.

This resource will not pull new layers of the image automatically unless used in conjunction with docker_registry_image data source to update the pull_triggers field.

Example Usage

# Find the latest Ubuntu precise image.
resource "docker_image" "ubuntu" {
  name = "ubuntu:precise"
}

# Access it somewhere else with ${docker_image.ubuntu.latest}

Dynamic image

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

resource "docker_image" "ubuntu" {
  name          = "${data.docker_registry_image.ubuntu.name}"
  pull_triggers = ["${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.
keep_locally - (Optional, boolean) If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker local storage on destroy operation.
pull_triggers - (Optional, list of strings) List of values which cause an image pull when changed. This is used to store the image digest from the registry when using the docker_registry_image data source to trigger an image update.
pull_trigger - Deprecated, use pull_triggers instead.

Attributes Reference

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

latest (string) - The ID of the image.

1.9 KiB Raw Blame History