mirror of https://github.com/kreuzwerker/terraform-provider-docker.git synced 2025-12-22 07:39:35 -05:00

* fix(service): remove image name suppress function
* feat: add docker image data-source
* docs(service): add example for iamge datasource usage
* fix: image repo digest with tag determination
* fix: always return a repoDigest
* fix(image): deprecation notice for latest attribute
* fix(ci): explicitly go get tfplugindocs
* fix(ci): remove gocenter.io proxy

2021-06-21 09:24:02 +02:00

1.4 KiB

Raw Blame History

page_title	subcategory	description
docker_image Data Source - terraform-provider-docker		docker_image provides details about a specific Docker Image which need to be presend on the Docker Host

docker_image (Data Source)

docker_image provides details about a specific Docker Image which need to be presend on the Docker Host

Example Usage

# uses the 'latest' tag
data "docker_image" "latest" {
  name = "nginx"
}

# uses a specific tag
data "docker_image" "specific" {
  name = "nginx:1.17.6"
}

# use the image digest
data "docker_image" "digest" {
  name = "nginx@sha256:36b74457bccb56fbf8b05f79c85569501b721d4db813b684391d63e02287c0b2"
}

# uses the tag and the image digest
data "docker_image" "tag_and_digest" {
  name = "nginx:1.19.1@sha256:36b74457bccb56fbf8b05f79c85569501b721d4db813b684391d63e02287c0b2"
}

Schema

Required

name (String) The name of the Docker image, including any tags or SHA256 repo digests.

Optional

id (String) The ID of this resource.

Read-Only

repo_digest (String) The image sha256 digest in the form of repo[:tag]@sha256:<hash>. It may be empty in the edge case where the local image was pulled from a repo, tagged locally, and then referred to in the data source by that local name/tag.

1.4 KiB Raw Blame History