github.com/turtlemonvh/terraform@v0.6.9-0.20151204001754-8e40b6b855e8/website/source/docs/providers/docker/r/image.html.markdown (about)

     1  ---
     2  layout: "docker"
     3  page_title: "Docker: docker_image"
     4  sidebar_current: "docs-docker-resource-image"
     5  description: |-
     6    Downloads and exports the ID of a Docker image.
     7  ---
     8  
     9  # docker\_image
    10  
    11  Downloads and exports the ID of a Docker image. This can be used alongside
    12  [docker\_container](/docs/providers/docker/r/container.html)
    13  to programmatically get the latest image IDs without having to hardcode
    14  them.
    15  
    16  ## Example Usage
    17  
    18  ```
    19  # Find the latest Ubuntu precise image.
    20  resource "docker_image" "ubuntu" {
    21      name = "ubuntu:precise"
    22  }
    23  
    24  # Access it somewhere else with ${docker_image.ubuntu.latest}
    25  ```
    26  
    27  ## Argument Reference
    28  
    29  The following arguments are supported:
    30  
    31  * `name` - (Required) The name of the Docker image, including any tags.
    32  * `keep_updated` - (Optional) If true, then the Docker image will always
    33    be updated on the host to the latest. If this is false, as long as an
    34    image is downloaded with the correct tag, it won't be redownloaded if
    35    there is a newer image.
    36  
    37  ## Attributes Reference
    38  
    39  The following attributes are exported in addition to the above configuration:
    40  
    41  * `latest` (string) - The ID of the image.